AI-translated from English; not yet reviewed by a fluent editor.

# ショッピングエージェントをShopifyのShop MCPに接続する方法

> Shopifyの新しいShop MCPは、カタログ検索、加盟店のカート、チェックアウトをつなぐ。文書に基づくこのガイドでは、設定、購入者の承認手順、注文確認の境界を説明する。

By BIG CHANGE Editorial

Published: 2026-10-14T12:58:17.853Z
Updated: 2026-10-14T12:58:17.853Z
Canonical: https://bigchange.ai/blog/connect-shopping-agent-shopify-shop-mcp

![Conceptual charcoal illustration of a product shelf, a shopping basket holding one cup, and a blank checkout terminal; a shopper's hand pauses short of the terminal.](https://bigchange.ai/api/media/file/shop-mcp-catalog-to-checkout-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual Shop MCP interface, agent test or purchase is depicted.

Shopifyは[10月13日にShop MCPを公開し](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp)、商品検索、カート、チェックアウトに使えるホステッド接続を開発者に提供した。サービスのURLは`https://mcp.shop.com/`。17個のツールでShopify Catalogの商品を探し、その商品を販売する加盟店のチェックアウトを開ける。カタログ検索にAPIキーは不要だ。実際の購入には、引き続き購入者の承認が必要となる。

このガイドは、MCP対応アシスタントを設定する開発者向けだ。手順は10月14日に確認したShopifyの文書に沿っている。BIG CHANGEはエージェントを接続したり、カートを作成したり、購入したりしていない。そのため、ここでは観測した性能ではなく、想定される結果を説明する。

## 大きな変化

- **変わった点：** Shopifyは、カタログ検索から加盟店のカート、チェックアウトまでをつなぐホステッドMCP接続を提供するようになった。また、ログイン済みの購入者が明示的に確認した後、Shop Payでチェックアウトを完了する方法も説明している。
- **利用できる人：** プロトコルバージョンに対応したMCPクライアントを使う開発者`2026-07-28`、または文書化されたHTTP呼び出しを行うコード。ハンドシェイクしか使わない古いクライアント`initialize`は直接接続できない。
- **確認事項：**チェックアウトは1つの加盟店との取引だ。`completed`と1つの`order`の両方がそろって初めて購入を確認できる。カート、チェックアウトリンク、処理中の支払いでは確認にならない。

## 接続前の準備

必要なのは、リモートHTTPサーバーに対応し、Shopifyが文書化した[接続方式](https://shop.dev/docs/connect)サポートするMCPクライアント、またはHTTPでサーバーを呼び出すアプリが必要だ。ルートURL`https://mcp.shop.com/`を使う。`/mcp`を付けると404になる。検索とカートのツールはShopアカウントなしで使える。ログインすると、アシスタントは保存済みの設定や住所を使い、注文を探し、加盟店が対応していればShop Payを提示できる。独自のHTTPコードを使うアシスタント向けに、Shopifyは購入者がShopサイトで承認するOAuthデバイスフローを文書化している。

検索前に、商品クエリ、配送先の国、通貨を選ぶ。購入者が示した要件と検索コンテキストを分ける。国や通貨は結果のローカライズに役立つが、価格上限、サイズ、配送先はフィルターだ。APIの価格は通貨の最小単位で示される。フィルターに合う結果だと説明する前に、応答の`messages`を読むこと。要求したフィルターが適用されなかったとサービスが報告する場合がある。[Shopifyの検索ガイド](https://shop.dev/docs/search)では、この違いと1ページあたり1〜50件という上限を説明している。

## 検索から注文までの文書化された流れ

1. **接続して検索を確認する。**クライアントに`https://mcp.shop.com/`を設定し、対応していればShopifyの[Shop skill](https://shop.dev/docs/connect)を読み込む。Shopifyは、カートを作成せずにデスクランプを3つ検索するリクエストで接続を確認する方法を推奨している。正しく動作する検索では、販売者、指定通貨での価格、加盟店のリンクを含む商品が返る。HTTPを使う開発者は、必要なプロトコルヘッダーと[リクエストを含むShopifyの](https://shop.dev/docs/quickstart)JSON-RPCクイックスタート`search_catalog`を参照できる。これは読み取り専用の確認で、ログインも不要だ。
2. **商品を正確に選ぶ。**購入者のクエリと要件で`search_catalog`を実行する。検索では注目バリエーションが返る。購入者が別のサイズや色を希望する場合は`get_product`を使う。表示や購入の前に、`product.selected`と返された`variant.options`を、購入者が指定したサイズ、色、その他の選択肢すべてと照合する。Shopifyによると、選択条件は警告なしで緩和される場合がある。購入者が商品を選ぶか、オプションを変更したら、`get_product`を再度呼び出して最新の在庫と価格を確認する。バリエーションIDと販売者ドメインは、返された値をそのまま保持する。加盟店が先に表示した価格を維持するとは限らない。警告は該当する商品と一緒に表示する。これらの確認方法は[商品を探す](https://shop.dev/docs/search)に記載されている。
3. **依頼されたときにカートを作成する。**購入者から商品をまとめるよう指示されたら、選んだ加盟店とバリエーションに対して`create_cart`を呼び出す。カートは商品を保存するが、注文は行わない。販売者が異なる商品は別々のカートにする。Shopifyによると、各カートとチェックアウトは1つの加盟店に属する。結果にはカートIDと明細が含まれる。購入者が見るだけなら検索後に止める。Shopifyの[カートガイド](https://shop.dev/docs/checkout)では、商品に関心があるだけではカート作成の許可にならないとしている。
4. **チェックアウトを開いて確認する。**購入者が合計金額を尋ねるか、購入する準備ができたら、カートID、または検索結果で返された正確なバリエーションIDと販売者ドメインを使って`create_checkout`を呼び出す。チェックアウト文書には、ID、ステータス、明細、通貨、合計、支払い方法、`messages`、加盟店ポリシー`links`、加盟店ページへの`continue_url`が含まれるはずだ。続行前に、送料と税金を含む現在の合計とラベル、すべての警告、ポリシーへのリンクを購入者に見せる。説明は該当する商品や項目のそばに置く。エージェントがチェックアウトを完了できる場合も、クエリパラメーターを含めて変更していない`continue_url`を、対象商品と一緒に購入者へ渡す。住所が必要ならチェックアウトは`incomplete`になり、購入者が加盟店ページで完了する必要がある場合は`requires_escalation`になることがある。Shopifyによると、チェックアウトは標準で6時間後に失効する。
5. **支払いは購入者に任せる。**購入者がログインすると、保存済み住所やShop Payが提示される場合がある。`complete_checkout`を呼び出す前に最新のチェックアウトを読み、`ready_for_complete`状態であることを確認し、加盟店、商品、数量、合計、利用可能な方法を表示して、購入者に支払い方法を選んでもらう。代わりに選んではならない。エージェントが完了できる場合も、変更していない加盟店の`continue_url`を購入者が使えるようにする。支払い手段がない場合は、購入者がそのリンクを使う必要がある。Shopifyの[チェックアウト手順](https://shop.dev/docs/checkout)では、承認後に`complete_checkout`を1回だけ送信し、返されたステータスを確認するよう案内している。Shopify以外の店舗向けの別の[承認フロー](https://shop.dev/docs/approvals)では、購入者はShopで支払いを承認し、その店舗独自のチェックアウトに使うカードを提供する。これは手順3、4のShopify加盟店チェックアウトとは異なる。
6. **結果を確認する。**加盟店が注文を作成したと確認できるのは、`status: completed`と`order`がある場合だけだ。支払い処理中なら`get_checkout`を使って状態を再度読む。Shopifyによると、公開時点ではWebhookがないため、更新の取得には`get_checkout`をポーリングする必要がある。完了呼び出しがタイムアウトしたり、応答が不明瞭だったりしても、再送したり、別のチェックアウトを開いたりしない。既存のチェックアウトを読み取る。そこに`completed`と`order`の両方がなければ、購入は未確認だと購入者に伝え、`continue_url`を渡す。

## 制限と復旧

Shopifyによると、検索は認証情報なしで機能する。高いレート制限が必要な開発者には、[ローンチノート](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp)でShopify Dev DashboardのAPIキーを案内しているが、公開価格や制限表は示していない。加盟店商品の価格、配送、税金は現在のチェックアウトに基づくため、購入者は支払い前に確認する必要がある。開発者がホスティングやモデルを使う場合、エージェント側に別途費用がかかることもある。告知ではその費用を定量化していない。

読み取りに失敗した場合は、指定された`retry_after`待機時間の後に再試行できる。カートとチェックアウトの作成・更新では、Shopifyの[エラーガイド](https://shop.dev/docs/errors)は、不確実な書き込みを繰り返す前に冪等性キーを使い、既存リソースを読み取るよう勧めている。IDが返る前にキーなしの作成が失敗した場合、結果は不明だ。推測で別のものを作成してはならない。`complete_checkout`はさらに厳格で、応答が不確実な場合は決して再実行しない。`requires_escalation`や支払い情報の不足でエージェントが完了できない場合も、購入者は加盟店のページを使う。

チェックアウトID、チェックアウトリンク、アクセストークン、支払い手段は機密として扱う。ShopifyによるとチェックアウトIDと`continue_url`にはアクセスキーが含まれるため、ログや分析に記録せず、リンクは購入者だけに共有する。[認証リファレンス](https://shop.dev/docs/authentication)では、Shopトークンを`https://mcp.shop.com/`への認可ヘッダーにだけ送るよう説明している。支払い手段に認証情報が含まれる場合があるため、表示や記録をしない。

BIG CHANGEは以前、Shopifyの[ブラウザーエージェント向けチェックアウトツール](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout)を取り上げた。今回のホステッドMCPは、カタログ探索から始まる別のワークフローを示す。Shopifyの公開ノートとマニュアルは、開発者が呼び出せる機能と確認すべき応答を示すが、コンバージョン向上、負荷時の信頼性、BIG CHANGEによる購入成功を実証するものではない。

## 出典と参考情報

- [Shopify開発者向け変更履歴、「Shop MCPであらゆるエージェントにショッピングとShop Payチェックアウトを追加」、2026年10月13日](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp)。ローンチ範囲、ホステッドエンドポイント、17個のツール、検索アクセス、チェックアウト経路、公開時点のWebhook状況。
- [Shop MCPの概要と接続ガイド](https://shop.dev/docs/)。現行プロトコル、クライアント要件、ログイン要件。
- [Shopify、商品を探す](https://shop.dev/docs/search)。検索項目、バリエーション選択、価格単位、フィルター警告。
- [Shopify、カートとチェックアウト](https://shop.dev/docs/checkout)。加盟店の範囲、ステータスの意味、チェックアウト完了、不確実な結果の扱い。
- [Shopify、エラーと再試行](https://shop.dev/docs/errors)。読み取りと書き込みの復旧ルール。
- [Shopify、認証](https://shop.dev/docs/authentication)。Shopアカウントのアクセスとトークンの扱い。

## Sources

- [Shopify開発者向け変更履歴、Shop MCPであらゆるエージェントにショッピングとShop Payチェックアウトを追加](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) — 公開日、稼働中のエンドポイント、17個のツール、キー不要のカタログ検索、ShopおよびShopify以外のチェックアウト経路、公開時点でWebhookなし、レート制限引き上げのためのDev Dashboardキー。独立した結果ではなくShopifyの主張。
- [Shop MCPの概要](https://shop.dev/docs/) — ホステッドエンドポイント、2026-07-28 MCPバージョン、2026-08-25 UCP文書バージョン、チェックアウトごとに加盟店1社、注文完了による確認。
- [Shop MCP、エージェントを接続](https://shop.dev/docs/connect) — ルートURLとプロトコル要件、クライアントの接続方法、skillの読み込み、読み取り専用の接続確認。
- [Shop MCP、クイックスタート](https://shop.dev/docs/quickstart) — 文書化されたJSON-RPC検索リクエスト、ヘッダー、応答形式、価格単位、エラー。
- [Shop MCP、商品を探す](https://shop.dev/docs/search) — クエリ、フィルター、コンテキスト、注目バリエーション、警告。
- [Shop MCP、カートとチェックアウト](https://shop.dev/docs/checkout) — カートとチェックアウトの各ツールの動作、加盟店の範囲、チェックアウト項目とステータス、人による支払い承認、機密ID、不確実な完了への対応。
- [Shop MCP、エラーと再試行](https://shop.dev/docs/errors) — 読み取りの復旧、支払い以外の書き込みに対する冪等性キー、不確実な場合にcomplete_checkoutを再実行しないこと。
- [Shop MCP、認証](https://shop.dev/docs/authentication) — Shopトークンの範囲、OAuthデバイスフロー、秘密の認証情報の保護。
- [Shop MCP、Shopify以外での購入を承認](https://shop.dev/docs/approvals) — Shopifyを使わない加盟店のチェックアウトに対する、別個の購入者承認とカードの経路。