Skip to main content

공식 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 버전과 동기화됩니다.

개요​

DetailValue
Package@anthropic-ai/shopify-dev-mcp
npmnpmjs.com/package/@anthropic-ai/shopify-dev-mcp
GitHubgithub.com/anthropics/shopify-dev-mcp
Maintained byAnthropic + Shopify Developer Relations
Transportstdio (local)
Auth RequiredNo
Node.js18+

핵심 기능​

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​

ParameterTypeRequiredDescription
querystringYesSearch query text
topicstringNoFilter: admin-api, storefront-api, hydrogen, functions, themes, apps, checkout
versionstringNoAPI version (e.g., 2026-01)

explore_api_schema​

ParameterTypeRequiredDescription
type_namestringNoGraphQL type (e.g., Product, OrderInput)
querystringNoSearch pattern
apistringNoadmin (default), storefront
versionstringNoAPI version

get_liquid_reference​

ParameterTypeRequiredDescription
objectstringNoLiquid object (e.g., product, cart)
filterstringNoLiquid filter (e.g., money, img_url)
tagstringNoLiquid tag (e.g., for, if, section)

get_function_reference​

ParameterTypeRequiredDescription
function_typestringNoFunction API type
languagestringNorust, javascript

validate_graphql​

ParameterTypeRequiredDescription
querystringYesGraphQL query/mutation to validate
apistringNoadmin or storefront
versionstringNoAPI 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?

효과적인 사용을 위한 팁​

모범 사례
  1. Be specific with queries -- "product creation mutation with media" > "products"
  2. Specify API versions -- Always mention your target version
  3. Combine tools -- Search docs first, then explore the schema, then validate
  4. Use topic filters -- Narrow results to the relevant area
  5. 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 릴리스를 확인하세요.