Skip to main content
Glama
Shopify MCP Server

Shopify MCP Server

Shopify MCP 서버

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

특징

  • 제품 관리 : 제품 정보 검색 및 검색

  • 고객 관리 : 고객 데이터를 로드하고 고객 태그를 관리합니다.

  • 주문 관리 : 고급 주문 조회 및 필터링

  • GraphQL 통합 : Shopify의 GraphQL 관리 API와 직접 통합

  • 포괄적인 오류 처리 : API 및 인증 문제에 대한 명확한 오류 메시지

Related MCP server: Shopify MCP Server

도구

  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 (선택적 문자열): 주문에 대한 선택적인 메모

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

  1. complete-draft-order

  • 초안 주문 완료

  • 입력:

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

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

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

  1. get-collections

  • 모든 컬렉션 가져오기

  • 입력:

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

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

  • 반품: 컬렉션 세부 정보

  1. get-shop

  • 매장 세부 정보 받기

  • 입력: 없음

  • 반품: 기본 매장 정보

  1. get-shop-details

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

  • 입력: 없음

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

  1. 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. 종속성 설치:

npm install
  1. .env 파일을 만듭니다.

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com
  1. 프로젝트를 빌드하세요:

npm run build
  1. 테스트 실행:

npm test

종속성

  • @modelcontextprotocol/sdk - MCP 프로토콜 구현

  • graphql-request - Shopify API용 GraphQL 클라이언트

  • zod - 런타임 유형 검증

기여하다

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

특허

MIT

지역 사회


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

Available Tools

15 tools
complete-draft-orderC

Complete a draft order

Inputs: draftOrderId (required), variantId (required).

create-discountC

Create a basic discount code

Inputs: title (required), code (required), valueType (required), value (required), +3 more.

create-draft-orderC

Create a draft order

Inputs: lineItems (required), email (required), shippingAddress (required), note.

get-collectionsC

Get all collections

Inputs: limit, name.

get-customersC

Get shopify customers with pagination support

Inputs: limit, next.

get-orderC

Get a single order by ID

Inputs: orderId (required).

get-ordersC

Get shopify orders with advanced filtering and sorting

Inputs: first, after, query, sortKey, +1 more.

get-productsC

Get all products or search by title

Inputs: limit (required), searchTitle.

get-products-by-collectionC

Get products from a specific collection

Inputs: collectionId (required), limit.

get-products-by-idsC

Get products by their IDs

Inputs: productIds (required).

get-shopC

Get shop details

Inputs: no named parameters.

get-shop-detailsB

Get extended shop details including shipping countries

Inputs: no named parameters.

get-variants-by-idsC

Get product variants by their IDs

Inputs: variantIds (required).

manage-webhookC

Subscribe, find, or unsubscribe webhooks

Inputs: action (required), callbackUrl (required), topic (required), webhookId.

tag-customerC

Add tags to a customer

Inputs: customerId (required), tags (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 15 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific Shopify resources like orders, products, customers, and shop details, with clear separation. However, 'get-shop' and 'get-shop-details' could cause confusion as they both retrieve shop information, though descriptions hint at different detail levels.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with hyphens, such as 'create-discount', 'get-products', and 'tag-customer'. This uniformity makes the set predictable and easy to navigate for an agent.

    Tool Count5/5

    With 15 tools, the server is well-scoped for Shopify operations, covering key areas like orders, products, customers, discounts, and webhooks. Each tool appears to serve a specific function without unnecessary bloat.

    Completeness4/5

    The tool set provides good coverage for core Shopify workflows, including CRUD operations for orders, products, and customers, as well as utilities like discounts and webhooks. Minor gaps exist, such as no update or delete tools for products or customers, but agents can likely work around these with available tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers