mcp-shopify

@codespar/mcp-shopify

Shopify 用の MCP サーバー — グローバルな E コマースプラットフォームの Admin REST API です。

Shopify はグローバルな DTC の標準であり、国際展開するブランドにおいて LatAm 全域で主流です（地域限定の事業者向けの Nuvemshop/Tiendanube を補完するもので、こちらもこのカタログに含まれています）。事業者向けツール（再入荷、返金の自動化、マーケティングキャンペーン、フルフィルメントのオーケストレーションなど）を構築するエージェントは、再販業者を介さず Admin API に直接統合します。

ツール（28）

ツール	目的
list_orders	オプションのフィルターを指定して注文を一覧表示します。
get_order	ID を指定して、詳細情報を含む単一の注文を取得します。
create_order	新しい注文を作成します。
update_order	既存の注文を更新します（タグ、メモ、メールアドレス、shipping_address、メタフィールドなど）。
cancel_order	注文をキャンセルします。
list_products	オプションのフィルターを指定して商品を一覧表示します。
get_product	すべてのバリエーションと画像を含む単一の商品を ID で取得します。
create_product	バリエーション、オプション、画像を含む新しい商品を作成します。
update_product	既存の商品フィールド、バリエーション、または画像を更新します。
list_customers	オプションのクエリフィルターを指定して顧客を一覧表示します。
create_customer	新しい顧客レコードを作成します。
adjust_inventory	特定のロケーションにある特定の inventory_item の在庫数を差分で調整します（正の値で...
create_fulfillment	注文のフルフィルメントを作成します（明細を発送済みとしてマークし、追跡番号と配送業者を設定します）。
update_fulfillment_tracking	既存のフルフィルメントの追跡番号、追跡会社、または追跡 URL を更新します（発送後の追跡情...
create_draft_order	下書き注文（請求書形式の見積もり）を作成します。
complete_draft_order	下書き注文を実際の注文に変換します。
create_price_rule	価格ルール（割引を規定するポリシー。割合／固定額、適用条件、適用対象...）を作成します。
create_discount_code	既存の価格ルールに紐づく割引コード（「SUMMER20」のような顧客向け文字列）を作成します。
create_smart_collection	スマートコレクション（ルールに基づいて商品が自動登録されるコレクション。例：）を作成します。
create_custom_collection	手動で構成するカスタムコレクションを作成します。
create_metafield	メタフィールド（型付きのカスタムフィールド）をリソース（ストア、商品、バリエーション、顧客、注文、コレクション...）に追加します。
create_variant	既存の商品に新しいバリエーションを追加します（サイズ／色／SKU の組み合わせ。それぞれ固有の価格と在庫を持ちます）。
update_variant	既存の商品バリエーションの価格、SKU、バーコード、オプション、重量、または在庫ポリシーを更新します。
list_transactions	注文のすべての決済取引（オーソリ、キャプチャ、売上、返金、取消）をゲートウェイ情報を含めて一覧表示します...
list_abandoned_checkouts	放棄されたチェックアウト（顧客が連絡先情報を入力したものの、チェックアウトを完了しなかったカート）を一覧表示します。
list_locations	すべてのフルフィルメント拠点（実店舗、倉庫、3PL）を一覧表示します。
create_refund	注文の明細を1つ以上返金します。
register_webhook	Shopify イベントトピック（orders/create、orders/paid、products/update、app...）の Webhook サブスクリプションを登録します。

インストール

npm install @codespar/mcp-shopify

環境

SHOPIFY_SHOP="acme"               # subdomain (acme.myshopify.com)
SHOPIFY_ACCESS_TOKEN="shpat_..."  # Admin API access token (secret)
SHOPIFY_API_VERSION="2024-01"     # Optional. Defaults to 2024-01.

認証

すべてのリクエストでヘッダーとして送信する、プライベート／カスタムアプリのアクセストークンです。

X-Shopify-Access-Token: <SHOPIFY_ACCESS_TOKEN>

Shopify 管理画面でカスタムアプリを作成し、Settings → Apps and sales channels → Develop apps に進み、必要な Admin API スコープ（注文、商品、顧客、在庫、フルフィルメントの読み取り／書き込み）を許可して、アプリをインストールするとトークンが生成されます。

実行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-shopify

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-shopify

API の概要

https://{shop}.myshopify.com/admin/api/{version} の Shopify Admin REST API を使用します。デフォルトのバージョンは 2024-01（安定版）です。新しい安定版がリリースされた場合は、SHOPIFY_API_VERSION で上書きできます。

エンタープライズ

エージェントの決済にガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT