Shopify Admin MCP

A1 Shopify Admin MCP は、Admin API（GraphQL）を介してAIアプリをShopifyストアの管理画面に接続します。商品と価格、注文、顧客、在庫、プロモーションコードなどを自然言語で扱えます。

サーバーは1つのストアに固定されています。ドメインは設定で指定され、トークンはカスタムアプリのAdmin APIアクセストークンです。どのツールも他のストアにアクセスすることはできません。

• 16のツール。 ストア、商品・バリアント、注文、顧客、ロケーションと在庫、ディスカウントに加えて、それ以外のすべてに対応する任意のGraphQLクエリも用意されています。

• 正直なHTTP 200。 Shopifyのミューテーションは失敗しても200を返します。サーバーはuserErrorsを読み取り、拒否を理由がわかるエラーに変換します。dataオブジェクトのない200応答（空・途中で切れている・Instagramではない）も、空の結果ではなくエラーにします。

• 取り返しのつかない操作を可視化。 注文のキャンセル（返金・返品の判断を含む）と任意のGraphQLリクエストはdestructiveとしてマークされます。

• コストバケットを管理。 各応答にはcostが含まれ、そのクエリのコストとGraphQLバケットの残りポイントがわかります。

まず、データを読むだけのテキストから始めましょう：

ストアの最新注文と在庫のあるトップ商品を表示してください。

サーバーを接続 · シナリオを見る · 技術ドキュメントを開く

動作を1分で確認

あなた: ストアの最新注文と在庫のあるトップ商品を表示してください。

アシスタント: 注文をステータスと金額付きで、商品を価格と在庫付きで表示します。何も変更されません。

あなた: プロモコードSUMMERで20%オフのディスカウントを2週間分リ

アシスタント: これから作成するプロモコードのパラメータ（コード、割引率、期間、利用枠組み）を表示し、確認を求めます。

あなた: 確認しました。

• クイックスタート

• 任せられること

• 何が変わり得るか

• アクセスの取得

• 設定

• データ、制限、バックグラウンド動作

• 技術ドキュメント

• サポート

クイックスタート

必要なのはNode.js 20以上、my-store.myshopify.comという形式のストアドメイン、カスタムアプリのAdmin APIアクセストークン（shpat_…）です。アプリの作成にはストアオーナー権限、またはアプリ開発者のスタッフ権限が必要です。

1. アクセスを取得します。

2. サーバーをAI アプリに追加します。

3. 上記の安全な最初のクエストを送信します。

Settings → Plugins → MCP servers で Add server をクリックし、SHOPIFY_STORE_DOMAIN と SHOPIFY_ACCESS_TOKEN を付けて npx -y mcp-shopify-admin@latest を追加してください。

codex mcp add shopify-admin \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  -- npx -y mcp-shopify-admin@latest
codex mcp list

Codex MCPドキュメント

claude mcp add \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  --transport stdio --scope user shopify-admin \
  -- npx -y mcp-shopify-admin@latest
claude mcp list

Claude Code MCPドキュメント

Settings → Developer → Edit Config で開き、追加してください。

{"mcpServers":{"shopify-admin":{"command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}}

Edit Config がない場合は、macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json を編集します。Claude Desktop MCPドキュメント

{"mcpServers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}} を、macOS/Linux では ~/.cursor/mcp.json、Windows では %USERPROFILE%\.cursor\mcp.json に追加します。Cursor MCPドキュメント

MCP: Open User Configuration を実行し、追加してください。

{"servers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"${input:shopify_store_domain}","SHOPIFY_ACCESS_TOKEN":"${input:shopify_access_token}"}}},"inputs":[{"type":"promptString","id":"shopify_store_domain","description":"Домен магазина my-store.myshopify.com"},{"type":"promptString","id":"shopify_access_token","description":"Admin API access token (shpat_…)","password":true}]}

MCP: List Servers コマンドでサーバーを確認できます。VS Code MCPドキュメント

任せられること

• 今週の注文と、支払い状況・発送状況を表示する。

• 在庫のない商品を探し、選択したバリアントの価格を上げる。

• 新商品を下書きで登録し、説明を入力する。

• 棚卸後に実在庫を設定する。

• 〜回の利用回数制限付きのセール用プロモコードを作成する。

• メールから顧客を探し、その最近の注文を表示する。

何が変わり得るか

注文の作成、出荷の実行、顧客の変更、商品の販売チャンネルへの公開、オブジェクトの削除はツールセットには含まれません。必要な場合は、graphql_request で明示的に確認して行ってください。

アクセスの取得

1. ストアの管理画面を開きます。Settings → Apps and sales channels → Develop apps（アプリ開発がオフィルになっている場合は有効にします）。

2. アプリを作成し、Configuration管理タブで必要なAdmin APIアクセススコープを付与します。read_products/write_products、read_orders、read_customers、read_locations/write_inventory、read_discounts/write_discounts — シナリオに合わせて。

3. アプリをインストールし、API credentials タブで Admin API access token（shpat_…、一度だけ表示されます）をコピーします。

4. ドメインとトークンをそれぞれ SHOPIFY_STORE_DOMAIN と SHOPIFY_ACCESS_TOKEN として渡します。

トークンは静的で、ストアに紐付いています。パスワードと同じように扱ってください。後からアプリにスコープを追加すると、Shopifyが新しいトークンを発行するので、環境変数を更新してサーバーを再起動してください。安全に試すには開発ストアが便利です。

設定

データ、制限、バックグラウンド作業

• GraphQLコストバケット。 各クエリは複雑さに応じてポイントを消費し、バケットは毎秒回復します。最大250頁の first 1回は、細かいクエリを数列送るよりも効率的です。サーバーは各回答に cost を表示します。

• 一時エラー。 THROTTLED はバケットの計算に基づく待機時間で自動的に再試行されます。ミューテーションは、ネットワークエラーや5xxエラーでは再試行されません。変更を2回適用させないためです。

• 60日より以前の注文 には read_all_orders スコープが必要です。これはShopifyに申請して取得します。スコープがないと、過去の注文は単に取得されません。

• 常時監視はありません。 サーバは呼び出されたときだけ動作します。AI アプリがスケジュールジョブに対応していれば、定期的に注文や在庫を確認できます。

• 匿名テレメトリ。 シークレット、ストアデータ、引数、プロンプトは含まれません。無効にするには： ASKADS_TELEMETRY=0。

技術ドキュメント

• MCP機能カタログ — 各ツールのユーザータスク別のページ。

• すべてのツールとパラメータ

• 開発ドキュメント

• 公開ドキュメント

• Shopify Admin API (GraphQL) ドキュメント

サポート

エラーを見つけた、またはシナリオが足りない？Issue を作成するか、Telegram でお知らせください。