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

출력에 stdio 전송을 가진 shopify-dev-mcp가 표시되어야 합니다.

Cursor​

Cursor MCP 설정에 다음을 추가합니다:

.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
항상 @latest를 사용하세요

@latest 태그는 업데이트된 문서와 스키마 데이터가 포함된 최신 버전을 받도록 보장합니다. Shopify의 API는 분기별 릴리스마다 발전하며, MCP 서버도 그에 맞게 업데이트됩니다.

사용 가능한 도구​

introspect_admin_schema​

서버에서 가장 강력한 도구입니다. Shopify의 GraphQL Admin API 스키마를 쿼리하여 타입, 필드, 인자 및 정확한 시그니처를 발견할 수 있습니다.

사용 사례:

  • 쿼리 작성 전 타입에서 사용 가능한 필드 발견
  • 뮤테이션 입력 요구사항 확인
  • 필드의 올바른 enum 값 찾기
  • 타입 관계 이해 (연결, edge, node)
스키마 버전 인식

인트로스펙션된 스키마는 특정 API 버전을 반영합니다. 이전 API 버전으로 작업하는 경우 일부 필드나 뮤테이션을 사용할 수 없을 수 있습니다. 항상 프로젝트의 대상 API 버전과 교차 참조하세요.

search_dev_docs​

Shopify의 공식 개발자 문서를 검색하고 관련 기사, 가이드, API 참조를 반환합니다.

get_started​

다양한 Shopify 개발 경로를 위한 구조화된 시작 콘텐츠를 제공합니다.

validate_theme​

테마 파일에 대해 Shopify Theme Check를 실행하여 Liquid 코드 문제, 성능 문제, 모범 사례 위반을 식별합니다.

Claude Code의 파일 접근과 결합

Claude Code는 단일 워크플로우에서 테마 파일을 읽고 MCP를 통해 검증할 수 있습니다. "모든 테마 검증 오류를 수정해주세요"라고 요청하면 검증하고, 문제를 식별하고, 파일을 편집하고, 재검증합니다 -- 모두 자율적으로.

모범 사례​

최대 효과를 위한 도구 결합​

여러 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

OPT_OUT_INSTRUMENTATION 환경 변수​

Shopify Dev MCP 서버는 기본적으로 익명 사용 텔레메트리를 수집합니다. 옵트아웃하려면:

텔레메트리 옵트아웃으로 등록
claude mcp add shopify-dev-mcp -s user -e OPT_OUT_INSTRUMENTATION=1 -- npx -- -y @anthropic-ai/shopify-dev-mcp@latest
텔레메트리는 익명입니다

텔레메트리 데이터에는 도구 사용 패턴만 포함됩니다 -- 코드, 프롬프트 또는 스토어 데이터는 포함되지 않습니다.

문제 해결​

서버가 시작되지 않을 때​

MCP 서버 시작 디버깅
npx -y @anthropic-ai/shopify-dev-mcp@latest
node --version  # 18 이상이어야 합니다
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
네트워크 필요

Shopify Dev MCP 서버는 문서와 스키마 데이터를 가져오기 위해 네트워크 접근이 필요합니다. 오프라인 환경에서는 작동하지 않습니다.

다음 단계​

Shopify Dev MCP 서버는 개발 지식을 제공합니다. Shopify 스토어에서 실제 작업을 수행하려면 스토어에 연결된 MCP 서버가 필요합니다. Shopify Store MCP 서버로 진행하여 스토어 데이터 접근을 설정하세요.