Shopify Admin MCP

A1 Shopify Admin MCP는 Admin API(GraphQL)를 통해 Shopify 스토어 관리자 패널에 AI 애플리케이션을 연결합니다. 자연어로 상품과 가격, 주문, 고객, 재고, 프로모션 코드를 작업하는 데 도움을 줍니다.

서버는 하나의 스토어에 바인딩됩니다. 도메인은 구성으로 설정되고, 토큰은 사용자 지정 앱의 Admin API 액세스 토큰이며, 어떤 도구도 다른 스토어로 이동할 수 없습니다.

• 16가지 도구. 스토어, 상품 및 변형, 주문, 고객, 위치 및 재고, 할인 — 그 외 모든 것을 위한 임의 GraphQL 요청.

• 정직한 HTTP 200. Shopify 변이는 실패해도 200을 반환합니다. 서버는 userErrors를 읽고 거부를 이해 가능한 오류로 변환합니다. data 객체가 없는 200 응답(비어 있거나, 잘렸거나, GraphQL이 아닌 경우)도 빈 결과가 아닌 오류가 됩니다.

• 되돌릴 수 없는 작업이 표시됩니다. 주문 취소(환불 및 상품 반품 결정 포함)와 임의 GraphQL은 destructive로 표시됩니다.

• 비용 버킷 제어. 각 응답은 cost를 전달합니다. 요청 비용과 GraphQL 버킷에 남은 포인트 수입니다.

읽기 전용 요청으로 시작하세요:

스토어의 최근 주문과 재고가 있는 상위 상품을 보여줘.

서버 연결 · 시나리오 보기 · 기술 문서 열기

1분 만에 작동 확인

당신: 스토어의 최근 주문과 재고가 있는 상위 상품을 보여줘.

어시스턴트: 상태와 금액이 포함된 주문, 가격과 재고가 포함된 상품을 보여줍니다. 아무것도 변경되지 않습니다.

당신: SUMMER 프로모션 코드로 2주간 20% 할인을 준비해줘.

어시스턴트: 향후 프로모션 코드의 매개변수(코드, 크기, 기간, 한도)를 보여주고 확인을 요청합니다.

당신: 확인합니다.

• 빠른 시작

• 맡길 수 있는 작업

• 변경될 수 있는 것

• 액세스 얻기

• 설정

• 데이터, 한도 및 백그라운드 작업

• 기술 문서

• 지원

빠른 시작

Node.js 20+, my-store.myshopify.com 형식의 스토어 도메인, 사용자 지정 앱의 Admin API 액세스 토큰(shpat_…)이 필요합니다. 앱을 만들려면 스토어 소유자 권한 또는 앱 개발을 위한 스태프 권한이 필요합니다.

1. 액세스를 얻으세요.

2. AI 애플리케이션에 서버를 추가하세요.

3. 위의 안전한 첫 번째 요청을 보내세요.

Settings → Plugins → MCP servers에서 Add server를 클릭한 다음 SHOPIFY_STORE_DOMAIN 및 SHOPIFY_ACCESS_TOKEN과 함께 npx -y mcp-shopify-admin@latest를 추가하세요.

codex mcp add shopify-admin \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  -- npx -y mcp-shopify-admin@latest
codex mcp list

Codex MCP 문서

claude mcp add \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  --transport stdio --scope user shopify-admin \
  -- npx -y mcp-shopify-admin@latest
claude mcp list

Claude Code MCP 문서

Settings → Developer → Edit Config를 열고 추가하세요:

{"mcpServers":{"shopify-admin":{"command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}}

Edit Config를 사용할 수 없으면 macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json을, Windows에서는 %APPDATA%\Claude\claude_desktop_config.json을 편집하세요. Claude Desktop MCP 문서

macOS/Linux에서는 ~/.cursor/mcp.json에, Windows에서는 %USERPROFILE%\.cursor\mcp.json에 {"mcpServers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}}를 추가하세요. Cursor MCP 문서

MCP: Open User Configuration을 실행하고 추가하세요:

{"servers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"${input:shopify_store_domain}","SHOPIFY_ACCESS_TOKEN":"${input:shopify_access_token}"}}},"inputs":[{"type":"promptString","id":"shopify_store_domain","description":"Домен магазина my-store.myshopify.com"},{"type":"promptString","id":"shopify_access_token","description":"Admin API access token (shpat_…)","password":true}]}

MCP: List Servers 명령으로 서버를 확인하세요. VS Code MCP 문서

맡길 수 있는 작업

• 이번 주 주문과 결제 및 이행 상태를 보여줘.

• 재고가 없는 상품을 찾고 선택한 변형의 가격을 올려줘.

• 새 상품을 초안으로 만들고 설명을 채워줘.

• 재고 조사 후 실제 재고를 설정해줘.

• 사용 한도가 있는 세일 프로모션 코드를 만들어줘.

• 이메일로 고객을 찾고 최근 주문을 보여줘.

변경될 수 있는 것

주문 생성, 배송 실행, 고객 변경, 판매 채널에 상품 게시, 객체 삭제는 도구 세트에 포함되지 않습니다. 필요한 경우 명시적 확인과 함께 graphql_request를 통해 수행됩니다.

액세스 얻기

1. 스토어 관리자 패널을 엽니다: Settings → Apps and sales channels → Develop apps (앱 개발이 꺼져 있으면 켜세요).

2. 앱을 만들고 Configuration 탭에서 필요한 Admin API 액세스 범위를 부여합니다: read_products/write_products, read_orders, read_customers, read_locations/write_inventory, read_discounts/write_discounts — 시나리오에 따라.

3. 앱을 설치하고 API credentials 탭에서 Admin API access token(shpat_…; 한 번만 표시됨)을 복사합니다.

4. 도메인과 토큰을 SHOPIFY_STORE_DOMAIN 및 SHOPIFY_ACCESS_TOKEN으로 전달합니다.

토큰은 정적이며 스토어에 바인딩됩니다. 비밀번호처럼 보관하세요. 나중에 앱에 새 범위를 부여하면 Shopify가 새 토큰을 발급합니다. 변수를 업데이트하고 서버를 다시 시작하세요. 안전한 연습에는 development store가 편리합니다.

설정

데이터, 한도 및 백그라운드 작업

• GraphQL 비용 버킷. 각 요청은 복잡성에 따라 포인트가 소모됩니다. 버킷은 매초 복구됩니다. first 250까지의 한 페이지가 작은 요청 여러 개보다 경제적입니다. 서버는 각 결과와 함께 cost를 표시합니다.

• 일시적 오류. THROTTLED는 버킷 수학에 따른 대기 시간으로 자동 재시도됩니다. 변이는 네트워크 또는 5xx 오류 후 재시도되지 않아 변경이 두 번 적용되지 않습니다.

• 60일 이상 된 주문은 Shopify가 요청 시 발급하는 read_all_orders 범위가 필요합니다. 없으면 오래된 주문은 그냥 오지 않습니다.

• 상시 모니터링 없음. 서버는 호출 시에만 작동합니다. AI 애플리케이션이 예약 작업을 지원하면 주기적으로 주문과 재고를 확인할 수 있습니다.

• 익명 원격 측정. 비밀, 스토어 데이터, 인수 및 프롬프트는 포함되지 않습니다. 비활성화: ASKADS_TELEMETRY=0.

기술 문서

• MCP 기능 카탈로그 — 각 도구에 대한 사용자 작업별 페이지.

• 모든 도구 및 매개변수

• 개발 문서

• 게시 문서

• Shopify Admin API(GraphQL) 문서

지원

오류를 발견했거나 시나리오가 부족한가요? issue를 생성하거나 Telegram으로 문의하세요.