Shopify MCP Pro

Shopify MCP Pro

実用的な Shopify MCP サーバーです。Claude を Shopify ストアに接続して、商品、注文、顧客、在庫、分析などを利用できます。

多くの Shopify MCP パッケージでは、分析機能に不具合があり（誤ったデータを返すスタブ）、実行時にクラッシュする非推奨の API フィールドが使われ、気付かないうちに有効期限が切れる固定トークンが必要です。このサーバーではそのような問題はありません。

Denis Maleev が開発しました。

---

このサーバーを選ぶ理由

修正点	詳細
分析ツールがスタブだった	getSalesReport、getConversionReport、getTrafficReport が ShopifyQL を利用するようになり、実データを返します
実際に機能する認証	Shopify Dev Dashboard の Client ID と Secret を使用し、トークンは自動更新されるため、気付かないうちに有効期限が切れることはありません
非推奨の API フィールド	getInventoryLevels、listAbandonedCheckouts を Shopify 2026-04 のフィールドスキーマに更新しました
実行時のクラッシュ	getShippingZones は、配送プロファイルがないストアでもクラッシュしなくなりました
新機能：runShopifyQL	ShopifyQL クエリを直接実行できます。Admin → Analytics と同じデータを取得します
Shopify Admin API	2026-04（現行 GA）＋ @shopify/shopify-api v13

---

クイックスタート

npx @den.dance/shopify-mcp-pro

---

セットアップ

1. Shopify でカスタムアプリを作成する

1. Shopify Admin → Settings → Apps and sales channels に移動します
2. Develop apps をクリックします（表示された場合は、カスタムアプリの開発を有効にします）
3. Create an app をクリックし、名前を付けます（例：「Claude MCP」）
4. Configure Admin API scopes に移動し、必要なスコープを選択します（以下の一覧を参照）
5. Install app をクリックします
6. API credentials タブに移動すると、Client ID と Client secret が表示されます

注：Shopify では、デフォルトで固定アクセストークンが表示されなくなりました。このサーバーは Client ID と Secret を使った OAuth を使用します。

2. Claude Desktop を設定する

Claude Desktop の設定ファイルを編集します：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["@den.dance/shopify-mcp-pro"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_CLIENT_ID": "your-client-id",
        "SHOPIFY_CLIENT_SECRET": "your-client-secret",
        "SHOPIFY_API_VERSION": "2026-04",
        "SHOPIFY_LOG_LEVEL": "WARNING"
      }
    }
  }
}

保存した後、Claude Desktop を再起動します。

Claude Code を設定する

claude mcp add shopify -e SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
  -e SHOPIFY_CLIENT_ID=your-client-id \
  -e SHOPIFY_CLIENT_SECRET=your-client-secret \
  -- npx @den.dance/shopify-mcp-pro

---

環境変数

変数	必須	説明
SHOPIFY_STORE_DOMAIN	はい	例：my-store.myshopify.com
SHOPIFY_CLIENT_ID	はい	Shopify Dev Dashboard で取得
SHOPIFY_CLIENT_SECRET	はい	Shopify Dev Dashboard で取得
SHOPIFY_API_VERSION	いいえ	デフォルトは 2026-04
SHOPIFY_LOG_LEVEL	いいえ	error、warning、info、debug（デフォルト：warning）
TRANSPORT_MODE	いいえ	stdio（デフォルト）または sse
PORT	いいえ	SSE モード用の HTTP ポート（デフォルト：3000）

---

API スコープ

最低限の推奨スコープ

• read_products、write_products
• read_orders
• read_customers
• read_inventory、write_inventory

分析機能用

• read_analytics
• read_reports

すべての機能を使う場合

• read_draft_orders、write_draft_orders
• read_fulfillments、write_fulfillments
• read_shipping
• read_marketing_events、write_marketing_events
• read_discounts、write_discounts
• read_price_rules、write_price_rules
• read_themes
• read_content、write_content
• read_metaobjects、write_metaobjects
• read_gift_cards、write_gift_cards

すべてのスコープを設定する必要はありません。サーバーは許可されたスコープだけで動作します。不足しているスコープを必要とするツールは、ほかのツールに影響を与えることなく認証エラーを返します。

---

ツール

商品と在庫

• listProducts — フィルター、ページネーション、並べ替えを指定して一覧表示します
• getProduct — ID で取得します（在庫アイテム ID を含みます）
• createProduct、updateProduct
• getInventoryLevels — ロケーションごとの現在の在庫数を取得します
• adjustInventory — 在庫数を調整します
• listCollections
• setMetafield
• listMetaobjectDefinitions、createMetaobject、listMetaobjects

注文とフルフィルメント

• listOrders、getOrder
• createDraftOrder、listDraftOrders
• createFulfillment、listFulfillmentOrders
• getShippingZones
• createRefund
• listTransactions

顧客とB2B

• listCustomers、getCustomer
• getCustomerAnalytics
• createCompany、listCompanies

財務

• getFinancialSummary
• createGiftCard、listGiftCards

マーケティングとコンテンツ

• createDiscountCode、listDiscounts
• listPriceRules
• createPage、listPages
• createArticle、listBlogs
• createRedirect
• createWebhook、listWebhooks

分析とレポート

• getSalesReport — 売上、注文、AOV（ShopifyQL）
• getProductAnalytics — 売上上位の商品（ShopifyQL）
• getConversionReport — 商品のコンバージョンファネル（ShopifyQL）
• getTrafficReport — リファラーソース別の売上（ShopifyQL）
• getAbandonmentReport — 指定期間のカート放棄
• listAbandonedCheckouts
• getMarketingReport
• getCustomerAnalytics
• runShopifyQL — 任意のShopifyQLクエリを直接実行

ストア設定

• getShopInfo
• listThemes
• listLocations
• listMarkets
• getInventoryReport
• getCustomReport

---

ShopifyQL

runShopifyQLを使うと、Shopify独自のSQL風分析言語であるShopifyQLのクエリをそのまま実行できます。

FROM sales SHOW total_sales, gross_sales, total_orders SINCE '2026-01-01' UNTIL '2026-05-19'
FROM products SHOW total_sales BY product_title ORDER BY total_sales DESC LIMIT 10
FROM sessions SHOW sessions BY referrer_source

Shopifyアプリの設定で、read_reportsスコープとレベル2の顧客データアクセスが必要です。

---

Claude向けプロンプトの例

• 「先月の売上を商品別に表示して」
• 「在庫が10個未満の商品はどれ？」
• 「月末まで有効な20％割引コードを作成して」
• 「過去1週間の放棄されたチェックアウトを一覧表示して」
• 「ShopifyQLクエリを実行して：FROM sales SHOW total_orders SINCE -30d」
• 「顧客生涯価値の指標を取得して」
• 「今年の売上上位10商品を表示して」

---

SSEモード

HTTPベースのアクセスまたはクラウドへのデプロイには、以下を使用します。

TRANSPORT_MODE=sse \
SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
SHOPIFY_CLIENT_ID=your-client-id \
SHOPIFY_CLIENT_SECRET=your-client-secret \
PORT=3000 \
npx @den.dance/shopify-mcp-pro

エンドポイント：

• GET /sse — SSEストリーム
• POST /messages?sessionId={id} — メッセージを送信
• GET /health — ヘルスチェック

リモートSSE用にClaude Desktopを設定します。

{
  "mcpServers": {
    "shopify-remote": {
      "transport": {
        "type": "sse",
        "url": "https://your-server.com/sse"
      }
    }
  }
}

---

セキュリティ

• 認証情報をバージョン管理にコミットしないでください
• すべてのシークレットには環境変数を使用してください
• 用途ごとに、必要最小限のスコープを設定した個別のアプリを作成してください
• Client Secretは定期的にローテーションしてください

---

ライセンス

MIT