公式 Shopify Dev MCP Server
Shopify Dev MCP Server（@anthropic-ai/shopify-dev-mcp）は Shopify と Anthropic が共同構築した公式 Model Context Protocol Server です。AI アシスタントに Shopify の開発者ドキュメント、API スキーマ、Liquid テンプレート、Functions スキャフォールディングへの深いアクセスを提供します——すべて自然言語を通じて。
この Server が不可欠な理由
これは Shopify 開発ワークフローに追加できる最もインパクトのある単一ツールです。ドキュメントの手動検索、API バージョンの相互参照、Liquid 構文の推測が不要になります。AI アシスタントがシニア Shopify 開発者と同等の知識を持ち、常に最新の API バージョンに対応します。
概要
| Detail | Value |
|---|---|
| Package | @anthropic-ai/shopify-dev-mcp |
| npm | npmjs.com/package/@anthropic-ai/shopify-dev-mcp |
| GitHub | github.com/anthropics/shopify-dev-mcp |
| Maintained by | Anthropic + Shopify Developer Relations |
| Transport | stdio (local) |
| Auth Required | No |
| Node.js | 18+ |
コア機能
1. ドキュメント検索
Shopify の開発者ドキュメント全体を検索します：
- Admin API reference (GraphQL / REST)
- Storefront API reference
- App development guides
- Theme development docs
- Hydrogen / Oxygen docs
- Shopify Functions docs
- Checkout extensibility guides
- Partner documentation
Example prompt:
"Search the Shopify docs for how to implement a delivery customization function"
2. API スキーマ探索
任意の Shopify API バージョンの完全な GraphQL スキーマを探索：
- Browse types, queries, mutations, and subscriptions
- View field-level documentation and deprecation notices
- Compare schemas across API versions
- Understand input types and required fields
Example prompt:
"Show me the ProductInput type for the 2026-01 API version.
What fields are required vs optional?"
3. Liquid 検証とリファレンス
完全な Liquid テンプレート言語ドキュメントにアクセス：
- Object properties and filters
- Tag syntax and behavior
- Section and block schemas
- Theme architecture patterns
Example prompt:
"What Liquid filters are available for formatting money in Shopify?
Show me examples with multi-currency support."
4. Functions スキャフォールディング
Shopify Functions 開発のガイダンスを取得：
- Available function APIs and their input/output schemas
- Rust and JavaScript implementation patterns
- Testing strategies for functions
- Deployment workflows
Example prompt:
"Help me scaffold a delivery customization function that blocks
shipping to PO boxes for oversized items."
セットアップ手順
Claude Code（推奨）
Claude Code はファーストクラスの MCP サポートを備えています。セットアップは一つのコマンドで完了：
# Add the server to your project
claude mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest
接続の確認：
# Start Claude Code
claude
# Then ask:
> What Shopify MCP tools do you have available?
グローバルインストール（すべてのプロジェクトで利用可能）：
claude mcp add --scope user shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest
Claude Code スコープオプション
--scope project(default): Available only in the current project. Config stored in.claude/.--scope user: Available globally. Config stored in~/.claude/.
Cursor
{
"mcpServers": {
"shopify-dev": {
"command": "npx",
"args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
}
}
}
Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"shopify-dev": {
"command": "npx",
"args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
}
}
}
Codex (OpenAI)
codex mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest
Windsurf
{
"mcpServers": {
"shopify-dev": {
"command": "npx",
"args": ["-y", "@anthropic-ai/shopify-dev-mcp@latest"]
}
}
}
ツールリファレンス
Shopify Dev MCP Server は以下のツールを公開します：
search_docs
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query text |
topic | string | No | Filter: admin-api, storefront-api, hydrogen, functions, themes, apps, checkout |
version | string | No | API version (e.g., 2026-01) |
explore_api_schema
| Parameter | Type | Required | Description |
|---|---|---|---|
type_name | string | No | GraphQL type (e.g., Product, OrderInput) |
query | string | No | Search pattern |
api | string | No | admin (default), storefront |
version | string | No | API version |
get_liquid_reference
| Parameter | Type | Required | Description |
|---|---|---|---|
object | string | No | Liquid object (e.g., product, cart) |
filter | string | No | Liquid filter (e.g., money, img_url) |
tag | string | No | Liquid tag (e.g., for, if, section) |
get_function_reference
| Parameter | Type | Required | Description |
|---|---|---|---|
function_type | string | No | Function API type |
language | string | No | rust, javascript |
validate_graphql
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | GraphQL query/mutation to validate |
api | string | No | admin or storefront |
version | string | No | API version |
実用的な使用例
Example 1
I'm building a Shopify app that syncs inventory across multiple locations.
Search the docs for:
1. The inventory management APIs
2. Webhook topics related to inventory changes
3. Best practices for real-time inventory sync
Then show me the GraphQL mutations I'll need.
Example 2
My product page isn't showing variant-specific metafields.
Get the Liquid reference for:
1. The product.variants object
2. How to access metafields on variants
3. The metafield Liquid filter
Show me a working code example.
Example 3
I need to migrate my app from API version 2025-07 to 2026-01.
1. What breaking changes affect the Product type?
2. Show me the deprecated fields I need to update
3. What new fields are available?
効果的な使い方のヒント
ベストプラクティス
- Be specific with queries -- "product creation mutation with media" > "products"
- Specify API versions -- Always mention your target version
- Combine tools -- Search docs first, then explore the schema, then validate
- Use topic filters -- Narrow results to the relevant area
- Iterate on results -- Refine with additional context if too broad
Prompt Patterns
# Pattern: Research then build
"Search Shopify docs for [topic]. Based on what you find,
write a [component/function/mutation] that [requirement]."
# Pattern: Schema-first development
"Explore the [TypeName] in the admin API schema.
Show me all required fields, then write a mutation using them."
# Pattern: Validation loop
"Here's my GraphQL mutation: [code]. Validate it against the
2026-01 schema and fix any issues."
トラブルシューティング
Server が起動しない
node --version # Should be 18+
npx -y @anthropic-ai/shopify-dev-mcp@latest --help
Claude Code にツールが表示されない
claude mcp list
claude mcp remove shopify-dev
claude mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest
古いドキュメント結果
claude mcp remove shopify-dev
claude mcp add shopify-dev -- npx -y @anthropic-ai/shopify-dev-mcp@latest
応答が遅い
- Check your internet connection
- Try more specific queries
- Ensure you are running the latest server version
この Server がしないこと
warning
Shopify Dev MCP Server はドキュメントと API スキーマへのアクセスを提供します。以下は行いません：
- 実際の Shopify ストアへの接続
- ストアデータ（製品、注文など）の作成、読取、更新、削除
- ストアの分析やレポートへのアクセス
- Partner アカウントや App の管理
ストア管理機能については、Shopify Admin API に接続する Server を扱う Community MCP Servers ガイドを参照してください。
アップデートと変更履歴
Server はアクティブにメンテナンスされています。主要なアップデートは通常 Shopify の四半期 API リリースに合わせます：
- API 2026-01 -- Full schema support added
- Functions scaffolding -- JavaScript and Rust templates
- Checkout extensibility -- Extension target documentation
- Liquid 2026 -- Updated object and filter reference
最新の変更については npm ページ または GitHub リリース をご確認ください。