目次
Shopify MCPは、目的の異なる複数のインターフェースを扱います。ShopifyのStorefront MCP移行ガイドは、従来のカタログ・カートツールをUCPに対応付ける一方、ポリシー・FAQツールとCustomer Accounts MCPを維持しています。購入者の作業に応じてインターフェースを選び、スキーマと認可を確認してください。このガイドでは、顧客向けの購入後編集フローの位置付けも説明します。
技術的な仕組みの要点
MCP（Model Context Protocol）は、AIクライアントが使うツールインターフェースです。Shopifyの現行のコマースドキュメントには、カタログ検索、チェックアウト、注文へのアクセスのUCP（Universal Commerce Protocol）エンドポイントも説明されています。クライアントはエンドポイントの現行スキーマ、認証、権限を使う必要があり、エンドポイントの名称や機能は置き換え可能ではありません。
| インターフェース | 用途 | 現行ドキュメント |
|---|---|---|
| ストア固有のカタログ | 1マーチャントの商品検索 | Storefront Catalog — https://{shop}.myshopify.com/api/ucp/mcp |
| Global Catalog | Shopify全体の商品検索 | エージェント向けカタログの概要 |
| ポリシーとFAQ | 販売者のポリシーとFAQの回答 | ポリシーとFAQツール — https://{shop}/api/mcp |
| Checkout MCP | チェックアウトセッションと購入者への引き継ぎ | Checkout MCP |
| Order MCP | 対応するエージェント経由の注文情報を読む | Order MCP |
| Customer Accounts MCP | 認証済み顧客の注文・アカウントに関するリクエスト | Customer Accounts MCP — 検出したhttps://{shop}/customer/api/mcp、PKCEを使うOAuth認可コード |
| Dev MCP | 開発者向けドキュメントとスキーマツール | Shopify AI Toolkit |
Storefront Catalogドキュメントにはsearch_catalog、lookup_catalog、get_productが記載され、meta.ucp-agent.profileにエージェントプロファイルが必要です。Checkout MCPとOrder MCPのアクセスルールと対応操作は異なります。商品発見ツールとその制限は、Shopify Catalog MCPガイドをご覧ください。
私たちの判断：現行ドキュメントのエンドポイントを使って開発する
古い連携をツール単位で対応付けます。商品発見はStorefront Catalog、カート操作はCart MCP、チェックアウトはCheckout MCPを使います。ポリシーの照会は/api/mcpに維持します。トラフィックを移す前に、各代替ツールのリクエストスキーマとアクセスルールを開発環境でテストしてください。
カタログエンドポイントは商品検索に対応する場合がありますが、それだけでエージェントがチェックアウトを作成したり、購入者の注文を読んだり、変更したりできるとは証明されません。それらは別の手順です。AI ToolkitのDev MCPは開発者向けで、購入者向けのコマースエンドポイントとは異なります。
AIエージェントはストアで実際に何をするのか
順序はエージェントと使用するShopifyインターフェースによります。カタログリクエストでは商品データの検索や取得ができます。チェックアウトの手順には認証や署名付きリクエストが必要な場合があり、購入者へ購入の確認・完了を案内することもあります。ShopifyのOrder MCPは、対応するエージェント経由の注文のget_orderを説明しています。チャネル横断の汎用注文履歴APIではありません。サポートやフルフィルメントに接続する前に、各エンドポイントの範囲を読んでください。
認証済み顧客のアクセスは別の連携
Customer Accounts MCPは、そのストアにログインした顧客の注文詳細、状況、アカウント設定をアシスタントが扱えるようにします。https://{shop}/.well-known/customer-account-apiからmcp_apiを検出し、OAuth 2.0認可コードとPKCEで認証してください。設定にはカスタムドメイン、顧客認証の構成、適切な保護対象顧客データへのアクセスが必要です。認証後にtools/listで実際のツールとスキーマを確認します。任意の編集や販売者を横断するアカウントアクセスを想定してはいけません。
一方、Order MCPはエージェントの認証情報で、そのエージェント経由の注文を読み取ります。Shopifyの注文Webhookガイドは、UCPライフサイクル更新と、パートナーマネージャーを通じたShopify側の登録を説明しています。配信と照合は、Shopify Agentic注文の運用ガイドで扱います。
購入後の手順は別に必要です
商品検索やチェックアウトのエンドポイントは、汎用の注文編集操作を提供しません。Shopifyの現行のOrder MCPドキュメントは、対応するエージェント経由の注文の状態を読むことを説明しており、編集は行いません。顧客がチェックアウト後に住所、数量、バリエーションを修正する必要があるとき、この違いは重要です。
ストアは、自社ポリシーとフルフィルメントの状態に照らして対象となる変更の、顧客向け導線を提供すべきです。Revizeの顧客向け注文編集アプリはマーチャントが設定した編集可能期間中、フルフィルメント前に顧客が住所、数量、バリエーション、キャンセルを自分で変更する機能を提供します。別商品への交換、商品追加、割引適用、ストアクレジットでの返金はProの機能です。ポータルには注文状況ページのRevizeアプリブロックが必要で、メールのEdit Orderリンクからも利用できます。標準エディターの手順と制限は、Shopify注文編集ガイドをご覧ください。
Shopifyが現在説明している機能
Shopifyの現行リファレンスと照らして確認すべき、記載された機能は次のとおりです。
- 記載されたカタログツールとエージェントプロファイルを使う、UCPエンドポイント経由のストア固有カタログ検索。
- より広い商品検索のための、別のGlobal Catalogエンドポイント。
- 独自の認証・署名付きリクエスト要件を備え、購入者への引き継ぎがあり得るCheckout MCP。
- 対応するエージェント経由の注文向け
get_orderツールを備えたOrder MCP。 - 顧客が許可した個別リクエスト向けのCustomer Accounts MCPと、公開されたストアの質問向けのポリシー・FAQツール。
- Shopify AI ToolkitとDev MCPによるローカルの開発者ツール群。
エンドポイント名だけでは、無制限のストアアクセス、全般的な顧客アカウント履歴、注文編集の権限を意味しません。各インターフェースの記載された範囲を使ってください。開発者向けツールは、Shopify AI Toolkitガイドで別途説明しています。
今四半期に私たちが実際に行うこと
- 作業からエンドポイントを選ぶ。 商品検索には現行のStorefront Catalogドキュメント、チェックアウトにはCheckout MCP、対応する注文の読み取りにはOrder MCPを使います。
- プロファイルとアクセス要件を確認する。 Storefront Catalogのリクエストには
meta.ucp-agent.profileが含まれます。ほかのエンドポイントの正確な要件は個別に確認します。 - 開発環境でテストする。 顧客向け公開を計画する前に、リクエストスキーマ、返されるフィールド、認証、購入者への引き継ぎを検証します。
- 購入後を別に点検する。 顧客が対象となる注文変更を確認・依頼できる導線を確保します。MCPが完了済みの注文を編集すると期待しないでください。
- リリース前にドキュメントを再確認する。 ShopifyのエージェントAPIとクライアント対応は変わる場合があります。コピーした例ではなく、最新の一次資料を使ってください。
結論
クライアントに必要なデータと、アクセスを許可する人の認可を明確にしてください。カタログ検索、チェックアウト、公開ポリシーの回答、顧客アカウント、エージェント経由の注文読み取りは、それぞれ契約が異なります。Universal Commerce Protocol開発者ガイドで、UCPインターフェースの基盤にある機能交渉を説明しています。
マーチャントは、顧客サービスと購入後の編集を、明示的な設計項目として扱ってください。Shopifyが説明するOrder MCPは対応するエージェント経由の注文を読めますが、汎用の注文編集手順は提供しません。顧客向け編集ポータル、マーチャントのポリシー、フルフィルメントの締め切りは、引き続き別の検討事項です。
よくある質問
現行のShopify MCPエンドポイントは何ですか？
Storefront Catalogと記載されたカート・チェックアウトツールには/api/ucp/mcpを使います。公開ポリシーの照会は/api/mcpに残り、認証済み顧客のリクエストは検出したCustomer Accounts MCPエンドポイントを使います。具体的な作業に対応するエンドポイントを選んでください。
商品検索にはどのShopifyエンドポイントを使うべきですか？
1マーチャントのカタログには記載されたストア固有カタログエンドポイントを、より広い検索にはShopifyの別のGlobal Catalogエンドポイントを使います。現在のツールとリクエスト要件はカタログの概要を確認してください。
UCPとは何ですか？
UCPは、記載されたエージェント、マーチャント、認証情報提供者、決済サービスのやり取りのためのShopifyのオープンコマースプロトコルです。検索、チェックアウト、注文操作に共通の万能な権限モデルはないため、エンドポイント別リファレンスを使ってください。
エージェントプロファイルは必要ですか？
Storefront Catalogドキュメントは、meta.ucp-agent.profileにプロファイルを要求します。同じ要件や権限がどこでも適用されると考えず、ほかの各エンドポイントのドキュメントを確認してください。
AIエージェントはチェックアウトを完了できますか？
ShopifyはCheckout MCPを別途説明しています。現行の手順には認証または署名付きリクエストが必要で、購入者へチェックアウトの確認・完了を案内する場合があります。対応する手順はCheckout MCPリファレンスを確認してください。
Shopify MCPはすべてのプランで利用できますか？
提供状況とアクセスはエンドポイントとストア設定によります。具体的な連携について、Shopifyの現行プランとエンドポイントドキュメントを確認してください。MCPの例からプランのアクセスを推測しないでください。
Global CatalogとStorefront Catalogはどう違いますか？
Storefront Catalogは1マーチャントに範囲が限定されます。Global CatalogはShopify全体の商品検索のための別の検索エンドポイントです。エンドポイントとツールの仕様が異なります。
Order MCPは何をしますか？
Shopifyは、対応するエージェント経由の注文の現在の状態を読むget_orderツールを説明しています。顧客のすべてのチャネルの注文履歴を扱う汎用エンドポイントではありません。
Customer Accounts MCPとOrder MCPはどう違いますか？
Customer Accounts MCPは、そのストアのアカウントや注文のリクエストに顧客のOAuth認可を使います。Order MCPはエージェント範囲のアクセスを使い、そのエージェント経由で確定した注文だけを取得できます。顧客サービスの操作を選ぶ前に、各ツールのスキーマを確認してください。
Shopify MCPは購入後の注文変更に対応していますか？
いいえ。現行のOrder MCPドキュメントは注文の読み取りを説明しており、編集は説明していません。顧客向けの注文変更には別の手順が必要で、引き続きストアポリシーとフルフィルメントの状態に従います。
Shopifyエンドポイントはどうテストしますか？
そのエンドポイントの公式リファレンスに従い、記載されたリクエストを開発環境でテストします。リリース前に、認証、必要なプロファイルデータ、返されるフィールド、チェックアウトの引き継ぎを確認してください。
ShopifyはAI検索の成長について何を報告しましたか？
Shopifyは2026年6月、AI検索経由の注文が前年比13倍になり、コンバージョンが49%、平均注文額が14%高いと報告しました。これらはShopifyのAI検索の報告値で、特定のMCPエンドポイントの性能を示すものではありません。Shopifyの報告を参照してください。
実装で最優先にすべきことは何ですか？
具体的な作業を1つ選び、現行のShopifyエンドポイントドキュメントに従って、リクエスト全体と顧客体験をテストします。カタログ、チェックアウト、注文の読み取り、購入後の編集は別々の手順として扱ってください。
関連記事
Shopify Agentic StorefrontsでChatGPT上で販売する方法 · Shopifyで顧客が自分の注文を編集できるようにする方法