Skip to main content

Shopify Dev MCPサーバー

Shopify Dev MCPサーバー（@anthropic-ai/shopify-dev-mcp）は、ShopifyとAnthropicの協力により構築された公式MCPサーバーです。AIコーディングツールに、Shopifyの開発者ドキュメント、GraphQL Admin APIスキーマ、テーマ検証などへの直接アクセスを提供します。Shopify開発にとって最もインパクトのあるMCPサーバーです。

提供される機能​

Shopify Dev MCPサーバーはストアに接続しません。代わりに開発インテリジェンス -- AIが正しいShopifyコードを書くために必要な知識を提供します:

  • GraphQLスキーマイントロスペクション: Admin APIスキーマにクエリして型、フィールド、ミューテーション、正確なシグネチャを発見
  • 開発者ドキュメント検索: Shopifyの公式ドキュメントを検索し関連記事を取得
  • 入門ガイド: 様々なShopify開発パスの構造化されたオンボーディングコンテンツにアクセス
  • テーマ検証: テーマファイルに対してShopify Theme Checkを実行
  • チェックアウト拡張性ツール: チェックアウト固有のドキュメントとパターンにアクセス
ストアアクセス不要

このサーバーはShopifyアクセストークンやストア資格情報を必要としません。ストアデータではなく開発者の知識を提供します。ストアデータ操作（商品、注文などのCRUD）には、次のセクションで説明するコミュニティMCPサーバーが必要です。

インストール​

Claude Code​

推奨されるインストール方法はユーザースコープでサーバーを登録し、すべてのプロジェクトで利用可能にします:

Claude Code用にインストール（グローバル）
claude mcp add shopify-dev-mcp -s user -- npx -- -y @anthropic-ai/shopify-dev-mcp@latest

特定のプロジェクトのみにインストールする場合:

特定のプロジェクトにインストール
claude mcp add shopify-dev-mcp -- npx -- -y @anthropic-ai/shopify-dev-mcp@latest

インストールを確認:

MCPサーバーの確認
claude mcp list

出力にshopify-dev-mcpがstdioトランスポートで表示されるはずです。

Cursor​

Cursor MCP設定（プロジェクトルートの.cursor/mcp.jsonまたはグローバル設定）に以下を追加:

.cursor/mcp.json
{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    }
  }
}

Claude Desktop​

Claude Desktop設定ファイルに追加:

claude_desktop_config.json
{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    }
  }
}

設定ファイルの場所はOSによって異なります:

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

Codex (OpenAI)​

Codexも同じ設定形式でMCPサーバーをサポートしています:

Codex MCP設定
{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
    }
  }
}
常に@latestを使用

@latestタグにより、更新されたドキュメントとスキーマデータを含む最新バージョンが取得されます。ShopifyのAPIは四半期ごとのリリースで進化し、MCPサーバーもそれに応じて更新されます。

利用可能なツール​

introspect_admin_schema​

サーバーで最も強力なツール。Shopify GraphQL Admin APIスキーマにクエリして、型、フィールド、引数、正確なシグネチャを発見できます。

ユースケース:

  • クエリを書く前に型で利用可能なフィールドを発見
  • ミューテーション入力要件の確認
  • フィールドの正しい列挙値の検索
  • 型の関係（コネクション、エッジ、ノード）の理解
例: 商品フィールドの発見
> What fields are available on the Shopify Product type in the
  Admin API? Use the MCP schema introspection tool.

Claude Codeはintrospect_admin_schemaを呼び出し、型、説明、廃止通知を含む完全なフィールドリストを返します。

例: ミューテーションシグネチャの確認
> What are the required inputs for the productCreate mutation?
  Introspect the Admin API schema.
スキーマバージョンの認識

イントロスペクトされるスキーマは特定のAPIバージョンを反映しています。古いAPIバージョンで作業している場合、一部のフィールドやミューテーションが利用できない可能性があります。プロジェクトのターゲットAPIバージョンと常に照合してください。

search_dev_docs​

Shopifyの公式開発者ドキュメントを検索し、関連する記事、ガイド、APIリファレンスを返します。

ユースケース:

  • 特定のShopify機能のドキュメントを検索
  • Webhook、認証、課金のベストプラクティスを調べる
  • 知らなかった新しいAPIや機能を発見
  • 複雑な機能の実装ガイダンスを取得
例: Webhookドキュメントの検索
> Search the Shopify developer docs for information about
  mandatory webhooks and GDPR compliance requirements.
例: 課金APIドキュメントの検索
> Search Shopify docs for how to implement app billing
  with usage-based charges using the GraphQL API.

get_started​

異なるShopify開発パスの構造化された入門コンテンツを提供します。新しいタイプのプロジェクトを始める際に特に有用です。

ユースケース:

  • 新しいエクステンションタイプのセットアッププロセスの学習
  • Hydrogenの開発ワークフローの理解
  • Remixアプリの推奨プロジェクト構造の取得
例: Functionsの入門
> Use the get_started tool to learn about building Shopify
  Functions for order discounts.

validate_theme​

テーマファイルに対してShopify Theme Checkを実行し、Liquidコードの問題、パフォーマンスの問題、ベストプラクティス違反を特定します。

ユースケース:

  • デプロイ前のテーマコード検証
  • APIバージョンアップグレード後のLiquid非推奨項目の検出
  • パフォーマンス問題の特定（遅延読み込みの欠落、大きなDOM）
  • アクセシビリティコンプライアンスの確認
例: テーマの検証
> Validate the theme files in this project using the Shopify
  theme validation tool. Report any errors or warnings.
Claude Codeのファイルアクセスとの組み合わせ

Claude Codeはテーマファイルを読み取り、MCPを通じて検証を1つのワークフローで行えます。「すべてのテーマ検証エラーを修正して」と頼めば、検証、問題の特定、ファイルの編集、再検証をすべて自律的に行います。

Checkout MCPツール​

Shopify Dev MCPには、チェックアウト拡張性の専門ツールが含まれています:

  • チェックアウトUIエクステンションパターン: チェックアウトUIエクステンションの一般的なパターン
  • チェックアウト検証: チェックアウトエクステンション設定の検証
  • 決済カスタマイゼーション: 決済方法のフィルタリングとカスタマイゼーションのツール
  • 配送カスタマイゼーション: 配送料金変更パターン
例: チェックアウトエクステンションのヘルプ
> Use the checkout MCP tools to understand how to implement
  a post-purchase upsell extension with React.

ベストプラクティス​

会話IDの使用​

MCPサーバーに複数の関連クエリを行う場合、会話コンテキストがより関連性の高い結果を提供するのに役立ちます。Claude Codeはセッション内でこれを自動的に処理しますが、/clearがこのコンテキストをリセットすることに注意してください。

コンテキストに基づくフォローアップクエリ
> Search docs for Shopify Functions
# 最初のクエリがコンテキストを確立

> Now show me the specific input query format for delivery customization
# フォローアップがより正確な結果のために会話コンテキストを活用

ツールの組み合わせで最大効果​

複数のMCPツールを単一のワークフローで組み合わせると真の力が発揮されます:

組み合わせワークフロー
> I need to write a GraphQL mutation to update product metafields.
  1. Introspect the Admin API schema for the metafieldsSet mutation
  2. Search the docs for metafield best practices
  3. Then write the mutation with proper TypeScript types

Claude Codeはintrospect_admin_schemaを呼び出して正確なミューテーションシグネチャを取得し、search_dev_docsでベストプラクティスを取得し、両方を統合して正確で構造化されたコードを生成します。

OPT_OUT_INSTRUMENTATION環境変数​

Shopify Dev MCPサーバーはデフォルトでツール改善のための匿名使用テレメトリを収集します。オプトアウトしたい場合:

テレメトリのオプトアウト
# Claude Code起動前に環境変数を設定
export OPT_OUT_INSTRUMENTATION=1
claude

またはシェルプロファイルに永続的に追加:

永続的なオプトアウト
echo 'export OPT_OUT_INSTRUMENTATION=1' >> ~/.zshrc
source ~/.zshrc

MCPサーバー登録に直接設定することもできます:

テレメトリオプトアウト付きで登録
claude mcp add shopify-dev-mcp -s user -e OPT_OUT_INSTRUMENTATION=1 -- npx -- -y @anthropic-ai/shopify-dev-mcp@latest
テレメトリは匿名

テレメトリデータにはツール使用パターン（どのツールがどの頻度で呼び出されるか）のみが含まれます -- コード、プロンプト、ストアデータは含まれません。ShopifyとAnthropicがMCPサーバーの改善に優先順位を付けるのに役立ちます。

Shopify Dev MCPでの一般的なワークフロー​

ワークフロー1: 新しいGraphQLクエリの作成​

ステップバイステップ
1. "Introspect the Admin API schema for the OrderConnection type"
2. "What filters are available on the orders query?"
3. "Write a paginated query to fetch orders with fulfillment status
    UNFULFILLED from the last 7 days"

ワークフロー2: テーマセクションの構築​

ステップバイステップ
1. "Search docs for section schema best practices in OS 2.0"
2. "Validate the current theme for any existing issues"
3. "Create a new testimonials section following the patterns
    from the docs"
4. "Validate the theme again to ensure no new issues"

ワークフロー3: APIエラーのデバッグ​

ステップバイステップ
1. "Search docs for error code ACCESS_DENIED on Admin API"
2. "Introspect the schema for the mutation that's failing
    to check if the required scope changed"
3. "What scopes are needed for the productUpdate mutation?"

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

サーバーが起動しない​

MCPサーバー起動のデバッグ
# サーバーを直接テスト
npx -y @anthropic-ai/shopify-dev-mcp@latest

# npm/Nodeの問題を確認
node --version  # 18以上が必要
npm --version

# 必要に応じてnpmキャッシュをクリア
npm cache clean --force

ツールが表示されない​

サーバーを登録したがツールが表示されない場合:

サーバーの再登録
# 削除して再追加
claude mcp remove shopify-dev-mcp
claude mcp add shopify-dev-mcp -s user -- npx -- -y @anthropic-ai/shopify-dev-mcp@latest

# Claude Codeを再起動
claude

レスポンスが遅い​

Claude Code起動後の最初の呼び出しは、MCPサーバーの初期化（npxパッケージのダウンロードと起動）が必要なため遅くなることがあります。同じセッション内の後続の呼び出しは高速です。

ネットワークが必要

Shopify Dev MCPサーバーはドキュメントとスキーマデータの取得にネットワークアクセスが必要です。オフライン環境やエアギャップ環境では動作しません。企業プロキシの背後にいる場合、npxがnpmレジストリとShopifyのドキュメントエンドポイントに到達できることを確認してください。

次のステップ​

Shopify Dev MCPサーバーは開発知識を提供します。Shopifyストアに対する実際の操作（商品の作成、注文の管理など）を行うには、ストア接続MCPサーバーが必要です。Shopify Store MCPサーバーに進んで、ストアデータアクセスをセットアップしましょう。