Shopify MCP 서버

Shopify API용 MCP 서버로, GraphQL API를 통해 매장 데이터와의 상호작용을 지원합니다. 이 서버는 제품, 고객, 주문 등을 관리하는 도구를 제공합니다.

특징

• 제품 관리 : 제품 정보 검색 및 검색
• 고객 관리 : 고객 데이터를 로드하고 고객 태그를 관리합니다.
• 주문 관리 : 고급 주문 조회 및 필터링
• GraphQL 통합 : Shopify의 GraphQL 관리 API와 직접 통합
• 포괄적인 오류 처리 : API 및 인증 문제에 대한 명확한 오류 메시지

도구

1. get-products
   • 모든 제품을 가져오거나 제목으로 검색하세요
   • 입력:
     • searchTitle (선택 문자열): 제목으로 제품 필터링
     • limit (숫자): 반품할 최대 제품 수
   • 반품: 제목, 설명, 핸들, 변형을 포함한 형식화된 제품 세부 정보
2. get-products-by-collection
   • 특정 컬렉션에서 제품 가져오기
   • 입력:
     • collectionId (문자열): 제품을 가져올 컬렉션의 ID
     • limit (선택적 숫자, 기본값: 10): 반환할 최대 제품 수
   • 반환: 지정된 컬렉션의 형식화된 제품 세부 정보
3. get-products-by-ids
   • ID로 제품 가져오기
   • 입력:
     • productIds (문자열 배열): 검색할 제품 ID 배열
   • 반환: 지정된 제품에 대한 형식화된 제품 세부 정보
4. get-variants-by-ids
   • ID로 제품 변형 가져오기
   • 입력:
     • variantIds (문자열 배열): 검색할 변형 ID 배열
   • 반품: 제품 세부 정보를 포함한 자세한 변형 정보
5. get-customers
   • 페이지네이션 지원을 통해 Shopify 고객 확보
   • 입력:
     • limit (선택적 숫자): 반환할 최대 고객 수
     • next (선택적 문자열): 다음 페이지 커서
   • 반환: JSON 형식의 고객 데이터
6. tag-customer
   • 고객에게 태그 추가
   • 입력:
     • customerId (문자열): 태그를 지정할 고객 ID
     • tags (문자열 배열): 고객에게 추가할 태그
   • 반환: 성공 또는 실패 메시지
7. get-orders
   • 고급 필터링 및 정렬로 주문 받기
   • 입력:
     • first (선택적 숫자): 반품 주문 제한
     • after (선택적 문자열): 다음 페이지 커서
     • query (선택적 문자열): 쿼리 구문을 사용하여 주문 필터링
     • sortKey (선택적 열거형): 정렬 기준 필드('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')
     • reverse (선택적 부울): 정렬 순서를 반대로 합니다.
   • 반품: 형식화된 주문 세부 정보
8. get-order
   • ID로 단일 주문 받기
   • 입력:
     • orderId (문자열): 검색할 주문의 ID
   • 반품: 자세한 주문 정보
9. create-discount
   • 기본 할인 코드 생성
   • 입력:
     • title (문자열): 할인 제목
     • code (문자열): 고객이 입력할 할인 코드
     • valueType (enum): 할인 유형('percentage' 또는 'fixed_amount')
     • value (숫자): 할인 값(소수점 또는 고정 금액으로 표현된 백분율)
     • startsAt (문자열): ISO 형식의 시작 날짜
     • endsAt (선택적 문자열): ISO 형식의 선택적인 종료 날짜
     • appliesOncePerCustomer (부울): 할인을 고객당 한 번만 사용할 수 있는지 여부
   • 반품: 할인 세부정보 생성됨
10. create-draft-order

• 초안 주문 생성
• 입력:
  • lineItems (배열): variantId와 수량이 포함된 항목 배열
  • email (문자열): 고객 이메일
  • shippingAddress (객체): 배송 주소 세부 정보
  • note (선택적 문자열): 주문에 대한 선택적인 메모
• 반품: 초안 주문 세부 정보 생성됨

11. complete-draft-order

• 초안 주문 완료
• 입력:
  • draftOrderId (문자열): 완료할 초안 주문의 ID
  • variantId (문자열): 초안 주문의 변형 ID
• 반품: 주문 완료 세부 정보

12. get-collections

• 모든 컬렉션 가져오기
• 입력:
  • limit (선택적 숫자, 기본값: 10): 반환할 최대 컬렉션 수
  • name (선택적 문자열): 이름으로 컬렉션 필터링
• 반품: 컬렉션 세부 정보

13. get-shop

• 매장 세부 정보 받기
• 입력: 없음
• 반품: 기본 매장 정보

14. get-shop-details

• 배송 국가를 포함한 확장된 매장 세부 정보를 받아보세요
• 입력: 없음
• 반품: 배송 국가를 포함한 확장된 매장 정보

15. manage-webhook

• 웹후크 구독, 찾기 또는 구독 취소
• 입력:
  • action (enum): 수행할 작업 ('구독', '찾기', '구독 취소')
  • callbackUrl (문자열): 웹훅 콜백 URL
  • topic (열거형): 구독할 웹훅 주제
  • webhookId (선택 문자열): Webhook ID(구독 취소에 필요)
• 반환: Webhook 세부 정보 또는 성공 메시지

설정

Shopify 액세스 토큰

이 MCP 서버를 사용하려면 Shopify 스토어에서 사용자 지정 앱을 만들어야 합니다.

1. Shopify 관리자에서 설정 > 앱 및 판매 채널 로 이동하세요.
2. 앱 개발을 클릭합니다(먼저 개발자 미리보기를 활성화해야 할 수도 있음)
3. 앱 만들기를 클릭하세요
4. 앱 이름을 설정합니다(예: "Shopify MCP 서버")
5. 관리 API 범위 구성을 클릭하세요.
6. 다음 범위를 선택하세요:
   • read_products , write_products
   • read_customers , write_customers
   • read_orders , write_orders
7. 저장을 클릭하세요
8. 앱 설치를 클릭하세요
9. 설치를 클릭하여 앱에 스토어 데이터에 대한 액세스 권한을 부여하세요.
10. 설치 후 Admin API 액세스 토큰이 표시됩니다.
11. 이 토큰을 복사하세요. 구성에 필요합니다.

참고: 액세스 토큰을 안전하게 보관하세요. 액세스 토큰은 스토어 데이터에 대한 접근 권한을 제공하며, 절대 공유하거나 버전 관리에 맡겨서는 안 됩니다. Shopify 앱 생성 방법에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

지엑스피1

개발

1. 저장소를 복제합니다
2. 종속성 설치:

3. .env 파일을 만듭니다.

4. 프로젝트를 빌드하세요:

5. 테스트 실행:

종속성

• @modelcontextprotocol/sdk - MCP 프로토콜 구현
• graphql-request - Shopify API용 GraphQL 클라이언트
• zod - 런타임 유형 검증

기여하다

참여를 환영합니다! 먼저 참여 지침을 읽어주세요.

특허

MIT

지역 사회

• MCP GitHub 토론
• 문제 보고

모델 컨텍스트 프로토콜을 사용하여 ❤️로 구축됨