shopify-multi-store

Shopify Multi-Store MCP

1 つの MCP サーバーで、すべての Shopify ストアに対応します。

Claude、ChatGPT、Codex、Cursor、VS Code、その他の MCP クライアントから、複数の Shopify ストアを横断して検索、比較、レポート作成を行い、保護された更新を実行できます。

デモ · クイックスタート · レポート · AI クライアント · セキュリティ

バージョン 2.0

ローカルで実行することも、チーム向けに 1 つのサーバーをホストすることもできます。各ユーザーが自分の Shopify スタッフアカウントでサインインし、Claude、ChatGPT、Codex、または任意のリモート MCP クライアントから接続します。各ユーザーが実行できる操作は、Shopify 独自のスタッフ権限によって決まります。ガイド付きの Admin ワークフロー、ShopifyQL レポート、スキーマ検証、あらゆる Admin ミューテーションに対応する汎用アクション機能を備えています。 機能の網羅状況と受け入れ要件をご覧ください。 Shopify と ChatGPT の完全な互換性はまだ検証されていません。

動作を見る

このデモでは、サンプルストアとサンプルデータを使用しています。サーバーは、実際の各ストアの認証情報を個別に保持します。

クイックスタート

サーバーをインストールし、ストアを接続して、ヘルスチェックを実行します。

npm install --global shopify-multi-store-mcp-server
shopify-multi-store setup
shopify-multi-store doctor

Claude Code ユーザーは、次の 1 つのコマンドでサーバーを追加できます。

claude mcp add shopify-multi-store -- npx -y shopify-multi-store-mcp-server start

各ストアには固定のエイリアスと個別の安全な認証情報が割り当てられます。ストアに対するすべての操作で、そのエイリアスが必要です。

利用できる機能

このサーバーとShopify Dev MCP

この2つのサーバーは、それぞれ異なる課題を解決します。エージェントがShopifyの参考資料とストアへのアクセスの両方を必要とする場合は、両方を使用してください。

Shopify Dev MCPは、エージェントによるShopifyコードの作成や調査を支援します。このサーバーは、選択したストアに対して承認済みの操作を実行します。

すぐに使えるレポート

shopify_reportは、選択したストア全体に対して1つの読み取り専用レポートを実行します。reportには次のいずれかを指定します。

ストア間で商品を検索するには、resource: "products"とstoresを指定してshopify_searchを使用します。

次のようなプロンプトを試してください。

• 「接続されているすべてのストアのポートフォリオスナップショットを表示してください。」
• 「過去30日間の注文と現在の注文金額を要約してください。通貨は分けてください。」
• 「小売店と卸売店全体で、在庫が少ない商品、在庫切れの商品、在庫数がマイナスの商品を表示してください。」
• 「このストアでは在庫切れですが、別のストアでは在庫がある商品を表示してください。」
• 「すべてのストアからSKU A123を見つけ、ステータス、価格、在庫を比較してください。」
• 「すべてのストアで、プロテイン関連の商品を検索してください。」
• 「経過時間別に、2日以上前の未処理の注文を表示してください。」
• 「あるストアでは公開中ですが、別のストアでは欠落しているか下書きになっている商品を見つけてください。」
• 「これらのストアの価格差と重複SKUを見つけてください。」
• 「小売店と卸売店全体で、SKU A123とB456の在庫を比較してください。」
• 「3つのストアについて、過去7日間の未処理の注文を一覧表示してください。」
• 「カタログの健全性を監査し、SEOまたはメディアデータが欠落している商品を表示してください。」
• 「これらのストアの公開中のカタログと注目のコレクションを比較してください。」

AI クライアントを接続する

このサーバーは、ローカルの stdio MCP サーバーに対応したクライアントで動作します。クライアントがエージェントスキルに対応している場合、ツールの選択が改善されます。

claude mcp add shopify-multi-store -- npx -y shopify-multi-store-mcp-server start

mkdir -p ~/.claude/skills/shopify-multi-store
cp skills/shopify-multi-store/SKILL.md ~/.claude/skills/shopify-multi-store/SKILL.md

{
  "mcpServers": {
    "shopify-multi-store": {
      "command": "npx",
      "args": ["-y", "shopify-multi-store-mcp-server", "start"]
    }
  }
}

{
  "servers": {
    "shopify-multi-store": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "shopify-multi-store-mcp-server", "start"]
    }
  }
}

チーム向けにホストする

自分のコンピューターでローカルに使う方法（上記）が標準です。ホスティングは任意です。共有サーバーが必要な人がサーバーを実行し、チームは、どのプランでも、普段使っている AI アプリ（Claude（個人用カスタムコネクター）、ChatGPT、Codex、Claude Code、Cursor、VS Code、Gemini CLI、Windsurf、またはリモートサーバーに対応した任意の MCP クライアント）から接続できます。

各自が自分の Shopify スタッフアカウントでサインインし、すべての呼び出しはその人自身の Shopify 権限で実行されます。サーバー上にロールやポリシーファイルは必要なく、各自ができる操作は Shopify が決定します。Shopify のトークンはサーバー上で暗号化されて保管されます。再接続は最大でも1日に1回で、すべてのストアをワンクリックで再接続できます。すべてのツール呼び出しは監査されます。

共有サーバーを必要とする人がセルフホストする方法は2つあります。

• Cloudflare Workers： 手順については、docs/DEPLOY-CLOUDFLARE.md をご覧ください：Shopify アプリを作成し、4つのシークレットを設定してデプロイし、AI アプリに MCP URL を追加します。
• 任意のサーバー：shopify-multi-store serve（または付属の Dockerfile）を実行し、https://<host>/mcp を共有します。

クライアントごとの手順はAI アプリから接続する、セットアップは docs/HOSTED.md、ユーザーごとのアクセスと汎用アクションツールについては docs/ACTIONS.md をご覧ください。

ストアの認証

認可コードのセットアップでは http://127.0.0.1:3456/oauth/callback を使用します。先に、許可されたリダイレクト URL として追加してください。

認可コードのデフォルトのスコープは読み取り専用です。タスクに必要な Admin API スコープのみを付与してください。

最初のストアを接続する

各ストアには、エイリアス（main のような小文字、数字、ハイフン）と、ストア管理画面の「設定」>「ドメイン」に表示される固定の *.myshopify.com ドメインが必要です。認証情報は、Admin API へのアクセス方法によって異なります。Shopify では現在、新しいアプリは Dev Dashboard で作成します。ストア管理画面で作成したカスタムアプリは、すでに存在する場所で引き続き動作します。

Dev Dashboard アプリの場合（新規セットアップ）：

1. Dev Dashboard（dev.shopify.com）を開き、「Apps」>「Create app」を選択して、名前を付けます（例：「Multi-Store MCP」）。
2. バージョンを作成します。「Access scopes」で必要なスコープを追加します。read_products,read_orders,read_inventory,read_locations,read_customers で読み取りツールを利用できます。ツールの全機能を利用する場合は、node "$(npm root -g)/shopify-multi-store-mcp-server/scripts/print-scopes.mjs" --full を実行して全リストを表示し、アプリで承認されていないスコープを削除してください。認可コード方式を使う場合は、リダイレクト URL http://127.0.0.1:3456/oauth/callback も追加します。
3. バージョンをリリースしてから、Dev Dashboard でストアにアプリをインストールし、スコープを承認します。
4. アプリの設定からクライアント ID とクライアントシークレットをコピーします。
5. shopify-multi-store oauth を実行します。ストアがアプリと同じ Shopify 組織内にある場合は client-credentials を選択し、それ以外の場合は authorization-code を選択します（承認用のブラウザーウィンドウが開きます）。エイリアス、*.myshopify.com ドメイン、クライアント ID、クライアントシークレットを入力します。クライアント認証情報を使う場合、サーバーがトークンを自動で取得・更新します。

ストア管理画面で作成したカスタムアプリの場合：

1. ストア管理画面で「設定」>「アプリ」（一部の管理画面では「アプリと販売チャネル」）>「アプリを開発」を開き、アプリを選択します。管理画面で引き続き作成できる場合は、そこでアプリを作成できます。
2. 「設定」で、Admin API に必要なスコープを設定し、アプリをインストールします。
3. 「API 認証情報」で、Admin API アクセストークンを表示します（shpat_ で始まるトークンで、Shopify は一度だけ表示します）。
4. shopify-multi-store setup を実行し、エイリアス、*.myshopify.com ドメイン、トークンを入力します。

次に shopify-multi-store doctor を実行してすべてのストアを確認し、追加するストアごとに同じ手順を繰り返します。シークレットはオペレーティングシステムの認証情報ストアに保存され、設定ファイルには保存されません。

ストアを管理する

shopify-multi-store list
shopify-multi-store doctor
shopify-multi-store remove store-alias

shopify-multi-store import /absolute/path/to/stores.json

サーバーは29個のツールを公開しています。

読み取り専用の操作は並列で実行できます。ミューテーションは、選択したストアに限定されます。

すべてのガイド付き書き込みツールは、デフォルトで dryRun: true に設定されています。これにより、何も変更せずに変更前後（または作成予定）のプレビューを返します。ユーザーが対象のストアと変更内容を正確に承認した後、適用するには dryRun: false を指定してください。ツールはその後、結果を読み取って確認します。商品、注文、顧客のタグは addTags と removeTags で変更します。replaceTags はすべてのタグを置き換え、プレビューには削除予定のタグが一覧表示されます。書き込み結果がサイズを理由に破棄されることはありません。大きな結果は、ステータス、件数、適用されなかったすべての項目を残して切り詰められます。

shopify_graphql_mutation と shopify_run_action は拒否リストに登録されたミューテーションを拒否します。また、引数によってのみ破壊的となるもの（商品ステータスに ARCHIVED を指定する場合など）を含む破壊的なミューテーションでは、ミューテーション名を confirm に設定する必要があります。

汎用アクションツール

3つのツールで、Shopify Admin API のすべてのミューテーション（API 2026-04 では514件）にアクセスできます。これには、専用ツールがない483件も含まれます。

認証情報を発行するミューテーションや、アプリ自体の課金を変更するミューテーションは、拒否リストによってブロックされます。スコープ一式を取得するには、node scripts/print-scopes.mjs --full を実行してください。実用的な例や、サードパーティ製アプリではできないことについては、docs/ACTIONS.md を参照してください。

Shopify コンパニオンスキル

Shopify 公式の shopify スキルをインストールします。

shopify-multi-store install-shopify-skills

このコマンドは、検出したすべての対応エージェントにスキルをインストールします。エージェントを1つ選ぶには、--agent <name> を指定します。たとえば、--agent claude-code のように指定します。

shopify スキルは、ルーティングテーブルを備えた1つのスキルです。admin トピックでは、Shopify のドキュメントを検索し、カスタムの Admin GraphQL オペレーションを検証します。shopifyql トピックでは、売上、収益、注文、コンバージョン、トレンドを分析します。Shopify の toolkit 2.0.0 では、以前の shopify-admin スキルと shopify-shopifyql スキルがこの1つのスキルに統合されました。また、toolkit の ucp スキル（ショッピング用 CLI）は、このインストールには含まれません。

Shopify が再びスキルの名前を変更した場合、コマンドはステータス1で終了し、toolkit に含まれるスキルを表示して、名前を指定してインストールするための npx skills add コマンドを示します。何もインストールしていないのに成功を報告することはありません。

ストアの選択、認証情報、実行、ミューテーションの認可は、引き続きこのサーバーが管理します。Shopify のスキルスクリプトは、デフォルトで使用状況のテレメトリーを送信します。

テレメトリーを無効にするには、OPT_OUT_INSTRUMENTATION=true を設定してください。

この統合では、Shopify 公式の Shopify AI Toolkit を使用しています。また、Shopify Admin Skills の有用なパターンも取り入れています。

セキュリティモデル

シークレットがメインの設定ファイルに保存されることはありません。

設定には、エイリアス、ドメイン、API バージョン、シークレットではない OAuth クライアント ID が保存されます。デフォルトのパスは ~/.config/codex-shopify-multi-store/stores.json です。

パス内および認証情報ストアのサービス名として使われている codex-shopify-multi-store は、プロジェクトの初期バージョンから引き継がれた名前です。既存のインストール環境でストアと認証情報を引き続き利用できるよう、この名前を維持しています。このサーバーが Codex 専用であるという意味ではありません。

別の設定パスを使うには、SHOPIFY_MULTI_STORE_CONFIG を設定してください。

• アクセストークン、OAuth クライアントシークレット、.env ファイル、認証情報を含む設定ファイルは、絶対にコミットしないでください。
• タスクに必要な Shopify Admin API スコープのみを付与してください。
• ミューテーションを実行する前に、必ず対象のストアを確認してください。
• 脆弱性の報告については、SECURITY.md をお読みください。

Linux で認証情報を保存するには、GNOME Keyring や KWallet などの Secret Service プロバイダーが必要です。

その他のインストール方法

グローバルインストールせずにヘルスチェックを実行します。

npx -y shopify-multi-store-mcp-server doctor

GitHub から直接インストールします（npm はサーバーをビルドする prepare スクリプトを実行します）。

npm install --global github:alex-brecher/shopify-multi-store

開発

git clone https://github.com/alex-brecher/shopify-multi-store.git
cd shopify-multi-store
npm ci
npm test
npm run test:live
npm pack --dry-run

ライブテストでは、設定済みのストアを使用して、読み取り専用の Shopify Admin API 呼び出しを実行します。

ライセンス

MIT

changelog、貢献ガイド、セキュリティポリシー、ディレクトリへの登録ガイドをお読みください。