Claude CodeでShopify AI Toolkitをセットアップする方法

2026年4月9日、ShopifyはClaude CodeをShopifyプラットフォームに直接接続するツールキットをオープンソース化しました。これはShopifyに関するトレーニングデータではなく、実際のライブ開発者ドキュメント、GraphQLスキーマ、CLIに接続するものです。この違いは重要です。ツールキットなしでClaudeに製品ミューテーションクエリを尋ねると、8ヶ月前の最善の推測が得られます。ツールキットを使えば、現在検証済みの構文が得られます。

このツールキットはClaude Codeに3つの機能を提供します。Shopify開発者ドキュメントへのリアルタイムアクセス、実行前にすべてのクエリをチェックするローカルGraphQLスキーマ検証、そしてShopify CLIを介してライブストア操作を実行する機能です。この3番目の層、つまり実際の実行が、これを単なるオートコンプリートのアップグレードとは一線を画すものです。Claudeは、製品の作成、メタフィールドの管理、テーマファイルの変更、一括操作の実行を、手動でクエリを1つも書くことなく行うことができます。

接続方法は3つあります。プラグイン（推奨パス、自動更新）、MCPサーバー（単一のターミナルコマンド、直接統合）、手動エージェントスキル（機能を1つずつ有効にしたいチーム向けのきめ細かい制御）です。このガイドでは、これら3つすべてに加え、ほとんどのチュートリアルが省略する認証ステップ、そしてストアでClaude Codeが実行された後に実際に何ができるかについてのセクションをカバーします。

TL;DR

Shopify AI Toolkitの実際の機能

このツールキットは単一のツールではありません。ClaudeをShopifyプラットフォームの3つの異なる層に接続する、スキルファイルとDev MCPサーバーのバンドルです。

ドキュメントへのアクセス。 Claudeは現在のShopify開発者ドキュメントをリアルタイムで検索します。特定の操作の正しいAPI構文について尋ねると、トレーニングのカットオフ時点のキャッシュされた近似値ではなく、Shopifyが今日実際にドキュメント化しているものを返します。

スキーマ検証。 このツールキットはShopifyのGraphQL APIスキーマをローカルにバンドルします。Claudeが生成するすべてのクエリは、実行前に実際のスキーマと照合してチェックされます。これにより、プレイグラウンドでは通るクエリが、フィールドの名前変更や非推奨化のために本番環境で失敗するという類のバグが排除されます。

ストアでの実行。 Shopify CLIを介して、Claudeはライブ操作を実行できます。製品の作成と更新、メタフィールドの管理、テーマファイルの変更、一括操作の実行などです。これはドラフトキューなし、元に戻す機能なしで即座に実行されます。Shopifyの公式AI Toolkitドキュメントによると、現在のリリースではロールバックはサポートされていません。すべての操作をまず開発ストアでテストしてください。

Claude CodeでShopify AI Toolkitをセットアップする方法

ステップ1と3-4は、どのインストール方法を選択しても適用されます。ステップ2a、2b、2cは3つのインストールパスです。いずれか1つを選択してください。

ステップ1：前提条件の確認

何よりもまず、Node.js 18以降が必要です。現在のバージョンを確認してください：

出力がv18.0.0未満の場合は、続行する前にnodejs.orgからアップデートしてください。Claude Codeはすでにインストールされている必要があります。

ステップ2a：プラグイン経由でのインストール（推奨）

プラグインはすべてを1つのインストールにまとめ、Shopifyが新しい機能をリリースするたびに自動更新します。Claude Codeのチャットセッションを開き、これら2つのコマンドを順番に実行してください：

これはほとんどの開発者にとって最も手間のかからない方法です。編集する設定ファイルも、手動の更新手順もありません。

ステップ2b：MCPサーバー経由でのインストール

1つのターミナルコマンドで、Claude CodeをShopify Dev MCPサーバー内のすべてのツールに接続します：

これを実行した後、Claude Codeを再起動してください。Windowsでは、デフォルト設定で接続エラーがよく発生します。代わりにcmdをエントリポイントとして使用します。Claude MCP設定ファイルに手動で追加してください：

テレメトリー（サーバーはデフォルトでインストルメンテーションデータを送信します）をオプトアウトするには、envブロックを追加します：

ステップ2c：手動エージェントスキルによるインストール

手動スキルを使用すると、機能を一度に1つずつ有効にできます。利用可能なすべてのスキルをインストールするには：

単一のスキル（たとえば、GraphQL Admin APIスキルのみ）をインストールするには：

利用可能なスキルを確認するには、GitHubの全スキルリストを参照してください。注意：手動でインストールしたスキルは自動更新されないため、新しいバージョンを自分でプルする必要があります。

ステップ3：ストア操作のための認証

ドキュメント検索とスキーマ検証は、インストール後すぐに機能します。ストア操作には、追加のステップが1つ必要です。

Shopify CLIのログインコマンドを実行します：

これによりブラウザウィンドウが開き、Shopify Partnerアカウントに対してClaude Codeを認証します。2026年1月1日以降、新しいShopifyアプリは静的なアクセストークンではなくOAuthクライアント認証情報を使用します。CLIはこの交換を自動的に処理します。トークンは約24時間有効で、有効期限が切れる前に更新されます。

本番ストアで何かをテストする前に、Partnerアカウントに実行予定の操作に適した権限があることを確認してください。

ステップ4：接続の確認

正確に回答するために最新のドキュメントを必要とする質問をClaudeに尋ねます：

「Shopify Admin APIで商品のタイトルを更新するための正しいGraphQLミューテーションは何ですか？」

ツールキットがアクティブな場合、Claudeは現在のフィールド名で検証済みのクエリを返します。「トレーニング以降に変更された可能性があります」のような曖昧な表現を使ったり、非推奨のフィールドを生成したりする場合、MCP接続が読み込まれていません。Claude Codeを再起動し、設定を確認してください。

どのShopify AI Toolkitセットアップ方法を使用すべきか？

ほとんどのユースケースでは、プラグインが適切な選択です。すでにMCP設定をコードとして管理している場合や、初日からテレメトリーを制御したい場合は、MCPサーバーを選択する価値があります。新しいツールの機能にデプロイ前の正式なレビューが必要な場合は、手動スキルが理にかなっています。

Claude CodeがあなたのShopifyストアでできること

ツールキットが接続されると、Claude Codeは、通常なら何時間もかかる手動のAPI作業をこなすことができます。実際にどのように機能するかを見てみましょう。

商品説明の一括生成

商品カテゴリ、ターゲットオーディエンス、ターゲットとするSEOキーワードを記述します。Claudeは現在のAdmin APIの商品ミューテーションを使用して、各商品に最適化されたコピーを生成し、変更を一度に適用します（1回のセッションで数百のSKUにわたって）。公開前に出力をレビューできます。

これは、新しい商品カテゴリを立ち上げる際や、ブランドリフレッシュ後に説明を書き直す際に特に役立ちます。Claudeは、各レコードを手動で編集することなく、カタログ全体で一貫したトーンを維持します。

プロンプト：私のストアでタイトルに「xxx（例：セラミック）」を含むすべての商品を読み取ってください。各商品について、北米の家族に適した温かみのあるトーンで約150語のSEOに最適化された商品説明を生成し、ストアに直接説明を更新してください。

在庫アラートと調整

ClaudeはinventoryLevelsコネクションを使用してすべてのロケーションの在庫レベルをクエリし、設定されたしきい値を下回るSKUにフラグを立て、それらを修正するために必要なinventoryAdjustQuantitiesミューテーションを下書きすることができます。あなたがルールを定義すれば、Claudeがチェックを実行し、レビューのために調整を準備します。

複数の倉庫やフルフィルメントパートナーを持つShopifyストアにとって、これにより毎日の手動監査が30秒のクエリに変わります。

プロンプト：在庫が10個未満のすべての商品をクエリし、タイトルの先頭に「[在庫僅少]」を追加してください。同時に、商品あたりのコストが販売価格よりも高いすべての商品をリストアップしてください。

テーマコードのデバッグ

レイアウトの問題や視覚的なバグを説明します。Claudeは現在のテーマファイルを読み取り、問題の原因となっているLiquidコードを特定し、テーマスキーマに対して修正をチェックして適用します。スキーマ検証ステップにより、ライブストアが壊れる前に、セクション設定の不一致を検出します。

まず開発ストアから始めます。バグを説明し、Claudeに特定させ、提案された修正を確認してから適用します。Claudeは、元のコードに問題があった理由も説明できるため、同じ問題の再発を防ぐのに役立ちます。

プロンプト：現在のテーマのcheckout.liquidファイルを確認し、カスタムフィールド「gift_message」に関連するコードを特定し、最新バージョンでレンダリングに失敗する理由を調べてください。

一括SEO最適化

Claudeは、コレクション全体のSEOタイトルとメタディスクリプションを生成し、メタフィールドのミューテーションを介して更新し、書き込みが完了したことを確認できます。これらすべてを1回のセッションで行えます。ターゲットキーワードのリストとブランドボイスのガイドラインを与えれば、コピーとAPI呼び出しをまとめて処理します。

これは、スプレッドシートベースの一括エディタよりも信頼性があります。なぜなら、Claudeは各ミューテーションを実行する前に現在のスキーマに対して検証するからです。非推奨のフィールドは、サイレントに失敗するのではなく、クリーンに失敗します。

プロンプト：メタディスクリプションがないすべての商品を見つけてください。商品タイトルと説明に基づいて160文字以内のメタディスクリプションを生成し、クリックを促進するための主要キーワードを含め、バッチで更新してください。

競合他社の価格監視と対応

Claudeは、ターゲットに対する自社の価格を監視するためのGraphQLクエリロジックとShopify Flowトリガー設定を生成し、対応して価格を調整するためのproductVariantsBulkUpdateミューテーションの一括ドラフトを作成できます。実際の競合他社データについては、サードパーティの価格インテリジェンスツールを接続します。Claudeは、どの商品を、どれだけ、どの順序で更新するかという、Shopify側の対応を処理します。

大規模なカタログと動的な価格設定ルールを持つストアにとって、これは何時間もの手動での価格改定を、説明可能なワークフローに置き換えるものです。

プロンプト：毎日午前10時に競合他社Aと競合他社Bの「Vintage Lamp」製品の価格を確認してください。もし彼らの価格が私の価格より10%以上安い場合、PRICE + 日付の形式で期間限定の割引コードを自動生成し、割引率を競合他社より5%低く設定し、私にメールで通知してください。

安全なテーマの変更

テーマを変更する前に、Claudeはどのセクションがテーマスキーマを介してカスタマイズ可能で、どのセクションがLiquidにハードコードされているかを確認します。どの編集がShopifyテーマエディタを通じて元に戻すことができ、どの編集がコードの変更を必要とするかを教えてくれるので、何かを触る前にロールバックの選択肢を理解できます。

これは重要です。なぜなら、CLIからのテーマ変更は、テーマエディタと同じバージョン履歴を経ないからです。Claudeはその違いを指摘し、各変更に対してどのアプローチがより安全かを提案します。

カスタマーサービスオートメーション

Claude Codeは、定型応答テンプレートのドラフト作成、注文ステータス通知のためのShopify Flowオートメーションの構築、一般的な顧客クエリタイプのためのWebhookハンドラのセットアップを、すべてAdmin APIを通じて、ターミナルを離れることなく行うことができます。

営業時間外に発生するライブの電話やチャット（深夜の注文に関する質問、土曜日の返金リクエストなど）については、SolveaがShopifyに直接接続し、人間を介さずにこれらの会話を処理します。注文に関する問い合わせを解決し、返品リクエストを処理し、状況に応じて人間のエージェントにエスカレーションします。Ankerでは現在、カスタマーサービス業務の70%をSolveaが処理しており、週に150時間以上のエージェントの時間を節約しています。Claude Codeがオートメーションのセットアップを処理し、Solveaがライブの顧客との会話を処理します。

データレポートの自動化

Claudeは、注文分析、顧客生涯価値、在庫回転率のためのカスタムGraphQLクエリを作成し、その出力をGoogleスプレッドシートへの直接エクスポート用、またはレポートパイプライン用の構造化JSONとしてフォーマットできます。必要な指標と期間を説明すれば、Claudeがクエリを生成し、実行して、データを返します。

これは、単一のクエリで複数のリソースからのデータを組み合わせることができるため、Shopifyの組み込みレポートよりも柔軟です。Claudeはまた、Shopify Flowトリガーを使用して定期的なクエリをスケジュールすることもできるので、毎週同じクエリを手動で実行するのではなく、定期的に更新された数値を得ることができます。

プロンプト：先週（月曜日から日曜日）のストアデータレポートを生成してください。内容は以下の通りです。

総売上、注文数、平均注文額（先々週の成長率と比較）

ベストセラー商品トップ10

トラフィックソーストップ5

返品率と返金額

コンバージョンファネル（訪問 → カートに追加 → チェックアウト → 支払い）

フォーマット要件：

コアデータを表で表示

3〜5つの主要なインサイトをリストアップ

来週に向けた2〜3つの推奨アクションを提示

まとめ

Shopify AI Toolkitは、Claude CodeがShopifyストアでできることを変えます。もっともらしいコードの生成から、実際のストアに対する検証済みAPI呼び出しの実行まで。セットアップはどの方法でも10分未満で完了し、プラグインが最も摩擦の少ない方法であり、MCPサーバーが最も多くの設定制御を提供します。

ほとんどのガイドが省略するステップ：認証。ドキュメント検索とスキーマ検証はインストール後すぐに機能しますが、ストア操作を実行するには、その前にshopify auth loginが必要です。まずそれを完了させ、開発ストアで初期テストを実行し、実行モデルの動作を理解したら本番環境での操作に進んでください。元に戻す機能はありません。

FAQ

Shopify AI ToolkitはWindows上のClaude Codeで動作しますか？

はい、ただしMCPサーバーの設定では、コマンドエントリポイントとしてcmdが必要です。MCP設定ファイルで\"command\": \"cmd\"と\"args\": [\"/k\", \"npx\", \"-y\", \"@shopify/dev-mcp@latest\"]を使用してください。プラグインのインストール方法（/plugin marketplace addと/plugin install）は、すべてのオペレーティングシステムで同じように機能します。

AI Toolkitを使用するには、有料のShopifyプランが必要ですか？

ツールキット自体は無料でオープンソースです。ShopifyのAPIに接続しますが、これにはパートナーアカウントまたはアクティブなストアが必要です。ストア操作は既存のAPIアクセスを使用するため、追加のプラン階層は必要ありません。

Shopify AI ToolkitはDev MCPサーバーと同じものですか？

厳密には違います。Dev MCPサーバー（@shopify/dev-mcp）は、より広範なAI Toolkitの一つのコンポーネントです。完全なツールキットには、エージェントスキルファイルも含まれており、プラグインのインストールをサポートしています。MCPサーバーは、プラグインレイヤーをバイパスする直接的な統合パスです。

Claude Codeは本番稼働中のストアに変更を加えることができますか？

はい、そしてそれが主なリスクです。ストア実行操作は、ドラフトキューやロールバックのサポートなしに即座に実行されます。本番環境で実行する前に、すべての新しい操作タイプを開発ストアでテストしてください。Shopify CLIのstore execute機能には、コマンドとAPI呼び出しの間に確認ステップがありません。

プラグインとMCPインストールの違いは何ですか？

プラグインは、すべてのスキルファイルとMCP接続を、自動更新される1つのインストールにバンドルします。MCPインストールでは、プラグインレイヤーなしでDev MCPサーバーのツールに直接アクセスできます。これは、config-as-codeで接続を管理したい場合や、サーバー環境をカスタマイズする必要がある場合に便利です。どちらの方法でも、Claude Codeは最新のShopifyドキュメントとスキーマ検証にアクセスできます。