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

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

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

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

制限と復旧

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

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

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

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

出典と参考情報