Shopify Admin MCP

Shopify Admin MCP

英語 | Русский

A1 Shopify Admin MCP は、Admin GraphQL API を通じて AI アプリケーションを 1 つの Shopify ストアに接続します。商品、注文、顧客、在庫、割引、ショップデータについて自然な言葉で質問すると、アシスタントがサーバーの既成ツールを使って結果を表示します。

• サーバーごとに 1 つのストア。 ストアのドメインと認証情報は設定から取得されます。ツールで別のストアに切り替えることはできません。
• トークンは常に最新です。 Shopify Dev Dashboard アプリのクライアント ID とシークレットをサーバーに渡すと、サーバーが Admin API トークンを自動発行してメモリ内だけに保持し、有効期限の 24 時間前に再発行します。以前のカスタムアプリで発行した既成トークンも使用できます。
• 用途を絞った 16 個のツール。 ショップデータ、商品、注文、顧客、ロケーション、在庫、割引を読み取り、対応するレコードを作成または更新できます。
• GraphQL のエラーを通知します。 Shopify はミューテーションの失敗時に HTTP 200 を返すことがあるため、サーバーは userErrors を確認し、空または不正な GraphQL レスポンスを拒否します。
• コストを意識したレスポンス。 各結果には GraphQL のコストバケットが含まれ、リクエストのコストと次の呼び出しに現在利用できるポイントを確認できます。
• リスクを明確に表示します。 読み取りは読み取り専用です。商品、価格、在庫、割引の書き込みは明示され、注文のキャンセルと任意の GraphQL は破壊的操作として表示されます。

まずは読み取り専用のリクエストから始めましょう。

最新の注文と、現在在庫のある商品を表示してください。

サーバーに接続する · ユースケースを見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： 最新の注文と、現在在庫のある商品を表示してください。

アシスタント： 最近の注文をステータスと合計金額とともに表示し、その後、価格と在庫を含む商品を表示します。変更は行われません。

あなた： 2 週間有効な SUMMER という 20% 割引コードを用意してください。

アシスタント： 作成予定のコード、割引率、日付、制限を表示し、作成前に確認を求めます。

あなた： 確認します。

目次

• クイックスタート
• できること
• Shopify で変更できる内容
• アクセス権の取得
• 設定
• データ、制限、バックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20 以降、my-store.myshopify.com のようなストアドメイン、Admin API の認証情報が必要です。推奨されるのは、Shopify Dev Dashboard アプリのクライアント ID とシークレットです。サーバーがこれらを使ってアクセストークンを取得し、そのトークンを常に最新の状態に保ちます。この権限付与で Shopify が発行するトークンは 24 時間で期限切れになるため、これは重要です。アプリとストアは同じ Shopify 組織に属している必要があります。

1. アクセス権を取得し、アプリのクライアント ID とクライアントシークレットを準備します。
2. MCP サーバーを AI アプリケーションに追加します。
3. 冒頭のセクションにある安全なリクエストを送信します。

サーバーは npx を介した stdio でローカル実行されます。ブラウザーのみで利用する ChatGPT および Claude のウェブセッションから、ローカルの stdio プロセスを直接起動することはできません。

以下の各スニペットでは、この 2 つの認証情報を使用しています。ストアに管理者が作成したカスタムアプリの既成トークンが残っている場合は、SHOPIFY_CLIENT_ID と SHOPIFY_CLIENT_SECRET を単一の SHOPIFY_ACCESS_TOKEN に置き換えてください。詳しくはアクセス権の取得をご覧ください。

codex mcp add shopify-admin \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_CLIENT_ID=your_client_id \
  --env SHOPIFY_CLIENT_SECRET=your_client_secret \
  -- npx -y mcp-shopify-admin@latest

codex mcp list

claude mcp add \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_CLIENT_ID=your_client_id \
  --env SHOPIFY_CLIENT_SECRET=your_client_secret \
  --transport stdio --scope user shopify-admin \
  -- npx -y mcp-shopify-admin@latest

claude mcp list

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

{
  "mcpServers": {
    "shopify-admin": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-shopify-admin@latest"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "my-store.myshopify.com",
        "SHOPIFY_CLIENT_ID": "your_client_id",
        "SHOPIFY_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "shopify_store_domain",
      "description": "Shopify store domain, for example my-store.myshopify.com"
    },
    {
      "type": "promptString",
      "id": "shopify_client_id",
      "description": "Client ID of the Shopify Dev Dashboard app"
    },
    {
      "type": "promptString",
      "id": "shopify_client_secret",
      "description": "Client secret of that app",
      "password": true
    }
  ],
  "servers": {
    "shopify-admin": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-shopify-admin@latest"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "${input:shopify_store_domain}",
        "SHOPIFY_CLIENT_ID": "${input:shopify_client_id}",
        "SHOPIFY_CLIENT_SECRET": "${input:shopify_client_secret}"
      }
    }
  }
}

できること

• ストアを確認します。 ショップの詳細、ロケーション、商品、注文、顧客、またはディスカウントを表示します。
• 商品を操作します。 商品の下書きを作成したり、商品フィールドを更新したり、バリアントの価格を変更したりします。
• 在庫を追跡します。 ロケーションを検索し、在庫アイテムの絶対数として利用可能数量を設定します。
• 注文を確認します。 注文を検索して詳細を確認したり、明示的に返金と再入庫の方法を指定して、条件を満たす注文をキャンセルしたりします。
• ディスカウントを管理します。 既存のディスカウントを一覧表示したり、基本的なコードディスカウントを作成したりします。
• 汎用実行手段を使用します。 専用ツールがない機能には、任意の Admin GraphQL ドキュメントを実行します。

Shopify で変更できる内容

このサーバーには、注文の作成、フルフィルメント、顧客データの書き込み、バリエーションの作成、メディア、対象を絞ったディスカウント、販売チャネルへの商品の公開を行う専用ツールはありません。ドキュメントとその userErrors レスポンスを理解している場合に限り、graphql_request を使用してください。

AI クライアントは書き込み前に確認を求める場合がありますが、確認の動作はそのクライアントに依存します。作成、更新、設定、キャンセルを明確に依頼した場合、対応するサーバー操作が許可されたことになります。

アクセスの取得

サーバーは、2 つの方法のいずれかで認証します。Dev Dashboard アプリのクライアント ID とシークレットを使ってサーバー自身がアクセストークンと交換する方法、またはすぐに使える Admin API アクセストークンをそのまま送信する方法です。両方が設定されている場合は、既成のトークンが優先されます。

Dev Dashboard アプリ（推奨）

Shopify は 2026-01-01 に、管理画面から新しいカスタムアプリを作成する機能の提供を終了したため、現在セットアップするストアではこの方法を使います。

1. ストアが属するものと同じ Shopify 組織内で、Shopify Dev Dashboard または Shopify CLI を使用してアプリを作成します。
2. read_products、write_products、read_orders、read_customers、read_locations、write_inventory、read_discounts、write_discounts など、必要な Admin API アクセススコープを付与します。
3. ストアにアプリをインストールします。
4. アプリのクライアント ID とクライアントシークレットを、それぞれ SHOPIFY_CLIENT_ID と SHOPIFY_CLIENT_SECRET として使用します。

以降、サーバーは クライアント認証情報グラントを使用して、https://{store}.myshopify.com/admin/oauth/access_token に対して独自に処理します。Shopify が返すトークンの有効期間は 24 時間 です。サーバーはトークンをメモリ内だけに保持し、ディスクには保存しません。期限切れの少し前に再発行し、並行するツール呼び出しでは 1 回の交換を共有します。また、API が 401 を返した場合は新しいトークンを発行します。手動で更新する必要はありません。

このグラントが機能するのは、アプリとストアが同じ Shopify 組織に属している場合に限られます。そうでない場合、Shopify は shop_not_permitted を返し、サーバーは組織の不一致を示すヒントをそのまま伝えます。認証情報を再発行しても解決しません。アプリをストアの組織に移動するか、その組織に属するストアを使用してください。

Shopify 管理画面で作成した既存のカスタムアプリ（レガシー）

2026-01-01 より前に Shopify 管理画面で作成したアプリは引き続き動作し、そのトークンも引き続き受け付けられます。すでに管理しているアプリがある場合は、次の手順に従ってください。

1. Shopify 管理画面でアプリを開きます。
2. read_products、write_products、read_orders、read_customers、read_locations、write_inventory、read_discounts、write_discounts など、必要な Admin API アクセススコープを確認します。
3. Shopify から認証情報の生成を求められた場合は、アプリをインストールまたは再インストールします。
4. 発行された Admin API アクセストークンを SHOPIFY_ACCESS_TOKEN として使用します。

サーバーはこのトークンをそのまま送信し、更新することはありません。そのため、トークンが使えなくなったときの交換はご自身で行ってください。Shopify のレガシーの管理画面作成カスタムアプリに関するドキュメントを参照してください。

アクセストークンとクライアントシークレットはパスワードとして扱い、Git に絶対にコミットしないでください。安全にテストするには、Shopify 開発ストアを使用してください。

設定

* ローカルテストでは、SHOPIFY_API_BASE を設定してストアドメインの代わりにできますが、Shopify に実際にリクエストするには認証情報が必要です。

** 2 つの認証方法のいずれかが必要です。SHOPIFY_CLIENT_ID と SHOPIFY_CLIENT_SECRET の組み合わせ、または SHOPIFY_ACCESS_TOKEN を使用します。どちらも設定されていない場合、サーバーは起動して initialize に応答しますが、すべてのツール呼び出しで両方の選択肢を示すエラーが返されます。変数は起動時に読み込まれるため、変更後はサーバーを再起動してください。

データ、制限、バックグラウンド処理

• GraphQL コストバケット。 Shopify から値が提供される場合、各結果には actualQueryCost、currentlyAvailable、maximumAvailable、restoreRate が表示されます。first を最大 250 に設定したページは、多数の小さなページより通常はコストが低くなります。
• 再試行の条件は一様ではありません。 THROTTLED と HTTP 429 は、Shopify が指定する待機時間の後に再試行されます。5xx とネットワークエラーは読み取り時にのみ再試行されます。これらのエラーが発生した後、ミューテーションが再実行されることはありません。
• 注文履歴。 60 日を超える注文には read_all_orders スコープが必要です。このスコープがない場合、Shopify はそれらの注文を返しません。
• バックグラウンド監視なし。 サーバーは呼び出されたときに動作します。AI アプリケーションがスケジュール済みタスクに対応している場合は、注文や在庫を定期的に確認できます。
• 匿名のテレメトリ。 サーバーは、シークレット、ストアデータ、引数、プロンプトを含まない技術的なインストールイベントとツール使用イベントを送信します。すべての Ask Ads MCP サーバーで無効にするには、ASKADS_TELEMETRY=0 を設定してください。

技術ドキュメント

• 機能カタログ — 16 個のツールそれぞれについて、タスク指向のページを 1 つ用意しています。
• すべてのツールとパラメーター
• 開発ガイド
• 公開ガイド
• Shopify Admin GraphQL API

サポート

バグや不足しているシナリオを見つけましたか？イシューを作成するか、Telegram からお問い合わせください。

最後までお読みいただき、ありがとうございます！