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. update-product-price

   • 해당 ID의 제품 가격 업데이트

   • 입력:

     • productId (문자열): 업데이트할 제품의 ID

     • price (문자열): 제품의 새 가격

   • 반환: 업데이트에 대한 응답

5. get-variants-by-ids

   • ID로 제품 변형 가져오기

   • 입력:

     • variantIds (문자열 배열): 검색할 변형 ID 배열

   • 반품: 제품 세부 정보를 포함한 자세한 변형 정보

6. get-customers

   • 페이지네이션 지원을 통해 Shopify 고객 확보

   • 입력:

     • limit (선택적 숫자): 반환할 최대 고객 수

     • next (선택적 문자열): 다음 페이지 커서

   • 반환: JSON 형식의 고객 데이터

7. tag-customer

   • 고객에게 태그 추가

   • 입력:

     • customerId (문자열): 태그를 지정할 고객 ID

     • tags (문자열 배열): 고객에게 추가할 태그

   • 반환: 성공 또는 실패 메시지

8. get-orders

   • 고급 필터링 및 정렬로 주문 받기

   • 입력:

     • first (선택적 숫자): 반품 주문 제한

     • after (선택적 문자열): 다음 페이지 커서

     • query (선택적 문자열): 쿼리 구문을 사용하여 주문 필터링

     • sortKey (선택적 열거형): 정렬 기준 필드('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')

     • reverse (선택적 부울): 정렬 순서를 반대로 합니다.

   • 반품: 형식화된 주문 세부 정보

9. get-order

   • ID로 단일 주문 받기

   • 입력:

     • orderId (문자열): 검색할 주문의 ID

   • 반품: 자세한 주문 정보

10. create-discount

• 기본 할인 코드 생성

• 입력:

  • title (문자열): 할인 제목

  • code (문자열): 고객이 입력할 할인 코드

  • valueType (enum): 할인 유형('percentage' 또는 'fixed_amount')

  • value (숫자): 할인 값(소수점 또는 고정 금액의 백분율)

  • startsAt (문자열): ISO 형식의 시작 날짜

  • endsAt (선택적 문자열): ISO 형식의 선택적인 종료 날짜

  • appliesOncePerCustomer (부울): 할인을 고객당 한 번만 사용할 수 있는지 여부

• 반품: 할인 세부정보 생성됨

11. create-draft-order

• 초안 주문 생성

• 입력:

  • lineItems (배열): variantId와 수량이 포함된 항목 배열

  • email (문자열): 고객 이메일

  • shippingAddress (객체): 배송 주소 세부 정보

  • note (선택적 문자열): 주문에 대한 선택적인 메모

• 반품: 초안 주문 세부 정보 생성됨

12. complete-draft-order

• 초안 주문 완료

• 입력:

  • draftOrderId (문자열): 완료할 초안 주문의 ID

  • variantId (문자열): 초안 주문의 변형 ID

• 반품: 주문 완료 세부 정보

13. get-collections

• 모든 컬렉션 가져오기

• 입력:

  • limit (선택적 숫자, 기본값: 10): 반환할 최대 컬렉션 수

  • name (선택적 문자열): 이름으로 컬렉션 필터링

• 반품: 컬렉션 세부 정보

14. get-shop

• 매장 세부 정보 받기

• 입력: 없음

• 반품: 기본 매장 정보

15. get-shop-details

• 배송 국가를 포함한 확장된 매장 세부 정보를 받아보세요

• 입력: 없음

• 반품: 배송 국가를 포함한 확장된 매장 정보

16. 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 토론

• 문제 보고

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