MCP 도구 레퍼런스
공식 및 커뮤니티 서버의 Shopify MCP 도구에 대한 완전한 레퍼런스입니다. 필요한 작업을 빠르게 찾을 수 있도록 도메인별로 정리되어 있습니다.
도구 가용성
모든 도구가 모든 MCP 서버에서 사용 가능한 것은 아닙니다. 서버 열은 각 도구를 제공하는 서버를 나타냅니다. 서버별 세부 사항은 커뮤니티 MCP 서버를 참조하세요.
- Dev = 공식 Shopify Dev MCP
- GeLi = shopify-mcp (GeLi2001)
- Ajackus = @ajackus/shopify-mcp-server
- Composio = Composio Shopify MCP
상품
get_products
선택적 필터링과 함께 상품 목록을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
limit | number | 아니오 | 반환할 상품 수 (기본값: 50, 최대: 250) |
title | string | 아니오 | 상품명으로 필터 (부분 일치) |
product_type | string | 아니오 | 상품 유형으로 필터 |
vendor | string | 아니오 | 공급업체명으로 필터 |
status | string | 아니오 | 상태로 필터: active, draft, archived |
collection_id | string | 아니오 | 컬렉션 소속으로 필터 |
created_at_min | string | 아니오 | ISO 8601 날짜 -- 이 날짜 이후 생성된 상품 |
updated_at_min | string | 아니오 | ISO 8601 날짜 -- 이 날짜 이후 업데이트된 상품 |
cursor | string | 아니오 | 다음 페이지를 위한 페이지네이션 커서 |
서버: GeLi, Ajackus, Composio
예시:
Get all active products from vendor "Nike" updated in the last 7 days
get_product
ID로 단일 상품의 전체 세부 정보를 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
product_id | string | 예 | Shopify 상품 GID (예: gid://shopify/Product/123456) |
fields | string[] | 아니오 | 반환할 특정 필드 |
서버: GeLi, Ajackus, Composio
예시:
Get the full details for product gid://shopify/Product/8234567890
create_product
선택적 옵션과 미디어를 포함하여 새 상품을 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
title | string | 예 | 상품명 |
description | string | 아니오 | 상품 설명 (HTML 지원) |
product_type | string | 아니오 | 분류용 상품 유형 |
vendor | string | 아니오 | 공급업체명 |
tags | string[] | 아니오 | 태그 배열 |
status | string | 아니오 | active, draft, 또는 archived (기본값: draft) |
variants | object[] | 아니오 | 옵션 객체 배열 |
variants[].title | string | 아니오 | 옵션명 |
variants[].price | string | 아니오 | 옵션 가격 |
variants[].sku | string | 아니오 | SKU 코드 |
variants[].inventory_quantity | number | 아니오 | 초기 재고 |
variants[].option1 | string | 아니오 | 첫 번째 옵션 값 (예: "Small") |
variants[].option2 | string | 아니오 | 두 번째 옵션 값 (예: "Red") |
variants[].option3 | string | 아니오 | 세 번째 옵션 값 |
options | object[] | 아니오 | 상품 옵션 (예: Size, Color) |
metafields | object[] | 아니오 | 상품 메타필드 |
images | object[] | 아니오 | 첨부할 이미지 URL |
서버: GeLi, Ajackus, Composio
예시:
Create a new draft product:
- Title: "Organic Cotton T-Shirt"
- Type: "Apparel"
- Vendor: "EcoWear"
- Tags: ["organic", "cotton", "sustainable"]
- Options: Size (S, M, L, XL), Color (White, Black, Navy)
- Base price: $29.99
update_product
기존 상품의 필드를 업데이트합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
product_id | string | 예 | Shopify 상품 GID |
title | string | 아니오 | 업데이트할 상품명 |
description | string | 아니오 | 업데이트할 설명 |
product_type | string | 아니오 | 업데이트할 상품 유형 |
vendor | string | 아니오 | 업데이트할 공급업체 |
tags | string[] | 아니오 | 업데이트할 태그 (기존 태그 대체) |
status | string | 아니오 | 업데이트할 상태 |
metafields | object[] | 아니오 | 설정 또는 업데이트할 메타필드 |
서버: GeLi, Ajackus, Composio
delete_product
상품을 영구적으로 삭제합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
product_id | string | 예 | Shopify 상품 GID |
서버: GeLi, Composio
파괴적 작업
상품 삭제는 영구적이며 실행 취소할 수 없습니다. AI 어시스턴트는 이 도구를 실행하기 전에 항상 확인해야 합니다.
search_products
상품 카탈로그 전체 텍스트 검색.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
query | string | 예 | 검색 쿼리 (상품명, 설명, SKU, 태그에서 검색) |
limit | number | 아니오 | 최대 결과 수 (기본값: 25) |
서버: GeLi, Composio
manage_product_media
상품 이미지와 동영상을 추가, 제거, 또는 재정렬합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
product_id | string | 예 | Shopify 상품 GID |
action | string | 예 | add, remove, reorder |
media_urls | string[] | 아니오 | 추가할 미디어 URL |
media_ids | string[] | 아니오 | 제거 또는 재정렬할 미디어 GID |
서버: GeLi
manage_product_metafields
상품 메타필드를 생성, 업데이트, 또는 삭제합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
product_id | string | 예 | Shopify 상품 GID |
metafields | object[] | 예 | 메타필드 작업 배열 |
metafields[].namespace | string | 예 | 메타필드 네임스페이스 |
metafields[].key | string | 예 | 메타필드 키 |
metafields[].value | string | 예 | 메타필드 값 |
metafields[].type | string | 예 | 메타필드 타입 (single_line_text_field, number_integer, json 등) |
서버: GeLi, Composio
옵션 (Variants)
get_variants
상품의 옵션 목록을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
product_id | string | 예 | Shopify 상품 GID |
서버: GeLi, Ajackus, Composio
update_variant
옵션 세부 정보(가격, SKU, 무게 등)를 업데이트합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
variant_id | string | 예 | Shopify 옵션 GID |
price | string | 아니오 | 새 가격 |
compare_at_price | string | 아니오 | 비교 가격 |
sku | string | 아니오 | SKU 코드 |
barcode | string | 아니오 | 바코드 |
weight | number | 아니오 | 무게 값 |
weight_unit | string | 아니오 | kg, g, lb, oz |
requires_shipping | boolean | 아니오 | 옵션에 배송이 필요한지 여부 |
taxable | boolean | 아니오 | 옵션이 과세 대상인지 여부 |
서버: GeLi, Ajackus, Composio
주문
get_orders
필터링 옵션과 함께 주문을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
limit | number | 아니오 | 주문 수 (기본값: 50) |
status | string | 아니오 | open, closed, cancelled, any |
financial_status | string | 아니오 | authorized, pending, paid, partially_paid, refunded, voided |
fulfillment_status | string | 아니오 | shipped, partial, unshipped, unfulfilled |
created_at_min | string | 아니오 | ISO 8601 날짜 |
created_at_max | string | 아니오 | ISO 8601 날짜 |
customer_id | string | 아니오 | 고객별 필터 |
cursor | string | 아니오 | 페이지네이션 커서 |
서버: GeLi, Ajackus, Composio
예시:
Get all unfulfilled paid orders from the last 24 hours
get_order
라인 아이템, 배송, 결제를 포함한 단일 주문의 전체 세부 정보를 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_id | string | 예 | Shopify 주문 GID |
서버: GeLi, Ajackus, Composio
create_draft_order
수동 처리를 위한 초안 주문을 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
line_items | object[] | 예 | 라인 아이템 배열 |
line_items[].variant_id | string | 예 | 옵션 GID |
line_items[].quantity | number | 예 | 수량 |
customer | object | 아니오 | 고객 정보 |
shipping_address | object | 아니오 | 배송 주소 |
billing_address | object | 아니오 | 청구 주소 |
note | string | 아니오 | 주문 메모 |
tags | string[] | 아니오 | 주문 태그 |
discount | object | 아니오 | 주문 수준 할인 |
서버: GeLi, Composio
fulfill_order
주문에 대한 발송 처리를 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_id | string | 예 | Shopify 주문 GID |
tracking_number | string | 아니오 | 배송 추적 번호 |
tracking_company | string | 아니오 | 배송 업체명 |
tracking_url | string | 아니오 | 추적 URL |
notify_customer | boolean | 아니오 | 알림 이메일 발송 여부 (기본값: true) |
line_items | object[] | 아니오 | 발송할 특정 라인 아이템 (부분 발송) |
서버: GeLi, Ajackus, Composio
cancel_order
열린 주문을 취소합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_id | string | 예 | Shopify 주문 GID |
reason | string | 아니오 | customer, fraud, inventory, declined, other |
refund | boolean | 아니오 | 환불 처리 여부 |
restock | boolean | 아니오 | 상품 재입고 여부 |
notify_customer | boolean | 아니오 | 취소 이메일 발송 여부 |
서버: GeLi, Composio
refund_order
주문에 대한 환불을 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_id | string | 예 | Shopify 주문 GID |
refund_line_items | object[] | 아니오 | 환불할 특정 아이템 |
shipping_refund | object | 아니오 | 환불할 배송 금액 |
note | string | 아니오 | 환불 사유 |
notify_customer | boolean | 아니오 | 환불 알림 발송 여부 |
서버: GeLi, Composio
고객
get_customers
필터링과 함께 고객을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
limit | number | 아니오 | 고객 수 (기본값: 50) |
query | string | 아니오 | 검색 쿼리 (이름, 이메일, 전화번호) |
created_at_min | string | 아니오 | ISO 8601 날짜 |
tags | string | 아니오 | 태그별 필터 |
cursor | string | 아니오 | 페이지네이션 커서 |
서버: GeLi, Ajackus, Composio
get_customer
주문 내역이 포함된 단일 고객을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
customer_id | string | 예 | Shopify 고객 GID |
서버: GeLi, Ajackus, Composio
create_customer
새 고객 레코드를 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
first_name | string | 아니오 | 이름 |
last_name | string | 아니오 | 성 |
email | string | 아니오 | 이메일 주소 |
phone | string | 아니오 | 전화번호 |
tags | string[] | 아니오 | 고객 태그 |
note | string | 아니오 | 내부 메모 |
addresses | object[] | 아니오 | 고객 주소 |
metafields | object[] | 아니오 | 고객 메타필드 |
email_marketing_consent | boolean | 아니오 | 이메일 마케팅 동의 |
sms_marketing_consent | boolean | 아니오 | SMS 마케팅 동의 |
서버: GeLi, Ajackus, Composio
update_customer
고객 정보를 업데이트합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
customer_id | string | 예 | Shopify 고객 GID |
first_name | string | 아니오 | 업데이트할 이름 |
last_name | string | 아니오 | 업데이트할 성 |
email | string | 아니오 | 업데이트할 이메일 |
phone | string | 아니오 | 업데이트할 전화번호 |
tags | string[] | 아니오 | 업데이트할 태그 |
note | string | 아니오 | 업데이트할 메모 |
서버: GeLi, Ajackus, Composio
search_customers
다양한 기준으로 고객을 검색합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
query | string | 예 | 검색어 |
limit | number | 아니오 | 최대 결과 수 |
서버: GeLi, Composio
재고
get_inventory_levels
위치별 재고 수준을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
inventory_item_id | string | 아니오 | 특정 재고 아이템 GID |
location_id | string | 아니오 | 특정 위치 GID |
product_id | string | 아니오 | 상품의 모든 재고 조회 |
서버: GeLi, Ajackus, Composio
예시:
Show me inventory levels for all variants of product gid://shopify/Product/123
across all warehouse locations
adjust_inventory
특정 위치의 재고 수량을 조정합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
inventory_item_id | string | 예 | 재고 아이템 GID |
location_id | string | 예 | 위치 GID |
adjustment | number | 예 | 수량 변경 (양수 또는 음수) |
reason | string | 아니오 | 사유: correction, received, damaged, shrinkage, promotion |
서버: GeLi, Ajackus, Composio
재고 조정
재고 조정은 상대적이며 절대적이지 않습니다. -5 조정은 현재 수량에서 5단위를 제거합니다. 대규모 조정 전에 현재 수준을 반드시 확인하세요.
set_inventory
재고를 특정 수량으로 설정합니다 (절대값).
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
inventory_item_id | string | 예 | 재고 아이템 GID |
location_id | string | 예 | 위치 GID |
quantity | number | 예 | 새 수량 |
reason | string | 아니오 | 변경 사유 |
서버: GeLi, Composio
get_locations
모든 재고 위치를 나열합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
active | boolean | 아니오 | 활성/비활성 위치 필터 |
서버: GeLi, Ajackus, Composio
transfer_inventory
위치 간 재고를 이전합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
inventory_item_id | string | 예 | 재고 아이템 GID |
from_location_id | string | 예 | 출발 위치 GID |
to_location_id | string | 예 | 목적지 위치 GID |
quantity | number | 예 | 이전할 수량 |
서버: GeLi
컬렉션
get_collections
컬렉션을 조회합니다 (스마트 및 커스텀).
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
limit | number | 아니오 | 컬렉션 수 |
type | string | 아니오 | smart, custom, 또는 all |
title | string | 아니오 | 제목으로 필터 |
서버: GeLi, Composio
create_collection
새 컬렉션을 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
title | string | 예 | 컬렉션 제목 |
description | string | 아니오 | 컬렉션 설명 (HTML) |
type | string | 예 | smart 또는 custom |
rules | object[] | 아니오 | 스마트 컬렉션 규칙 (smart 타입 필수) |
rules[].column | string | 예 | 규칙 열: title, type, vendor, tag, price, weight, variant_title |
rules[].relation | string | 예 | equals, not_equals, greater_than, less_than, starts_with, ends_with, contains |
rules[].condition | string | 예 | 규칙 값 |
disjunctive | boolean | 아니오 | true = 하나의 규칙 일치, false = 모든 규칙 일치 |
sort_order | string | 아니오 | alpha-asc, alpha-desc, best-selling, created, created-desc, manual, price-asc, price-desc |
image | string | 아니오 | 컬렉션 이미지 URL |
서버: GeLi, Composio
예시:
Create a smart collection called "Summer Sale" that includes all
products tagged "summer" with price less than $50, sorted by best-selling
add_products_to_collection
커스텀 컬렉션에 상품을 추가합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
collection_id | string | 예 | 컬렉션 GID |
product_ids | string[] | 예 | 추가할 상품 GID 배열 |
서버: GeLi, Composio
remove_products_from_collection
커스텀 컬렉션에서 상품을 제거합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
collection_id | string | 예 | 컬렉션 GID |
product_ids | string[] | 예 | 제거할 상품 GID 배열 |
서버: GeLi, Composio
할인
get_discounts
활성 및 예약된 할인 목록을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
limit | number | 아니오 | 할인 수 |
type | string | 아니오 | code, automatic, 또는 all |
status | string | 아니오 | active, expired, scheduled |
서버: GeLi, Composio
create_discount_code
코드 기반 할인을 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
title | string | 예 | 내부 할인 제목 |
code | string | 예 | 고객이 입력하는 할인 코드 |
type | string | 예 | percentage, fixed_amount, free_shipping |
value | number | 예 | 할인 값 (퍼센트 또는 금액) |
applies_to | string | 아니오 | all_products, specific_collections, specific_products |
collection_ids | string[] | 아니오 | 컬렉션 GID (applies_to가 specific_collections일 때) |
product_ids | string[] | 아니오 | 상품 GID (applies_to가 specific_products일 때) |
minimum_requirement | object | 아니오 | 최소 구매 금액 또는 수량 |
usage_limit | number | 아니오 | 이 할인의 총 사용 가능 횟수 |
once_per_customer | boolean | 아니오 | 고객당 1회 사용 제한 |
starts_at | string | 아니오 | ISO 8601 시작 날짜 |
ends_at | string | 아니오 | ISO 8601 종료 날짜 |
서버: GeLi, Composio
예시:
Create a discount code "SPRING25" for 25% off all products in the
"Spring Collection", minimum purchase $50, limited to 500 uses,
valid March 1-31 2026
create_automatic_discount
결제 시 자동 적용되는 할인을 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
title | string | 예 | 할인 제목 (고객에게 표시) |
type | string | 예 | percentage, fixed_amount, buy_x_get_y, free_shipping |
value | number | 예 | 할인 값 |
minimum_requirement | object | 아니오 | 최소 구매 요건 |
starts_at | string | 예 | ISO 8601 시작 날짜 |
ends_at | string | 아니오 | ISO 8601 종료 날짜 |
서버: GeLi, Composio
delete_discount
할인을 삭제합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
discount_id | string | 예 | 할인 GID |
서버: GeLi, Composio
분석
get_shop_info
스토어 정보와 설정을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| (없음) | 전체 스토어 세부 정보를 반환합니다 |
서버: GeLi, Ajackus, Composio
반환값: 스토어 이름, 도메인, 이메일, 통화, 시간대, 플랜, 기능 등.
get_order_count
선택적 날짜 필터링과 함께 주문 수를 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
status | string | 아니오 | open, closed, cancelled, any |
financial_status | string | 아니오 | 결제 상태 필터 |
fulfillment_status | string | 아니오 | 발송 상태 필터 |
created_at_min | string | 아니오 | ISO 8601 날짜 |
created_at_max | string | 아니오 | ISO 8601 날짜 |
서버: GeLi, Composio
get_sales_report
날짜 범위에 대한 매출 분석을 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
start_date | string | 예 | ISO 8601 시작 날짜 |
end_date | string | 예 | ISO 8601 종료 날짜 |
group_by | string | 아니오 | day, week, month |
서버: Adzviser, ShopifyPy
get_top_products
매출 또는 수량 기준 베스트셀러 상품을 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
start_date | string | 예 | ISO 8601 시작 날짜 |
end_date | string | 예 | ISO 8601 종료 날짜 |
limit | number | 아니오 | 상품 수 (기본값: 10) |
sort_by | string | 아니오 | revenue 또는 quantity |
서버: Adzviser, ShopifyPy
문서 도구 (공식 Dev MCP)
이 도구들은 공식 Shopify Dev MCP 서버에서만 사용할 수 있습니다:
| 도구 | 설명 |
|---|---|
search_docs | 전체 Shopify 개발자 문서에 대한 전체 텍스트 검색 |
explore_api_schema | Shopify GraphQL API 스키마 탐색 |
get_liquid_reference | Liquid 템플릿 언어 레퍼런스 접근 |
get_function_reference | Shopify Functions API 레퍼런스 및 스캐폴딩 |
validate_graphql | Shopify 스키마에 대한 GraphQL 쿼리 검증 |
자세한 파라미터 문서는 공식 MCP 서버 페이지를 참조하세요.
일반적인 도구 패턴
대량 작업
많은 작업을 대량 워크플로우로 구성할 수 있습니다:
1. Get all products tagged "clearance" → get_products with tag filter
2. For each product, reduce price by 50% → update_variant (loop)
3. Move products to "Sale" collection → add_products_to_collection
4. Create a "CLEARANCE50" discount code → create_discount_code
감사 워크플로우
1. Get all products → get_products (paginated)
2. Check each for missing descriptions → filter in AI
3. Check inventory levels → get_inventory_levels
4. Flag products with zero stock → adjust_inventory or archive
고객 서비스
1. Search customer by email → search_customers
2. Get their recent orders → get_orders with customer_id
3. Check order fulfillment status → get_order
4. Process refund if needed → refund_order
Dev MCP + Store MCP 결합
가장 강력한 패턴은 Dev MCP (문서용)와 Store MCP (실시간 데이터용)를 결합하는 것입니다. Claude에게 문서에서 올바른 API 접근 방법을 찾은 다음 스토어에 실행하도록 요청하세요 -- 모두 하나의 대화에서 가능합니다.