Shopify AI Toolkit はひとつのものではありません。これはレイヤーの重なりです。そして、それがこのツールキットについて最も誤解されている事実です。マーチャントは「有効化すべきか」を聞き続け、開発者は「どのエンドポイントにあるのか」を聞き続けていますが、どちらも問いが違います。AI Toolkit は実際には、Shopify が過去6か月で順次提供した3つの別々のインフラ層を、ひとつのマーケティングの傘の下にまとめたものです。AI コーディングアシスタントを使って Shopify アプリを構築するための開発者向けツールチェーン、AI ショッピングエージェントが Shopify ストア上で取引できるようにする MCP サーバー群、そしてエージェント、マーチャント、決済処理事業者、認証情報プロバイダー同士が標準的な方法でやり取りできる UCP というオープンプロトコルです。

月間1万件を超える注文がある Shopify Plus ストアを運営しているなら、これは気にするべきです。計画していようがいまいが、あなたのストアはエージェントから到達可能な存在になっていくからです。コンバージョン品質にこだわる CX 重視の Advanced マーチャントなら、次の波の「ショッピングアシスタント」が、良質な購入者を連れてくるのか、それとも通り過ぎさせるのかが重要だからです。そして、自分のストア向けでも App Store 向けでも Shopify アプリを作るなら、Toolkit の開発者向け側は、採用したチームでは一般的な管理業務の開発時間を40〜60%短縮しています。このガイドでは、各レイヤーの役割、動作、そして2026年にマーチャントがどこに注目すべきかを解説します。

Shopify AI Toolkit とは何か？

Shopify AI Toolkit は、AI コーディングアシスタント — Claude Code、Cursor、Gemini CLI、Codex、VS Code — を Shopify のドキュメント、API スキーマ、そしてローカルの CLI ベース「store execute」機能に直接接続する、開発者向けの統合機能です。プラグインとして提供されるほか（推奨、自己更新あり）、手動でインストールできるエージェントスキル群、そして開発者のマシン上で認証なしに動作するローカルの Dev MCP サーバーとして提供されます。

置き換えるものは、2025年3月3日に廃止された旧 .dev Assistant VS Code 拡張機能です。基盤になっているのは Model Context Protocol（MCP）で、Anthropic が2024年後半に提供したオープン標準と同じものです。現在では主要な AI コーディングツールのすべてがこれをサポートしています。

実務的には、Toolkit の Dev MCP 側によって、開発者は AI 支援エディタから離れずに次のことができます。

• ライブの Shopify.dev ドキュメントを検索し、3か月前に一般的な Web クローラーで取得された内容ではなく、現在の API バージョンに一致する関連性で検索できる。

• GraphQL Admin API のスキーマをイントロスペクトし、存在しないフィールドを幻覚的に作り出すのではなく、正しいフィールド名と型で AI アシスタントがクエリを書けるようにする。

• 生成された GraphQL コードやコンポーネントコードを、開発者が実行する前に実際のスキーマに照らして検証する。

• shopify store auth と shopify store execute を通じて、検証済みの Admin 操作を特定のストアに対して実行し、「最初の10商品を見せて」といった指示を開発者自身のストアから実際の結果に変える。

この最後の機能こそが、日々の開発を最も変えます。「クエリを書く → 管理画面に切り替える → 実行する → 結果を確認する → 戻って反復する」を、エディタ内だけで完結するひとつの往復に圧縮するからです。

しかし、これは3つのレイヤーのうちのひとつにすぎません。人々がここで止まると、混乱が始まります。

マーチャントが知っておくべき3つの MCP サーバー

Dev MCP 以外に、Shopify はさらに3つの MCP サーバーを提供しています。これらはマーチャントにとって重要です。なぜなら、AI ショッピングエージェントがあなたのストアフロント、カタログ、そして顧客の注文とどのようにやり取りするかを定義するからです。

1. Storefront MCP — 1つのマーチャント、1つのエージェント

Storefront MCP サーバーは、すべての Shopify ストアがエージェント向けに公開するエンドポイントです。その特定ストアとやり取りするためのものです。認証は不要です。エンドポイントの形式は https://{shop}.myshopify.com/api/mcp で、次のような JSON-RPC 呼び出しを受け付けます。

const mcpEndpoint = `https://your-store.myshopify.com/api/mcp`;

fetch(mcpEndpoint, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/call',
    id: 1,
    params: {
      name: 'search_shop_catalog',
      arguments: {
        query: 'organic coffee beans',
        context: 'customer preference for fair-trade single-origin'
      }
    }
  })
});

const mcpEndpoint = `https://your-store.myshopify.com/api/mcp`;

fetch(mcpEndpoint, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/call',
    id: 1,
    params: {
      name: 'search_shop_catalog',
      arguments: {
        query: 'organic coffee beans',
        context: 'customer preference for fair-trade single-origin'
      }
    }
  })
});

Storefront MCP が公開するツールには、search_shop_catalog（自然言語クエリで商品を検索）、search_shop_policies_and_faqs（配送、返品などに関する顧客の質問に回答）、update_cart（追加、削除、数量変更）、get_order_status、get_most_recent_order_status があります。最後のものは重要です。Storefront MCP に対応した AI エージェントは、戻ってきた顧客の注文状況を確認し、遅延を知らせ、返品を開始できます。これは人間のサポート担当者が行うような CX 業務です。

2. Catalog MCP — 1つのエージェント、すべての Shopify マーチャント

Catalog MCP はその逆です。エージェントが単一の呼び出しで すべて の対象 Shopify マーチャントを横断して検索できる、グローバル検索レイヤーです。Storefront MCP とは異なり、認証が必要です（Dev Dashboard で発行される JWT トークン、60分 TTL、client credentials 経由で発行）。ChatGPT の shopping mode、Perplexity の commerce layer、Claude のエージェント統合のようなサーバーが、ユーザーが「カナダに発送できる120ドル未満のランニングシューズを探して」と尋ねたときに問い合わせるのがこのサーバーです。個別のストアではなく Catalog MCP にアクセスします。

主なツールは2つです。search_global_products（価格、配送、商品オプションのフィルタ付きでマーチャント横断検索）と、get_global_product_details（Universal Product ID ルックアップで、その SKU を販売しているすべてのマーチャントにまたがる完全なオプション表を返す）です。結果は Universal Product ID（UPID）ごとにまとめられるため、複数ストアにまたがる重複 SKU がエージェントの結果を冗長に埋め尽くすことはありません。

3. Customer Accounts MCP — 記憶するエージェント

Customer Accounts MCP レイヤーは、購入後の体験を最も変える可能性があります。認証済みエージェントに、顧客の注文履歴、アドレス帳、そしてその顧客がアカウントを持つマーチャントにまたがるアカウント状態への読み取りアクセスを与えます。具体的には、買い物客の個人エージェントは Customer Accounts MCP を呼び出して「ヘッドホンの注文はいつ届く？」に答えられ、顧客がサポートフォームに注文番号を入力しなくても返品を開始できます。

大量取引を扱う事業者にとって、これは Tier-1 サポートの大部分をエージェント処理のフローに変えるものです。CX に強くこだわるマーチャントにとっては、顧客を対応するエージェントが自社のものか、Shopify のものか、第三者のものかによって、追い風にも脅威にもなります。初期導入の多くはハイブリッド型です。つまり、マーチャント自身のブランド付きエージェントが、認証済み顧客の代理として Customer Accounts MCP を呼び出します。

Universal Commerce Protocol（UCP）：レイヤーの下にあるレイヤー

4つの MCP サーバーはすべて UCP 準拠です。この頭字語は重要です。Universal Commerce Protocol は、Shopify が公開したオープン標準で、4種類の主体 — プラットフォーム（エージェントとアプリケーション）、マーチャント、認証情報プロバイダー、決済サービスプロバイダー — が、商取引のためにウェブ上で一貫して通信する方法を定義しています。

UCP は Shopify 専用というわけではありません。仕様は公開されており、第三者実装も推奨されています。目標は明確に相互運用可能なレイヤーで、OpenAI が作ったエージェントが Shopify でも BigCommerce でもカスタムプラットフォームでも、個別の統合を毎回書かずにチェックアウトを完了できるようにすることです。

UCP が定義する3つの中核機能は次のとおりです。

1. Discovery — マーチャント横断で検索し、商品詳細を取得し、購入者が欲しいものを見つけるのを助ける。Shopify はこれを Catalog MCP と Storefront MCP で実装しています。

2. Checkout — チェックアウトセッションを作成し、購入者情報を収集し、決済を紐付け、取引を完了する。Shopify はこれを Storefront MCP のカートツールと、埋め込み型およびブラウザベースのチェックアウトの両方をサポートする別個の Checkout Kit の組み合わせで実装しています。

3. Orders — 確定済み取引、フルフィルメントイベント、返金、返品を追跡する。Shopify はこれを Customer Accounts MCP と既存の Admin API で実装しています。

マーチャントへの実際の意味はこうです。Shopify を使っていて Storefront MCP を有効にしていれば（多くのストアでは既定で有効です）、あなたのストアはすでに UCP ベースのエージェントから発見可能です。「ChatGPT と連携する」や「Claude と連携する」は必要ありません。UCP と連携すれば、UCP 準拠のエージェントすべてがアクセスできるようになります。これは1999年に SEO がオーガニック検索のために解決したパターンと同じです。1つの標準、たくさんの利用者。より詳しい仕様解説が必要なら、UCP を詳細に分解した専用ガイドをご覧ください。

今後18か月でマーチャントに起こる変化

確実性が高い順に、3つの具体的な変化があります。

1. エージェント由来のトラフィックが、珍しいものではなく、実際のチャネルになる。 すでに、ChatGPT 由来のショッピングで可視性の高いストアでは、セッションの3〜8%がエージェント参照として流入しています。2026年第4四半期までには、消費者向け AI アシスタントの大半がコマース統合を持つようになるでしょう。ChatGPT で販売する方法ガイドでは、このチャネルに特化した実践的な最適化を解説しています。

2. 購入後はセルフサービスからエージェント対応へ移行する。 注文状況の確認、返品開始、住所変更、割引の追加反映 — Revize や他の購入後アプリが今日担っている Tier-1 業務のすべて — が、エージェントとの会話に包み込まれます。ツール呼び出し自体は同じ API に対して実行され続けますが、ユーザーインターフェースは Web フォームから自然言語チャットへ移ります。根本のワークフローを解決していないマーチャントは、エージェント対応にはなりません。エージェントは壊れた購入後体験を直すのではなく、それを露出させるだけです。

3. 商品データ品質が複利的な ROI になる。 UCP では、商品詳細が、エージェントがあなたの商品を購入者に表示するかどうかを判断する材料になります。タイトル、説明、技術仕様、素材、オプションの組み合わせ、在庫シグナル — すべての項目が、今や人間だけでなくモデルによって評価されます。構造化された商品データが整っているマーチャントは、エージェント探索でも検索でも、データが乏しいマーチャントより上位に出ます。違いは、エージェントには人間のように薄いコンテンツをスクロールして飛ばすことができない点です。薄いデータは単に順位を下げられるだけです。

開発者またはエージェンシーとして AI Toolkit を使う

Toolkit の開発者向け側のセットアップ手順は、この全体の中で最も簡単な部分です。

Claude Code を使っている場合、Shopify プラグインのインストールを1回実行すれば、Dev MCP サーバーが自動で登録されます。それ以降、Claude Code との会話ではいつでも、ドキュメント検索、スキーマのイントロスペクション、shopify store execute をツール呼び出しとして利用できます。プロジェクトごとの設定は不要です。

Cursor を使っている場合、Dev MCP サーバーを Cursor の MCP 設定ファイルに追加します。セットアップは5行の JSON ブロックです。Cursor は次回の再起動でツールを読み込みます。

Gemini CLI を使っている場合、Shopify の GitHub skills リポジトリから skill をインストールする形で連携します。

エージェントスキル（プラグインとは別）は、リポジトリの .agent/skills/ ディレクトリに置く markdown ファイルです。プロジェクトごとのカスタマイズが必要なときに適しています。たとえば、あなたのストアの命名規則、テスト方法、デプロイパイプラインを AI に伝える skill ファイルを用意すれば、生成コードが自動的にあなたの基準に従うようになります。

生産性向上は本物ですが、上限があります。真に得意な作業では、アプリ開発の速度が上がるのを確認しています。たとえば、定型的な GraphQL クエリ、webhook ハンドラのひな形、Polaris コンポーネントのレイアウト、CLI ワークフローの自動化です。ですが、アーキテクチャ判断、複数システムのデバッグ、性能最適化を意味のある形で加速するわけではありません。これらの作業には、Dev MCP が公開していないコンテキストが必要だからです。

自分のストアでエージェント購買を有効にする

ほとんどの Shopify ストアでは、Storefront MCP エンドポイントは既定で稼働しています。30秒でテストできます。

curl -X POST https://YOUR-STORE.myshopify.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

curl -X POST https://YOUR-STORE.myshopify.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

ツール一覧が返ってくれば、あなたのストアはエージェントから到達可能です。これの上にブランド付きエージェント — ストアフロント上の「ショッピングアシスタント」チャットウィジェット — を構築したいなら、Shop Chat Agent テンプレートが最短ルートです。埋め込みチャット UI、MCP クライアント、ストリーミング応答処理、そして LLM として Claude、GPT、Gemini を差し替え可能にしたスターターリポジトリです。

自社エージェントを出したいマーチャント向けの、現実的な90日展開は次のとおりです。

• 1〜2週目: Shop Chat Agent テンプレートをクローンし、プロンプトと UI をブランドに合わせてカスタマイズし、希望する LLM に差し替える。

• 3〜4週目: テストテーマにデプロイし、カート、カタログ、注文状況のフローを内部 QA で検証する。

• 5〜8週目: 一部の顧客セグメントでソフトローンチし、containment rate（人間へのエスカレーションなしでエージェントが解決したサポート問い合わせの割合）を測定する。

• 9〜13週目: 会話ログに基づいてプロンプトを改善し、ブランド固有のポリシーと商品知識を追加し、全トラフィックへ展開する。

私たちがよく見る最大の「やらかし」は、3〜4週目を飛ばすことです。内部 QA は、顧客向け公開時に表面化する問題を見つけます。たとえば、エージェントが実際には扱っていない商品を自信満々に勧める、セール価格を誤って扱う、配送見積もりを間違える、などです。

エージェント型スタックにおける購入後インフラの位置づけ

エージェントは、発見とチェックアウトは上手にこなします。ですが、購入後インフラがエージェントから呼び出せる状態になっていない限り、購入後対応はうまくできません。

注文編集、住所変更、交換、チェックアウト後の割引追加は、買い物客が「注文を変更できますか？」と尋ねたときにエージェントが行う必要のある作業です。Customer Accounts MCP は注文の読み取りアクセスを提供しますが、書き込み側 — 実際の編集 — はどこかで実行されなければなりません。今日の多くのストアでは、それはサポートチケットと Shopify 管理画面の編集として処理されています。これこそが、エージェントが主要な CX 接点になるにつれて、すべてのマーチャントが埋めるべきギャップです。

Revize は、まさにこのために作られた購入後編集レイヤーです。住所変更、バリアント交換、追加注文、キャンセル、割引の追加反映 — そのすべてに対応しており、現在、エージェント対応の編集エンドポイントを整備しています。そうすることで、エージェントが呼び出し始めたときには、基盤となるワークフローがすでに整っている状態にできます。購入後があなたのエージェント戦略の中でどこに位置するか考えているなら、Revize は Shopify App Store にあります。

よくある質問

Shopify AI Toolkit を一言でいうと？

Shopify AI Toolkit は3層のバンドルです。AI コーディングアシスタント向けの Dev MCP サーバー、AI ショッピングエージェント向けの4つの UCP 準拠 MCP サーバー（Storefront、Catalog、Customer Accounts、Dev）、そしてそれらをつなぐ Universal Commerce Protocol 仕様です。

Shopify AI Toolkit は無料ですか？

はい。Dev MCP サーバーはローカルで動作し、認証も費用も不要です。Storefront MCP エンドポイントはすべてのストアで追加費用なしに公開されています。Catalog MCP には、JWT 認証情報を得るための無料の Dev Dashboard アカウントが必要です。Customer Accounts MCP は既存の Shopify 顧客認証を使用します。

MCP を使うには自分のストアが Shopify Plus である必要がありますか？

いいえ。Storefront MCP エンドポイントは、すべてのプランを含むすべての Shopify ストアで既定で有効です。Catalog MCP は、プランに関係なく、Shopify の適格条件を満たす商品を持つマーチャントなら利用できます。Plus が必要なのは、保存済みカタログやカスタムアクセススコープなど、一部の高度なエージェント型コマース機能だけです。

Storefront MCP と Catalog MCP の違いは何ですか？

Storefront MCP は1つのマーチャントのストアに限定され、認証は不要です。買い物客がすでに「どのストアで買うか」を決めているときに使われます。Catalog MCP はマーチャント横断で、JWT 認証が必要です。買い物客がすべての Shopify ストアを横断して探しているときに使われます。

Universal Commerce Protocol とは何ですか？

UCP は、AI エージェント、マーチャント、決済サービスプロバイダー、認証情報プロバイダーが、商取引トランザクションをまたいでどう通信するかを定義する Shopify のオープン仕様です。Discovery、Checkout、Orders の3つを中核機能として定めており、Shopify 以外のプラットフォームでも実装できるよう設計されています。

ChatGPT、Claude、Gemini はすべて Shopify の MCP サーバーを使いますか？

すでに使っています。それぞれのエージェントモードやショッピングモード経由です。Anthropic の MCP 標準で構築されたエージェントは、Shopify の MCP サーバーにネイティブ接続できます。OpenAI の agent SDK は MCP を直接サポートしています。Google の Gemini には、Shopify の開発者ドキュメントで文書化されたブリッジ方式があります。

エージェント購買を有効にするとコンバージョン率は下がりますか？

初期データを見る限り、下がりません。むしろ逆のことが多いです。エージェント経由のトラフィックは意図が高い状態で流入する傾向があります（買い物客はすでにエージェントに欲しいものを伝えているため）。また、Storefront MCP の update_cart ツールは、買い物客にブラウズを求めるのではなく、入力済みのカートを直接届けます。コンバージョンが下がるケースは、エージェントのプロンプトが不十分で、ストアが扱っていない商品を勧めてしまい、買い物客が他へ流れてしまう場合です。

AI Toolkit は顧客データのプライバシーをどう扱いますか？

Dev MCP は開発者のマシン上でローカルに動作し、既定ではストアデータを外部送信しません。Storefront MCP の呼び出しはサーバー間で行われ、固有の PII 露出はありません。Customer Accounts MCP は、エージェントが注文履歴やアカウントデータにアクセスする前に、顧客から明示的な OAuth 同意を必要とします。4つのレイヤーすべてが、Shopify の API ライセンスおよびデータ処理契約の対象です。

競合他社のエージェントは MCP 経由で私のストアで取引できますか？

はい。これが想定された設計です。UCP 準拠のエージェントなら、あなたのカタログを検索し、Storefront MCP エンドポイント経由でチェックアウトを作成できます。取引相手を制限したい場合は、すでに使っているものと同じ制御手段を使います。レート制限、IP ブロック、そして Catalog MCP に対する Shopify のマーチャントレベルのアクセス制限です。ほとんどのマーチャントにとって、ストアフロントをより多くのエージェントに開放することは、売上に対してプラスです。

ストアをエージェント検索結果に表示させるために何かする必要がありますか？

必要なのは、整った商品データです。エージェントは、タイトル品質、説明の関連性、技術仕様の完全性、在庫シグナルに基づいて商品を表示します。これは SEO を動かすのと同じ項目で、モデルによって採点されます。商品ページが薄いマーチャントは、エージェント探索で順位を下げられます。これはエージェント性能を改善するための、最も ROI の高いレバーです。

AI Toolkit と Shopify Functions の関係は？

別のレイヤーで、重なりはありません。Shopify Functions は、チェックアウト時にマーチャントの代わりにカスタムのチェックアウトやカートロジックを実行します。AI Toolkit は、エージェントが外側からストアフロントとやり取りできるようにします。Storefront MCP の update_cart を呼ぶエージェントは、他のカート更新と同じように、そのストアに設定された Functions を発火します。 Functions の移行についてはこちらで詳しく解説しています。

エージェントが私のストアで何をしているか、どうデバッグすればいいですか？

Storefront MCP のリクエストは、他の Storefront API 呼び出しと同じようにログに記録され、管理画面の API リクエストログに表示されます。ブランド付きエージェントに計測を組み込むこともできます。Shop Chat Agent テンプレートには会話ログのフックが含まれており、ユーザーメッセージ、ツール呼び出し、ツール応答を任意のバックエンドに書き込みます。第三者エージェントの場合、見えるのは下流の API 呼び出しだけで、上流のエージェント会話は見えません。

関連記事

• Universal Commerce Protocol（UCP）：Shopify 開発者ガイド — 上で参照した、より詳しい仕様解説です。

• Shopify Agentic Storefronts で ChatGPT に販売する方法 — 最大の消費者向けエージェント向けのチャネル最適化です。

• Shopify Functions 移行チュートリアル（2026年版） — もう1つの主要な2026年移行であり、こちらの補完的なインフラです。

• 2025年の Advanced Shopify Flow ワークフロー — 管理画面内の自動化がエージェントオーケストレーションより優れる場面と、そうでない場面です。