
geli2001/shopify-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Claude와 Cursor 같은 MCP 호스트에서 사용할 수 있는 Shopify API용 MCP 서버입니다
개요
Shopify API용 MCP 서버는 GraphQL API를 통해 매장 데이터와 상호작용할 수 있게 합니다. 이 서버는 제품, 고객, 주문 등 다양한 관리를 위한 도구를 제공합니다. - : 제품, 변형, 옵션에 대한 완전한 CRUD (8개 도구) - : 완전한 CRUD, 병합, 주소 관리 (8개 도구) - : 스마트 조회, 취소, 닫기/열기, 결제 표시, 이행, 환불 (10개 도구) - : 모든 자원에서 메타필드 생성, 설정 및 삭제 (3개 도구) - : 위치별 절대 재고 수량 설정 (1개 도구) - : 태그 가능한 자원에 태그 추가/제거 (1개 도구) - : 모든 리스트 쿼리에 커서 기반 페이지네이션 및 정렬 키 - : 모든 리스트 엔드포인트에 대한 패스스루 Shopify 쿼리 문법 - : Shopify의 GraphQL Admin API와의 직접 통합 (2026-01) - : API 및 인증 문제에 대한 명확한 오류 메시지 1. Node.js (버전 18 이상) 2.
개요(AI 번역)
(원하시면 별을 남겨주세요!)
Shopify API용 MCP 서버는 GraphQL API를 통해 매장 데이터와 상호작용할 수 있게 합니다. 이 서버는 제품, 고객, 주문 등 다양한 관리를 위한 도구를 제공합니다.
** 📦 패키지 이름: shopify-mcp**
** 🚀 명령어: shopify-mcp (shopify-mcp-server가 아님)**
특징
- 제품 관리: 제품, 변형 및 옵션에 대한 완전한 CRUD (8개 도구)
- 고객 관리: 완전한 CRUD, 병합, 주소 관리 (8개 도구)
- 주문 관리: 스마트 조회, 취소, 닫기/열기, 결제 표시, 이행, 환불 (10개 도구)
- 메타필드 관리: 모든 리소스에서 메타필드를 얻고, 설정하며, 삭제하기(3개 도구)
- 재고 관리: 장소별 절대 재고 수량 설정 (1개 도구)
- 태그 관리: 태그 가능한 자원에 태그를 추가/제거함 (1개 도구)
- 페이지네이션 및 정렬: 모든 리스트 쿼리에 커서 기반 페이지 및 정렬 키
- 고급 필터링: 모든 리스트 엔드포인트에 대한 패스스루 Shopify 쿼리 문법
- GraphQL 통합: Shopify의 GraphQL Admin API와의 직접 통합 (2026-01)
- 종합 오류 처리: API 및 인증 문제에 대한 명확한 오류 메시지
선수 조건
- 노드.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Shopify MCP Server
(please leave a star if you like!)
MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.
📦 Package Name: shopify-mcp
🚀 Command: shopify-mcp (NOT shopify-mcp-server)
Features
- Product Management: Full CRUD for products, variants, and options (8 tools)
- Customer Management: Full CRUD, merge, and address management (8 tools)
- Order Management: Smart lookup, cancel, close/open, mark as paid, fulfillment, refunds (10 tools)
- Metafield Management: Get, set, and delete metafields on any resource (3 tools)
- Inventory Management: Set absolute inventory quantities at locations (1 tool)
- Tag Management: Add/remove tags on any taggable resource (1 tool)
- Pagination & Sorting: Cursor-based pagination and sort keys on all list queries
- Advanced Filtering: Pass-through Shopify query syntax for all list endpoints
- GraphQL Integration: Direct integration with Shopify’s GraphQL Admin API (2026-01)
- Comprehensive Error Handling: Clear error messages for API and authentication issues
Prerequisites
- Node.js (version 18 or higher)
- A Shopify store with a custom app (see setup instructions below)
Setup
Authentication
This server supports two authentication methods:
Option 1: Client Credentials (Dev Dashboard apps, January 2026+)
As of January 1, 2026, new Shopify apps are created in the Dev Dashboard and use OAuth client credentials instead of static access tokens.
- From your Shopify admin, go to Settings > Apps and sales channels
- Click Develop apps > Build app in dev dashboard
- Create a new app and configure Admin API scopes:
read_products,write_productsread_customers,write_customersread_orders,write_orders
- Install the app on your store
- Copy your Client ID and Client Secret from the app’s API credentials
The server will automatically exchange these for an access token and refresh it before it expires (tokens are valid for ~24 hours).
Option 2: Static Access Token (legacy apps)
If you have an existing custom app with a static shpat_ access token, you can still use it directly.
Usage with Claude Desktop
Client Credentials (recommended):
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": [
"shopify-mcp",
"--clientId",
"",
"--clientSecret",
"",
"--domain",
".myshopify.com"
]
}
}
}
Static Access Token (legacy):
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": [
설치
npx shopify-mcp --clientId <YOUR_CLIENT_ID> --clientSecret <YOUR_CLIENT_SECRET> --domain <YOUR_SHOP>.myshopify.com설정
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": [
"shopify-mcp",
"--clientId",
"<YOUR_CLIENT_ID>",
"--clientSecret",
"<YOUR_CLIENT_SECRET>",
"--domain",
"<YOUR_SHOP>.myshopify.com"
]
}
}
}