Shopify AI Toolkit 2026：開発者とマーチャントが知っておくべきこと

Shopify AI Toolkitは開発者向けのツール群です。ShopifyのUniversal Commerce Protocol（UCP）とコマースエンドポイントは、関連はありますが、プラットフォームの別の要素です。このガイドでは、現行のToolkit、Shopifyの開発者ドキュメントに記載されたUCPエンドポイント、それらがストア運営者に提供する機能を説明します。Revizeの分析では、注文の5.2%がチェックアウト後に編集されています（Revize, 2026）。これは購入後の業務の背景情報であり、AI経由の注文に関する主張ではありません。

Toolkitは、対応するAIコーディングツールから、開発者がShopifyの最新ドキュメントやAPIガイダンスを探すのに役立つ場合があります。マーチャントは自社の要件、Shopifyの現行エンドポイントのドキュメント、各エージェント提供者の動作に基づいてコマース連携を評価してください。このガイドでは、そうした検証可能な部分に焦点を当てます。

Shopify AI Toolkitとは？#

Shopify AI Toolkitは、対応するAI開発ツール向けに、プラグイン、エージェントスキル、ローカルのDev MCPサーバーを提供します。現在、プラグインの対応ツールとしてClaude Code、Codex、Antigravity CLI、Cursor、OpenClaw、Pi、VS Code、Hermesが挙げられています。OpenClaw、Pi、Hermesはプラグインのみの対応です。最新の設定手順と対応ツールは公式AI Toolkitドキュメントを確認してください。Dev MCPはローカルで動作し、ドキュメントとスキーマのツールにはShopifyストアの認証が不要です。

ローカルのDev MCPは、Model Context Protocolを通じて開発用のリソースを提供します。ストア操作は、別途認証されたShopify CLIの環境を使います。ドキュメントサーバーをインストールしても、販売者のストアへのアクセスは許可されません。

役立つ開発機能は具体的です。

• 最新のドキュメントを探す： 連携を生成する前に、適切なAPIとバージョンを特定します。
• GraphQLスキーマを確認する： クエリやミューテーションを書く前に、フィールド名、引数、返り値の型を確認します。
• コードを検証する： 生成したGraphQL、Liquid、拡張コードをShopifyのスキーマで検証し、実行時の動作をローカルでテストします。
• CLIでストアを管理する： 範囲を限定した操作を準備し、選んだストアを認証し、クエリと変数を確認して実行時期を選びます。ミューテーションには明示的な有効化が必要です。

検証はスキーマやコンポーネントの誤りを検出しますが、販売者の業務ルールに合うことは証明しません。実行前に差分、要求権限、対象ストアを確認してください。

ShopifyのコマースMCP・UCPインターフェース#

Shopifyはカタログ検索、チェックアウト、注文へのアクセスを別々のコマースインターフェースとしてドキュメント化しています。エンドポイントの形式、認証、操作はそれぞれ異なり、どれも万能のエージェントインターフェースとして扱うべきではありません。

1. UCP経由のStorefront Catalog#

Shopifyのストア固有のカタログエンドポイントはhttps://{shop}.myshopify.com/api/ucp/mcpで、search_catalog、lookup_catalog、get_productと、meta.ucp-agent.profile内のエージェントプロファイルを使います。Storefront MCP移行ガイドでは、カタログ・カートツールがUCPへ移り、search_shop_policies_and_faqsは/api/mcpに残ります。商品発見の仕様は、Storefront Catalogリファレンスを参照してください。

このエンドポイントでチェックアウトや注文変更まで扱えるとは考えないでください。Shopifyはチェックアウトと注文を、それぞれ独自の認証、権限、対応操作を持つ別のエージェントインターフェースとして説明しています。

2. Global Catalog#

Shopifyは、Shopify全体のカタログ検索用に、Global Catalogエンドポイントhttps://catalog.shopify.com/api/ucp/mcpを説明しています。ツールとアクセス要件は、マーチャントのストア固有カタログエンドポイントと異なります。開発前にShopifyのエージェント向けカタログの概要を確認し、古いStorefront MCPエンドポイントやツールの例を再利用しないでください。

3. Order MCP：エージェント経由の注文へのアクセス#

ShopifyのOrder MCPは現在、エージェント経由で作成された注文の現在の状態を取得するget_orderツールを説明しています。顧客の注文履歴全体への汎用アクセスではなく、注文編集も行いません。関連する注文アクセス権とエージェントプロファイルの権限が必要です。業務手順に利用する前に、ShopifyのOrder MCPドキュメントを読んでください。

ShopifyはCheckout MCP経由のチェックアウト機能も別途説明しています。認証または署名付きリクエストが必要で、購入者に確認やチェックアウト完了を引き継ぐ場合があります。現行の仕様はCheckout MCPドキュメントを確認してください。

4. Customer Accounts MCP：認証済み顧客のリクエスト#

Customer Accounts MCPは引き続き対応しています。https://{shop}/.well-known/customer-account-apiからmcp_apiを検出します。エンドポイント形式はhttps://{shop}/customer/api/mcpです。PKCEを使うOAuth認可コードで、そのストアの顧客別の注文詳細、状況、アカウント設定へのアクセスを許可します。アプリには顧客認証設定、カスタムドメイン、保護対象顧客データへのアクセスが必要です。tools/listで対応操作を確認してください。Order MCPのエージェント経由の注文という範囲とは異なり、どちらの名前も任意の注文編集を意味しません。

Universal Commerce Protocol（UCP）：各層を支える基盤#

ShopifyはUCPを、エージェント、マーチャント、決済サービス、認証情報提供者の間のやり取りのためのオープンコマースプロトコルと説明しています。ドキュメントは検索、チェックアウト、注文関連の手順を定めています。それでも実装ごとにエンドポイント、リクエスト形式、認証、権限は異なり、UCPという名称だけで、すべてのクライアントがすべてのツールを呼べるわけではありません。実装前にShopifyのエージェントプロファイルのドキュメントと、各エンドポイントのリファレンスを確認してください。

プロトコルの主な領域は次のとおりです。

1. カタログ検索 — ドキュメントに記載されたカタログエンドポイントで商品を探し、対応する商品情報を取得します。
2. チェックアウト — ドキュメントに記載された手順でチェックアウトを作成・継続します。認証や購入者への引き継ぎが必要な場合があります。
3. 注文へのアクセス — 記載されたプロファイルとアクセスルールのもとで、対応する注文情報を取得します。エージェントが注文を編集・返金できるという意味ではありません。

マーチャントは、関連するShopifyカタログエンドポイントが自社で利用可能で、設定済みかを確認してください。エンドポイントが存在しても、特定のAI製品がそれを使ったり、すべての商品を表示したりすることは保証されません。ShopifyのUCPガイドと現行のエンドポイントドキュメントを確認し、対応予定のクライアントでテストしてください。

マーチャントが今確認できること#

1. AI検索からの流入は増えていますが、それがMCPによるものとは証明されていません。 Shopifyは2026年6月、AI検索経由の注文が前年比13倍となり、コンバージョンが49%、平均注文額が14%高いと報告しました。これはShopifyが報告したAI検索の数値であり、すべてのマーチャントの予測や、特定のMCPエンドポイントが注文を生んだ証拠ではありません。Shopifyの2026年6月の更新を参照してください。

2. 実際の購入後の手順を確認してください。 Shopifyが説明するOrder MCPは、対応するエージェント経由の注文情報を読めますが、注文編集は行いません。エージェントエンドポイントが対応すると考えるのではなく、対象注文を修正する顧客向け導線を確認してください。

3. 商品情報を正確に保ってください。 明確なタイトル、オプション、在庫状況、ポリシーは、顧客やコマースシステムがカタログを理解するのに役立ちます。特定のデータ形式が順位やコンバージョンを保証すると考えず、自社で成果を測定してください。

開発者や制作会社によるAI Toolkitの活用#

1つの開発作業から始めます。スキーマを確認し、クエリを生成・検証し、開発ストアで結果を確認してください。

対応クライアントのShopifyプラグインをインストールするか、記載されたスキル・Dev MCPのインストール手順に従ってください。プラグインは自動更新されますが、手動で入れたスキルは更新が必要です。実際に使うクライアントの手順に従います。

ストア管理には、必要なスコープのみでShopify CLIを認証します。store executeコマンドは、保存した認証に対して確認済みのAdmin GraphQL操作を実行します。たとえば、次は開発ストアの最初の10商品を読み取ります。

shopify store auth --store YOUR-DEV-STORE.myshopify.com --scopes read_products
shopify store execute --store YOUR-DEV-STORE.myshopify.com --query '{ products(first: 10) { nodes { id title } } }'

プレースホルダーを自分の開発ストアに置き換えてください。読み取りはミューテーションを有効化せずに使えます。書き込みには--allow-mutationsと該当スコープが必要です。有効化前にミューテーションと変数をすべて確認し、対象ストアを検証し、本番の変更前に意図した動作をテストしてください。

自社ストアでエージェントによるショッピングを有効にする#

Shopifyカタログエンドポイントを使う場合は、meta.ucp-agent.profileを含む現行のStorefront Catalogのリクエスト形式に従ってください。商品の検索成功は、チェックアウトや注文へのアクセスを証明しません。Shopify Catalog MCPガイドで、商品発見ツールと制限を説明しています。

ブランド独自のエージェントには、Shopifyの現行のサンプルプロジェクトとエンドポイント別のチェックアウトドキュメントを使います。自社のカタログ、認証、決済、サポート要件に沿って段階的な展開を計画してください。サンプルプロジェクトは本番連携のチェックリストではありません。公開前に顧客へ表示される商品情報とチェックアウトの引き継ぎをテストしてください。

エージェントを使う構成における購入後対応の位置づけ#

商品発見、チェックアウト、注文追跡、顧客による編集には、それぞれ対応するインターフェースが必要です。Shopify MCPとUCPのエンドポイントガイドで、その責任範囲を整理しています。

ShopifyはOrder MCPを、対応するエージェント経由の注文を読むインターフェースとして説明し、UCP注文Webhookでライフサイクルの更新を提供します。汎用の注文編集手順は提供していません。Revizeは、マーチャントが設定した編集可能期間に従い、フルフィルメント前に対象となる住所、バリエーション、数量、キャンセルの変更を行う顧客向けポータルを提供します。商品追加、別商品への交換、割引適用、ストアクレジットでの返金はProの機能です。スタッフ側の注文編集は開発中です。ポータルには注文状況ページのRevizeアプリブロックが必要で、メールのEdit Orderリンクからも開けます。製品の詳細はShopify App StoreのRevizeをご覧ください。

関連記事#

Shopify注文編集の統計 · Shopify Agentic StorefrontsでChatGPT上で販売する方法 · Shopifyで顧客が自分の注文を編集できるようにする方法