MCPセットアップガイド

主要なすべてのAIコーディングツールにShopify MCPサーバーを接続するためのステップバイステップの手順です。各ガイドでは、インストール、設定、確認、トラブルシューティングをカバーしています。

推奨セットアップ

最高のShopify開発体験のために、2つのMCPサーバーを設定してください：

Shopify Dev MCP -- ドキュメント、APIスキーマ、Liquidリファレンス（認証不要）
Shopify Store MCP -- Admin APIによるライブストア管理（アクセストークンが必要）

このガイドでは両方をカバーしています。

前提条件

セットアップを始める前に、以下を確認してください：

Node.js 18以上 -- nodejs.orgからダウンロード
npm 9以上 -- Node.jsに付属
Shopify Partnerアカウント -- 無料で登録
開発ストア -- Partnerダッシュボードから作成

Node.jsのインストールを確認：

node --version   # v18.x.x以上が出力されること
npm --version    # 9.x.x以上が出力されること
npx --version    # 9.x.x以上が出力されること

Shopifyアクセストークンの作成

ストア管理MCPサーバーには、Admin APIアクセストークンが必要です：

Shopifyストアの管理画面にアクセス
設定 > アプリと販売チャネルに移動
アプリを開発をクリック（最初にデベロッパーアクセスを有効にする必要がある場合があります）
アプリを作成をクリックし、「MCP Integration」のような名前を付ける
Admin APIスコープを設定をクリック
必要なスコープを選択：

スコープ	用途
`read_products`、`write_products`	商品管理
`read_orders`、`write_orders`	注文管理
`read_customers`、`write_customers`	顧客データ
`read_inventory`、`write_inventory`	在庫追跡
`read_fulfillments`、`write_fulfillments`	フルフィルメント処理

保存をクリックしてからアプリをインストール
Admin APIアクセストークンをコピー -- 一度しか表示されません

トークンのセキュリティ

アクセストークンをバージョン管理にコミットしない
スクリーンショット、チャット、ドキュメントでトークンを共有しない
トークンは環境変数またはシークレットマネージャーに保存する
定期的にトークンをローテーションする
最小限必要なスコープを使用する

Claude Code（推奨）

Claude Codeは、組み込みのサーバー管理コマンドを備えた最高のMCP統合を提供します。

ステップ1：Dev MCPサーバーを追加

claude mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest

ステップ2：Store MCPサーバーを追加

claude mcp add shopify-store \
  -e SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxx \
  -e MYSHOPIFY_DOMAIN=your-store.myshopify.com \
  -- npx -y shopify-mcp@latest

環境変数の代替方法

トークンをインラインで渡す代わりに、シェルプロファイルに設定できます：

# ~/.zshrc または ~/.bashrc に追加
export SHOPIFY_ACCESS_TOKEN="shpat_xxxxxxxxxxxxx"
export MYSHOPIFY_DOMAIN="your-store.myshopify.com"

その後、-eフラグなしでサーバーを追加：

claude mcp add shopify-store -- npx -y shopify-mcp@latest

サーバーは環境から自動的に読み取ります。

ステップ3：確認

# 設定済みMCPサーバーを一覧表示
claude mcp list

# Claude Codeを起動してテスト
claude

Claude Codeで以下のプロンプトを試してください：

# Dev MCPのテスト
Search the Shopify docs for product creation best practices

# Store MCPのテスト
List the first 5 products in my store

スコープオプション

# プロジェクトスコープ（デフォルト）- このプロジェクトでのみ利用可能
claude mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest

# ユーザースコープ - すべてのプロジェクトで利用可能
claude mcp add --scope user shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest

サーバーの管理

# すべてのサーバーを一覧表示
claude mcp list

# サーバーを削除
claude mcp remove shopify-dev

# サーバーの詳細を表示
claude mcp get shopify-dev

Cursor

ステップ1：設定ファイルの場所を確認

OS	パス
macOS	`~/.cursor/mcp.json`
Linux	`~/.cursor/mcp.json`
Windows	`%APPDATA%\Cursor\mcp.json`

ファイルが存在しない場合は作成してください。

ステップ2：サーバー設定を追加

{
  "mcpServers": {
    "shopify-dev": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    },
    "shopify-store": {
      "command": "npx",
      "args": ["-y", "shopify-mcp@latest"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxx",
        "MYSHOPIFY_DOMAIN": "your-store.myshopify.com"
      }
    }
  }
}

ステップ3：Cursorを再起動

設定ファイルの保存後、Cursorを完全に再起動してください（ウィンドウの再読み込みではなく）。

ステップ4：確認

Composerパネルを開く（Cmd+I / Ctrl+I）
MCPサーバーアイコン（通常はレンチまたはプラグのアイコン）を探す
クリックして利用可能なツールを確認
クエリを試す：「Search Shopify docs for webhook topics」

Cursor固有のコツ

Cursorは初回起動時にMCPサーバーの初期化に10〜15秒かかる場合があります
ツールが表示されない場合、CursorのOutputパネルでMCP関連のエラーを確認してください
Cursorの.cursorrulesファイルを使用して、MCPと併せてShopify固有のコンテキストを追加できます

Claude Desktop

macOSセットアップ

ステップ1：設定ファイルを開く

# 必要に応じて設定ディレクトリを作成
mkdir -p ~/Library/Application\ Support/Claude

# 設定ファイルを開くまたは作成
open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json

ステップ2：設定を追加

{
  "mcpServers": {
    "shopify-dev": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    },
    "shopify-store": {
      "command": "npx",
      "args": ["-y", "shopify-mcp@latest"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxx",
        "MYSHOPIFY_DOMAIN": "your-store.myshopify.com"
      }
    }
  }
}

ステップ3：Claude Desktopを再起動

Claude Desktopを完全に終了して再度開いてください。

ステップ4：確認

チャット入力欄でハンマーアイコンを探してください。クリックすると利用可能なMCPツールが表示されます。

Windowsセットアップ

ステップ1：設定ファイルを開く

# 設定ファイルを開くまたは作成
notepad "$env:APPDATA\Claude\claude_desktop_config.json"

ステップ2：設定を追加

上記のmacOSと同じJSON設定を使用してください。

ステップ3：再起動と確認

Claude Desktopを再起動し、ハンマーアイコンを確認してください。

Windows固有の注意事項

WindowsのPATHの問題

Windowsでnpxが見つからない場合、フルパスを指定してください：

{
  "mcpServers": {
    "shopify-dev": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    }
  }
}

Codex (OpenAI)

OpenAIのCodex CLIは、ツール拡張のためにMCPサーバーをサポートしています。

ステップ1：Codexをインストール

npm install -g @openai/codex

ステップ2：MCPサーバーを追加

# Dev MCPを追加
codex mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest

# Store MCPを追加
codex mcp add shopify-store \
  -e SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxx \
  -e MYSHOPIFY_DOMAIN=your-store.myshopify.com \
  -- npx -y shopify-mcp@latest

ステップ3：確認

codex mcp list
codex  # Codexを起動してShopifyクエリでテスト

Codex固有の注意事項

CodexはClaudeベースのクライアントとはツール呼び出しの処理が異なる場合があります
複雑なワークフローを構築する前に、各ツールを個別にテストしてください
一部のコミュニティMCPサーバーはCodexとの互換性にわずかな差異がある場合があります

Windsurf

ステップ1：設定の場所を確認

Windsurfは設定内にMCP設定を保存します。設定を開き（Cmd+, / Ctrl+,）、「MCP」を検索するか、MCP設定ファイルを見つけてください：

OS	パス
macOS	`~/.windsurf/mcp.json`
Linux	`~/.windsurf/mcp.json`
Windows	`%APPDATA%\Windsurf\mcp.json`

ステップ2：設定を追加

{
  "mcpServers": {
    "shopify-dev": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    },
    "shopify-store": {
      "command": "npx",
      "args": ["-y", "shopify-mcp@latest"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxx",
        "MYSHOPIFY_DOMAIN": "your-store.myshopify.com"
      }
    }
  }
}

ステップ3：再起動と確認

Windsurfを再起動し、AIパネルにMCPツールが表示されることを確認してください。

Cline

Cline（VS Code拡張機能）は設定を通じてMCPサーバーをサポートしています。

ステップ1：Cline設定を開く

Clineがインストールされた VS Codeで：

コマンドパレットを開く（Cmd+Shift+P / Ctrl+Shift+P）
「Cline: MCP Servers」を検索
または設定ファイルを直接編集

設定ファイルの場所：

OS	パス
macOS	`~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
Linux	`~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
Windows	`%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`

ステップ2：設定を追加

{
  "mcpServers": {
    "shopify-dev": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"],
      "disabled": false
    },
    "shopify-store": {
      "command": "npx",
      "args": ["-y", "shopify-mcp@latest"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxx",
        "MYSHOPIFY_DOMAIN": "your-store.myshopify.com"
      },
      "disabled": false
    }
  }
}

ステップ3：確認

VS Codeをリロード（Cmd+Shift+P > "Developer: Reload Window"）
Clineサイドバーを開く
MCPサーバーのステータスインジケータを確認
テスト：「List my Shopify MCP tools」

トラブルシューティング

"Cannot find module"エラー

Error: Cannot find module '@anthropic-ai/shopify-dev-mcp'

原因と修正方法：

Node.jsのバージョンが古い：

node --version  # 18以上であること
# 古い場合、nvmで更新：
nvm install 18
nvm use 18

npxキャッシュの破損：

# npmキャッシュをクリア
npm cache clean --force
# 再試行
npx -y @anthropic-ai/shopify-dev-mcp@latest

ネットワーク/プロキシの問題：

# npmレジストリへのアクセスをテスト
npm ping
# プロキシの後ろにいる場合：
npm config set proxy http://proxy.example.com:8080

サーバーは起動するがツールが表示されない

サーバーが動作しているか確認：

# Claude Code
claude mcp list
# ステータスが "connected" か "disconnected" かを確認

サーバーログを確認：

Claude Desktopの場合、以下のログを確認：

macOS: ~/Library/Logs/Claude/mcp*.log
Windows: %APPDATA%\Claude\Logs\mcp*.log

一般的な修正方法： AIクライアントを完全に再起動してください（再読み込みだけではなく）。

認証エラー

Error: 401 Unauthorized

修正方法：

トークンの期限切れまたは無効化： Shopify管理画面で新しいトークンを生成
ドメインの形式が不正： your-store.myshopify.comを使用（カスタムドメインではなく）
スコープが不十分： トークンに必要なAPIスコープがあるか確認

環境変数が未設定：

# 変数が設定されているか確認
echo $SHOPIFY_ACCESS_TOKEN
# 空の場合、設定：
export SHOPIFY_ACCESS_TOKEN="shpat_xxxxxxxxxxxxx"

レート制限

Error: 429 Too Many Requests

ShopifyのAdmin APIにはレート制限があります（スタンダードプランでは通常1秒あたり40リクエスト）。レート制限に達した場合：

リクエストを遅くする -- バルク操作を高速に連続して実行しない
プランを確認 -- Shopify Plusストアはより高い制限を持つ
バルク操作を使用 -- 一部のMCPサーバーは大規模データセット用のGraphQLバルク操作をサポート
使用状況を監視 -- レスポンスのX-Shopify-Shop-Api-Call-Limitヘッダーを確認

サーバーの起動が遅い

npxを使用するMCPサーバーは初回実行時にパッケージをダウンロードします。その後の実行ではnpmキャッシュを使用します。

起動を高速化：

# パッケージをグローバルにプリインストール
npm install -g @anthropic-ai/shopify-dev-mcp
npm install -g shopify-mcp

# npxの代わりにローカルバイナリを参照
claude mcp add shopify-dev -- shopify-dev-mcp

複数ストア

複数のShopifyストアに接続するには、別々のMCPサーバーエントリを追加します：

{
  "mcpServers": {
    "shopify-dev": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    },
    "store-production": {
      "command": "npx",
      "args": ["-y", "shopify-mcp@latest"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "shpat_prod_token",
        "MYSHOPIFY_DOMAIN": "my-store.myshopify.com"
      }
    },
    "store-staging": {
      "command": "npx",
      "args": ["-y", "shopify-mcp@latest"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "shpat_staging_token",
        "MYSHOPIFY_DOMAIN": "my-store-staging.myshopify.com"
      }
    }
  }
}

本番環境の安全性

本番環境とステージング環境の両方に接続している場合、プロンプトで常にどのストアをターゲットにしているかを指定してください。開発中は本番トークンに読み取り専用のスコープを使用することを検討してください。

サーバーバージョンの競合

アップデート後に予期しない動作が発生した場合：

# npmキャッシュをクリアして再インストール
npm cache clean --force

# Claude Code：削除して再追加
claude mcp remove shopify-dev
claude mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest

# 必要に応じて特定のバージョンを固定
claude mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@1.2.3

設定リファレンス

環境変数

変数	使用先	説明
`SHOPIFY_ACCESS_TOKEN`	Store MCPサーバー	Admin APIアクセストークン
`MYSHOPIFY_DOMAIN`	shopify-mcp (GeLi2001)	ストアドメイン（例：`store.myshopify.com`）
`SHOP_DOMAIN`	@ajackus/shopify-mcp-server	ストアドメイン
`SHOPIFY_STOREFRONT_TOKEN`	Storefront対応サーバー	Storefront APIトークン
`COMPOSIO_API_KEY`	Composio	Composioプラットフォームキー
`ADZVISER_API_KEY`	Adzviser	Adzviserプラットフォームキー

トランスポートタイプ

トランスポート	説明	ユースケース
`stdio`	標準入出力（ローカルプロセス）	ほとんどのセットアップのデフォルト。サーバーはローカルで実行。
`streamable-http`	ストリーミング付きHTTP	リモート/ホステッドMCPサーバー
`sse`	Server-Sent Events（レガシー）	旧式のリモートサーバー

ほとんどのコミュニティサーバーはstdioトランスポートを使用しており、サーバーはAIクライアントが管理するローカルプロセスとして実行されます。ポートフォワーディングやネットワーク設定は不要です。

前提条件​

Shopifyアクセストークンの作成​

Claude Code（推奨）​

ステップ1：Dev MCPサーバーを追加​

ステップ2：Store MCPサーバーを追加​

ステップ3：確認​

スコープオプション​

サーバーの管理​

Cursor​

ステップ1：設定ファイルの場所を確認​

ステップ2：サーバー設定を追加​

ステップ3：Cursorを再起動​

ステップ4：確認​

Cursor固有のコツ​

Claude Desktop​

macOSセットアップ​

ステップ1：設定ファイルを開く​

ステップ2：設定を追加​

ステップ3：Claude Desktopを再起動​

ステップ4：確認​

Windowsセットアップ​

ステップ1：設定ファイルを開く​

ステップ2：設定を追加​

ステップ3：再起動と確認​

Windows固有の注意事項​

Codex (OpenAI)​

ステップ1：Codexをインストール​

ステップ2：MCPサーバーを追加​

ステップ3：確認​

Codex固有の注意事項​

Windsurf​

ステップ1：設定の場所を確認​

ステップ2：設定を追加​

ステップ3：再起動と確認​

Cline​

ステップ1：Cline設定を開く​

ステップ2：設定を追加​

ステップ3：確認​

トラブルシューティング​

"Cannot find module"エラー​

サーバーは起動するがツールが表示されない​

認証エラー​

レート制限​

サーバーの起動が遅い​

複数ストア​

サーバーバージョンの競合​

設定リファレンス​

環境変数​

トランスポートタイプ​

前提条件

Shopifyアクセストークンの作成

Claude Code（推奨）

ステップ1：Dev MCPサーバーを追加

ステップ2：Store MCPサーバーを追加

ステップ3：確認

スコープオプション

サーバーの管理

Cursor

ステップ1：設定ファイルの場所を確認

ステップ2：サーバー設定を追加

ステップ3：Cursorを再起動

ステップ4：確認

Cursor固有のコツ

Claude Desktop

macOSセットアップ

ステップ1：設定ファイルを開く

ステップ2：設定を追加

ステップ3：Claude Desktopを再起動

ステップ4：確認

Windowsセットアップ

ステップ1：設定ファイルを開く

ステップ2：設定を追加

ステップ3：再起動と確認

Windows固有の注意事項

Codex (OpenAI)

ステップ1：Codexをインストール

ステップ2：MCPサーバーを追加

ステップ3：確認

Codex固有の注意事項

Windsurf

ステップ1：設定の場所を確認

ステップ2：設定を追加

ステップ3：再起動と確認

Cline

ステップ1：Cline設定を開く

ステップ2：設定を追加

ステップ3：確認

トラブルシューティング

"Cannot find module"エラー

サーバーは起動するがツールが表示されない

認証エラー

レート制限

サーバーの起動が遅い

複数ストア

サーバーバージョンの競合

設定リファレンス

環境変数

トランスポートタイプ