이 글의 목차
Shopify는 현재 공식 Catalog MCP 인터페이스 두 가지를 문서화합니다. Global Catalog는 여러 Shopify 판매자의 상품을 검색하고, Storefront Catalog는 한 판매자의 스토어로 범위를 제한합니다. 두 인터페이스 모두 Shopify의 UCP 카탈로그 기능을 사용하며 상품 검색, ID 조회, 옵션 선택 도구를 제공합니다. 문서화된 Catalog MCP는 상품 검색용이며 Shopify Admin 주문이나 카탈로그를 수정하는 기능은 없습니다.
2026년 10월 13일 Shopify는 별도 MCP 연결로 장바구니, 체크아웃, 로그인한 고객의 주문 검색을 추가하는 Shop MCP도 발표했습니다. 에이전트 커머스의 범위가 넓어졌지만 Catalog MCP 자체가 Admin API 편집기로 바뀐 것은 아닙니다.
핵심 답변: Catalog MCP로 상품을 검색하고 옵션을 선택할 수 있습니다. 여러 판매자를 검색하려면 Global Catalog, 한 스토어를 검색하려면 Storefront Catalog를 사용하세요. 체크아웃과 로그인한 고객의 주문 조회는 Shop MCP를 비롯한 별도의 커머스 인터페이스에서 지원합니다.
Shopify Catalog MCP 기능이란?
Catalog MCP는 AI 에이전트가 상품 정보를 찾고 가져올 수 있도록 Shopify가 제공하는 공식 인터페이스입니다. Global Catalog는 Shopify의 대상 판매자 전체에서 검색하고, Storefront Catalog는 한 판매자의 스토어에 한정됩니다. 두 인터페이스는 Shopify의 UCP 카탈로그 기능을 구현하고 동일한 세 가지 MCP 도구를 사용하지만 검색 범위와 응답 필드는 다릅니다.
일반적인 흐름은 두 단계입니다. 먼저 search_catalog는 텍스트, 이미지 또는 상품 식별자로 상품을 찾고, lookup_catalog는 알려진 상품 또는 변형 ID를 확인합니다. 다음으로 get_product는 선택한 상품의 상세 정보, 선택 가능한 옵션 조합, 체크아웃 링크를 반환합니다. 이를 통해 에이전트에 광범위한 Admin API 접근 권한을 주지 않고도 상품을 찾고 옵션을 선택할 수 있습니다.
별도의 @shopify/dev-mcp 패키지는 Shopify 개발 문서와 도구를 제공합니다. 이는 Catalog MCP와 다르며, 장바구니, 체크아웃, 로그인 고객 주문 기능을 추가하는 Shop MCP와도 구분됩니다.
Shopify MCP의 카탈로그 접근 방식
프로토콜 계층: MCP가 하는 일
MCP는 클라이언트가 서버에서 제공하는 도구를 찾고 호출하는 방식을 정의합니다. UCP는 커머스 기능과 카탈로그 요청·응답 형식을 정의합니다. 현재 Shopify Catalog MCP에서 에이전트는 Shopify 엔드포인트로 요청을 보내고 UCP 에이전트 프로필 URL을 포함합니다. 반환되는 도구는 프로필에 선언된 기능에 따라 달라집니다. 이 서비스는 Shopify가 호스팅하므로 문서화된 카탈로그 도구를 호출하기 위해 자체 MCP 서버를 만들 필요는 없습니다.
API 계층: Admin과 Storefront의 차이
Shopify가 문서화한 Catalog MCP 엔드포인트는 두 가지입니다.
- Global Catalog:
https://catalog.shopify.com/api/ucp/mcp는 여러 Shopify 판매자를 검색합니다. - Storefront Catalog:
https://{storeDomain}/api/ucp/mcp는 한 판매자 스토어를 검색합니다.
두 엔드포인트 모두 에이전트 프로필이 필요하며 일반 요청에는 API 키가 필요하지 않습니다. 도구는 카탈로그 검색 데이터를 반환할 뿐 Shopify Admin API를 대신하지 않습니다. 상품이나 주문을 변경하려면 적절한 Shopify API와 권한을 사용하는 별도 앱 또는 연동이 필요합니다. 카탈로그 접근에는 요청 제한이 적용되며 검색 결과와 상품 이미지는 캐시할 수 없습니다. Shopify가 추론된 값이라고 표시한 일부 응답 속성은 누락되거나 정확도가 달라질 수 있습니다. 고객에게 표시하기 전에 최신 사용 지침을 확인하세요.
| 기능 | Global Catalog MCP | Storefront Catalog MCP |
|---|---|---|
| 상품 검색 | 대상 Shopify 판매자 전체 | 한 판매자의 카탈로그 내 |
| 엔드포인트 | https://catalog.shopify.com/api/ucp/mcp |
https://{storeDomain}/api/ucp/mcp |
| 일반 인증 | 에이전트 프로필, API 키 불필요 | 에이전트 프로필, API 키 불필요 |
| 검색 도구 | search_catalog, lookup_catalog, get_product |
동일한 카탈로그 도구 3개 |
| 조회 요청 한도 | 상품 또는 옵션 ID 최대 50개 | 상품 또는 옵션 ID 최대 10개 |
| 상품 상세 정보 | 옵션, 구매 가능 여부 신호, 체크아웃 링크 | 해당 스토어의 옵션, 구매 가능 여부 신호, 체크아웃 링크 |
| 상품·재고·주문 쓰기 | 제공하지 않음 | 제공하지 않음 |
| 체크아웃 실행 | 별도 체크아웃 인터페이스 필요 | 별도 체크아웃 인터페이스 필요 |
Shopify Catalog MCP가 실제로 지원하는 기능
문서화된 Catalog MCP 도구는 다음 작업을 지원합니다.
- 텍스트 검색: 자연어 상품 요청으로 상품을 찾습니다.
- 이미지 및 유사 상품 검색: Global Catalog는 이미지 검색과 상품 ID를 이용한 유사 상품 검색을 지원합니다.
- 검색 결과 필터링: 재고 여부, 가격, 배송 목적지 또는 출발지, 상품 속성 등의 지원 필터를 사용합니다.
- 알고 있는 ID 조회: 최신 상품 또는 변형 데이터를 가져옵니다. Global Catalog는 한 요청에서 최대 50개, Storefront Catalog는 최대 10개 ID를 확인할 수 있습니다.
- 상품 상세 조회:
get_product는 옵션 조합과 재고 신호를 포함한 상품 상세 정보를 반환합니다. - 변형 선택 구체화: 색상이나 사이즈 등 선택한 옵션을 전달해 일치하는 변형과 체크아웃 링크를 확인합니다.
- 전체 또는 단일 스토어 검색: 여러 판매자를 검색하려면 Global Catalog, 한 스토어만 검색하려면 Storefront Catalog를 선택합니다.
이 기능은 상품 검색용입니다. 카탈로그 도구는 가격, 메타필드, 재고, 주문을 수정하거나 체크아웃을 수행하지 않습니다.
구매 후 업무에서 Catalog MCP가 갖는 의미
Catalog MCP는 에이전트가 상품을 찾거나 등록된 옵션을 확인하는 데 도움이 되지만 Shopify 주문을 읽거나 구매 후 변경을 수행하지는 않습니다. 역할을 나누세요. 상품 검색에는 Shopify가 문서화한 에이전트 도구를, 주문 변경에는 주문 관리 앱이나 적절한 권한을 부여한 연동을 사용합니다.
Revize 고객 주문 수정 앱은 판매자가 설정한 수정 가능 시간 동안, 주문 처리 전에 고객이 직접 주문을 변경할 수 있도록 합니다. 편집 가능한 항목은 판매자가 선택합니다. 고객은 Shopify 주문 상태 또는 감사 페이지에서 활성화된 Revize 앱 블록이나 주문 확인 이메일의 Edit Order 링크를 사용합니다. Revize는 변형 교체 시 실시간 재고를 검증합니다. 기간만 설정한다고 주문 처리가 보류되지는 않으며, 필요한 경우 판매자가 알맞은 보류 모드와 규칙을 설정해야 합니다. 기본 주문 편집은 Shopify 주문 편집 가이드를 참조하세요.
에이전트 기반 커머스와 Catalog MCP: 현재 가능한 일과 앞으로의 변화
현재 Shopify의 에이전트 도구는 역할이 각각 다릅니다.
- Catalog MCP: Global 또는 Storefront Catalog를 통한 상품 검색, ID 조회, 상세 정보 및 변형 검색.
- Shop MCP: 2026년 10월 13일 발표된 별도 MCP 서버입니다. 카탈로그 검색, 장바구니 생성, Shopify 스토어 체크아웃 생성, 고객 확인 후 Shop Pay 결제 완료, 로그인한 고객의 주문 검색이 가능합니다. 출시 시점에는
get_checkout을 조회해 주문 상태를 확인하며 릴리스 노트에 따르면 웹훅은 아직 제공되지 않습니다. - Shopify dev MCP: 개발자 문서와 도구이며 판매자 카탈로그 또는 주문 관리 작업을 수행하지 않습니다.
설정하려면 Shopify의 최신 Catalog 가이드 또는 Shop MCP 릴리스 노트를 따르세요. 한 서버의 도구가 다른 서버에서도 제공된다고 가정하지 마세요.
구현 체크리스트
Shopify Catalog MCP를 검토한다면:
- 여러 판매자 또는 한 스토어 중 어디에서 검색할지 결정합니다.
- 해당 엔드포인트와 에이전트 프로필 설정을 확인합니다.
- 재고가 없거나 조건이 모호한 경우도 포함해 검색, ID 조회, 변형 선택을 테스트합니다.
- 요청 제한과 결과 및 이미지 캐시 금지 규칙을 따릅니다.
- 상품 검색, 체크아웃, 구매 후 주문 변경은 각각의 작업을 명시적으로 지원하는 도구에 맡깁니다.
자주 묻는 질문
Catalog MCP는 Shopify의 특정 제품인가요?
네. Shopify Global Catalog MCP는 대상 판매자를 가로질러 검색하고 Storefront Catalog MCP는 한 스토어로 제한됩니다. 개발자용 @shopify/dev-mcp는 별도 서버입니다.
Model Context Protocol이 정확히 무엇인가요?
MCP는 AI 클라이언트가 서버의 도구를 검색하고 호출할 수 있게 하는 프로토콜입니다. Shopify의 카탈로그 구현에서 UCP는 커머스 기능과 MCP로 전달되는 요청·응답 형식을 정의합니다.
Shopify Catalog MCP를 설정하려면 개발자가 필요한가요?
MCP 호환 클라이언트와 에이전트 프로필을 준비한 뒤 해당 Shopify Catalog 엔드포인트를 설정합니다. Shopify가 문서화된 서버를 호스팅하므로 이 도구를 사용하기 위해 자체 MCP 서버를 만들 필요는 없습니다. 복잡한 에이전트 동작에는 개발이 필요할 수 있습니다.
어떤 Shopify 요금제에서 Catalog MCP를 사용할 수 있나요?
Catalog 문서는 엔드포인트와 에이전트 프로필 인증을 설명하지만 플랜별 지원표는 제공하지 않습니다. 원하는 카탈로그 또는 에이전트 기능의 대상 조건을 Shopify 최신 문서에서 확인하세요.
MCP로 Shopify 카탈로그에 쓸 수도 있나요, 아니면 읽기만 가능한가요?
아니요. Catalog MCP는 상품 검색 도구를 제공하며 상품 쓰기나 주문 편집 기능은 없습니다. 별도의 Shop MCP는 장바구니, 체크아웃, 로그인 고객 주문 검색을 추가합니다. Admin API 변경에는 별도 승인된 앱 또는 연동이 필요합니다.
Catalog MCP는 Shopify Flow와 어떻게 다른가요?
Flow는 Shopify Admin에서 이벤트 기반 워크플로를 실행합니다. Catalog MCP는 필요할 때 에이전트가 상품 검색 도구를 호출하도록 합니다. 함께 사용할 수 있지만 Catalog MCP 자체가 Flow 워크플로를 트리거하거나 실행하지는 않습니다.
Catalog MCP에 필요한 Admin API 권한은 무엇인가요?
호스팅된 Catalog MCP 엔드포인트는 에이전트 프로필을 사용하며 일반 요청에는 Admin API 토큰이나 API 키가 필요하지 않습니다. 다른 연동에서 Admin API를 사용하는 경우 필요한 권한만 요청하세요.
Catalog MCP로 Shopify B2B 업무를 처리할 수 있나요?
Catalog MCP 도구는 상품 검색을 위해 문서화되었습니다. 회사 할당이나 전체 B2B 주문 흐름을 제공하지 않습니다. 사용할 API 또는 에이전트 기능의 현재 B2B 카탈로그 및 가격 지원을 확인하고 Plus 전용 Admin API 데이터가 Catalog MCP에 노출된다고 가정하지 마세요.
어떤 AI 클라이언트가 Shopify Catalog MCP와 작동하나요?
엔드포인트에 연결하고 에이전트 프로필을 전달할 수 있는 MCP 호환 클라이언트를 사용하세요. 10월 13일 Shop MCP 릴리스 노트는 Claude 및 ChatGPT와 같은 MCP 클라이언트의 로그인 흐름을 설명하지만 지원 여부와 동작은 클라이언트에 따라 다릅니다.
MCP로 카탈로그 데이터를 조회하면 성능에 영향이 있나요?
인용된 문서에서 Shopify는 Catalog MCP의 고정 응답 시간을 보장하지 않습니다. 지연은 클라이언트, 요청, 서비스 상황에 따라 다릅니다. 요청 제한을 지키고 카탈로그 검색 결과를 캐시하지 마세요.
Shopify Catalog MCP 서버의 보안은 어떻게 관리해야 하나요?
필요한 에이전트 프로필을 사용하고 클라이언트 설정을 보호하며 Shopify의 캐시 금지 및 사용 규칙을 따르고 에이전트가 표시하는 상품 정보를 확인하세요. 일반 Catalog MCP 요청은 Admin API 토큰을 사용하지 않지만 다른 연동에는 별도 자격 증명과 접근 제어가 필요할 수 있습니다.
실시간 스토어프런트 상품 추천에 Catalog MCP를 사용할 수 있나요?
Catalog MCP는 에이전트 기반 상품 검색과 변형 선택을 위한 도구입니다. 상품 데이터와 체크아웃 링크를 반환하며 Shopify는 이를 저지연 스토어프런트 API로 문서화하지 않습니다. 맞춤형 스토어프런트 경험에는 성능과 표시 요구에 맞는 인터페이스를 선택하세요.
함께 읽으면 좋은 글
Shopify 주문 수정 통계 · Shopify MCP 및 UCP 엔드포인트 가이드 · Universal Commerce Protocol 개발자 가이드 · Shopify AI Toolkit 가이드 · Shopify 주문 관리 가이드 · Shopify 고객 주문 취소 가이드 · Shopify 에이전트 기반 스토어프런트로 ChatGPT에서 판매하는 방법 · Shopify Functions 마이그레이션 튜토리얼 · 고객이 Shopify 주문을 직접 수정하도록 하는 방법