2026년 Shopify MCP와 UCP: 현재 엔드포인트와 기능

Shopify MCP에는 목적이 다른 여러 인터페이스가 포함됩니다. Shopify의 Storefront MCP 마이그레이션 가이드는 기존 카탈로그와 장바구니 도구의 UCP 이전 방식을 설명하며, 정책·FAQ 도구와 Customer Accounts MCP는 유지합니다. 구매자가 수행할 작업에 맞춰 인터페이스를 고른 다음 스키마와 인증을 확인하세요. 이 가이드는 고객용 구매 후 주문 수정 절차가 어디에 해당하는지도 설명합니다.

기술 구조 간단히 살펴보기#

MCP(Model Context Protocol)는 AI 클라이언트가 사용하는 도구 인터페이스입니다. 현재 Shopify 커머스 문서는 카탈로그 탐색, 체크아웃, 주문 접근용 UCP(Universal Commerce Protocol) 엔드포인트도 설명합니다. 클라이언트는 엔드포인트의 현재 스키마, 인증, 권한을 사용해야 하며 엔드포인트 이름과 기능은 서로 대체할 수 없습니다.

Storefront Catalog 문서는 search_catalog, lookup_catalog, get_product를 나열하고 meta.ucp-agent.profile에 에이전트 프로필을 요구합니다. Checkout MCP와 Order MCP는 접근 규칙과 지원 작업이 다릅니다. 검색 도구와 그 한계는 Shopify Catalog MCP 가이드를 확인하세요.

저희 판단: 현재 문서화된 엔드포인트를 기반으로 구축하세요#

기존 연동을 도구별로 대응시키세요. 상품 검색에는 Storefront Catalog, 장바구니 작업에는 Cart MCP, 체크아웃에는 Checkout MCP를 사용합니다. 정책 질의는 /api/mcp에 유지하세요. 트래픽을 이전하기 전에 개발 환경에서 각 대체 도구의 요청 스키마와 접근 규칙을 테스트하세요.

카탈로그 엔드포인트가 상품 탐색을 지원할 수 있지만 그것만으로 에이전트가 체크아웃을 만들거나 구매자의 주문을 읽거나 변경할 수 있다는 증거가 되지는 않습니다. 각각 별도 업무 절차입니다. AI Toolkit의 Dev MCP는 개발자용이며 구매자용 커머스 엔드포인트와 다릅니다.

AI 에이전트가 스토어에서 실제로 하는 일#

순서는 에이전트와 사용하는 Shopify 인터페이스에 따라 다릅니다. 카탈로그 요청은 상품 데이터를 검색하거나 가져올 수 있습니다. 체크아웃 절차에는 인증 또는 서명된 요청이 필요할 수 있으며 구매자에게 구매 검토나 완료를 안내할 수 있습니다. Shopify Order MCP는 지원 에이전트 발생 주문의 get_order를 문서화합니다. 범용 채널 통합 주문 이력 API가 아닙니다. 고객 지원이나 주문 처리에 연결하기 전에 각 엔드포인트 범위를 읽으세요.

인증된 고객 접근은 별도의 연동입니다#

Customer Accounts MCP를 이용하면 어시스턴트가 로그인한 고객의 해당 스토어 주문 상세 정보, 상태, 계정 환경설정을 처리할 수 있습니다. https://{shop}/.well-known/customer-account-api에서 mcp_api를 찾은 다음, OAuth 2.0 인증 코드 및 PKCE로 인증하세요. 설정에는 사용자 지정 도메인, 고객 인증 구성, 보호된 고객 데이터에 대한 적절한 접근 권한이 필요합니다. 인증 후에는 tools/list로 실제 도구와 스키마를 확인하세요. 임의 수정이나 여러 판매자의 계정에 대한 접근을 가정하지 마세요.

반면 Order MCP는 에이전트 자격 증명으로 해당 에이전트를 통해 접수된 주문을 읽습니다. Shopify의 주문 웹훅 가이드는 UCP 주문 상태 업데이트와 파트너 매니저를 통한 Shopify 측 등록을 설명합니다. Shopify 에이전트 기반 주문 운영 가이드에서 전달과 상태 대조를 다룹니다.

구매 후 업무 절차는 별도입니다#

상품 탐색이나 체크아웃 엔드포인트는 일반 주문 수정 작업을 제공하지 않습니다. 현재 Shopify Order MCP 문서는 지원 에이전트 발생 주문 상태의 조회를 설명하며 수정하지는 않습니다. 고객이 체크아웃 후 주소, 수량, 옵션을 수정해야 할 때 이 차이가 중요합니다.

스토어는 자체 정책과 주문 처리 상태에 따라 적격 변경을 할 고객용 경로를 제공해야 합니다. Revize 고객 주문 수정 앱은 판매자가 설정한 수정 가능 시간 동안, 주문 처리 전에 주소·수량·옵션 변경과 취소를 지원합니다. 다른 상품으로 교체, 상품 추가, 할인 적용, 스토어 크레딧 환불은 Pro 기능입니다. 포털에는 주문 상태 페이지의 Revize 앱 블록이 필요하며 이메일의 Edit Order 링크로도 이용할 수 있습니다. 기본 편집기의 절차와 한계는 Shopify 주문 수정 가이드를 확인하세요.

Shopify가 현재 문서화한 기능#

현재 Shopify 자료와 대조해 확인할 문서화된 기능은 다음과 같습니다:

• 문서화된 카탈로그 도구와 에이전트 프로필을 사용하는 UCP 엔드포인트 기반 스토어별 카탈로그 탐색.
• 더 넓은 상품 탐색을 위한 별도 Global Catalog 엔드포인트.
• 자체 인증 또는 서명 요청 요건과 구매자 인계 가능성이 있는 Checkout MCP.
• 지원 에이전트 발생 주문의 get_order 도구를 제공하는 Order MCP.
• 인증된 고객별 요청을 위한 Customer Accounts MCP와 공개 스토어 질문을 위한 정책·FAQ 도구.
• Shopify AI Toolkit과 Dev MCP를 통한 로컬 개발자 도구 모음.

엔드포인트 이름만으로 제한 없는 스토어 접근, 고객 계정의 모든 이력, 주문 수정 권한을 보장하지는 않습니다. 각 인터페이스의 문서화된 범위를 따르세요. 개발자 도구는 Shopify AI Toolkit 가이드에서 별도로 설명합니다.

이번 분기에 저희라면 할 일#

1. 작업에 따라 엔드포인트를 선택하세요. 상품 탐색에는 현재 Storefront Catalog 문서, 체크아웃에는 Checkout MCP 문서, 지원 주문 조회에는 Order MCP 문서를 사용하세요.
2. 프로필 및 접근 요건을 확인하세요. Storefront Catalog 요청에는 meta.ucp-agent.profile이 포함됩니다. 다른 엔드포인트의 정확한 요건은 각각 확인하세요.
3. 개발 환경에서 테스트하세요. 고객용 출시를 계획하기 전에 요청 스키마, 반환 필드, 인증, 구매자 인계를 검증하세요.
4. 구매 후 절차를 별도로 점검하세요. 고객이 적격 주문 변경을 검토하거나 요청할 경로를 마련하세요. MCP가 완료된 주문을 수정할 것으로 기대하지 마세요.
5. 출시 전에 문서를 다시 확인하세요. Shopify 에이전트 API와 클라이언트 지원은 바뀔 수 있습니다. 복사한 예제 대신 현재 일차 문서를 사용하세요.

결론#

클라이언트에 필요한 데이터와 그 접근을 허용하는 주체를 정의하세요. 카탈로그 검색, 체크아웃, 공개 정책 답변, 고객 계정, 에이전트를 통해 접수된 주문 조회는 각각 규약이 다릅니다. Universal Commerce Protocol 개발자 가이드에서 UCP 인터페이스의 기반인 기능 협상을 설명합니다.

판매자는 고객 서비스와 구매 후 수정을 명시적인 설계 요소로 유지하세요. 문서화된 Shopify Order MCP는 지원 에이전트 발생 주문을 읽을 수 있지만 일반 주문 수정 절차를 제공하지 않습니다. 고객용 수정 포털, 판매자 정책, 주문 처리 마감 시점은 여전히 별도 고려 사항입니다.

자주 묻는 질문#

현재 Shopify MCP 엔드포인트는 무엇인가요?#

Storefront Catalog와 문서화된 장바구니 및 체크아웃 도구에는 /api/ucp/mcp를 사용하세요. 공개 정책 질의는 /api/mcp에 남아 있으며, 인증된 고객 요청은 검색으로 찾은 Customer Accounts MCP 엔드포인트를 사용합니다. 구체적인 작업을 지원하는 엔드포인트를 선택하세요.

상품 탐색에 어떤 Shopify 엔드포인트를 사용해야 하나요?#

한 판매자의 카탈로그에는 문서화된 스토어별 카탈로그 엔드포인트를, 더 넓은 카탈로그 탐색에는 별도 Shopify Global Catalog 엔드포인트를 사용하세요. 현재 도구와 요청 요건은 카탈로그 개요를 확인하세요.

UCP란 무엇인가요?#

UCP는 문서화된 에이전트, 판매자, 자격 증명 제공업체, 결제 제공업체의 상호작용을 위한 Shopify 개방형 커머스 프로토콜입니다. 탐색, 체크아웃, 주문 작업에 하나의 범용 권한 모델이 공통으로 적용되지 않으므로 엔드포인트별 자료를 사용하세요.

에이전트 프로필이 필요한가요?#

Storefront Catalog 문서는 meta.ucp-agent.profile에 프로필을 요구합니다. 같은 요건이나 권한이 모든 곳에 적용된다고 가정하지 말고 다른 엔드포인트 문서를 각각 확인하세요.

AI 에이전트가 체크아웃을 완료할 수 있나요?#

Shopify는 Checkout MCP를 별도로 문서화합니다. 현재 절차에는 인증 또는 서명된 요청이 필요하며 구매자에게 체크아웃 검토나 완료를 안내할 수 있습니다. 지원 경로는 Checkout MCP 자료를 참고하세요.

모든 플랜에서 Shopify MCP를 사용할 수 있나요?#

제공 여부와 접근은 엔드포인트와 스토어 설정에 따라 다릅니다. 특정 연동에 대한 현재 Shopify 플랜 및 엔드포인트 문서를 확인하세요. MCP 예제로 플랜 접근을 추론하지 마세요.

Global Catalog와 Storefront Catalog는 어떻게 다른가요?#

Storefront Catalog는 한 판매자로 범위가 제한됩니다. Global Catalog는 Shopify 전체 상품 검색을 위한 별도 탐색 엔드포인트입니다. 엔드포인트와 도구 규약이 다릅니다.

Order MCP는 무엇을 하나요?#

Shopify는 지원 에이전트 발생 주문의 현재 상태를 읽는 get_order 도구를 문서화합니다. 고객의 모든 채널 주문 이력을 위한 일반 엔드포인트가 아닙니다.

Customer Accounts MCP와 Order MCP는 어떻게 다른가요?#

Customer Accounts MCP는 해당 스토어의 계정 및 주문 요청에 고객의 OAuth 인증을 사용합니다. Order MCP는 에이전트 범위의 접근 권한으로 해당 에이전트를 통해 접수된 주문만 가져올 수 있습니다. 고객 서비스 작업을 선택하기 전에 각 도구의 스키마를 확인하세요.

Shopify MCP로 구매 후 주문 변경 문제를 해결할 수 있나요?#

아니요. 현재 Order MCP 문서는 주문 조회를 설명하며 수정은 설명하지 않습니다. 고객용 주문 변경에는 별도 업무 절차가 필요하고 스토어 정책과 주문 처리 상태가 계속 적용됩니다.

Shopify 엔드포인트는 어떻게 테스트하나요?#

해당 엔드포인트 공식 자료에 따라 문서화된 요청을 개발 환경에서 테스트하세요. 출시 전에 인증, 필수 프로필 데이터, 반환 필드, 체크아웃 인계를 확인하세요.

Shopify는 AI 검색 성장에 대해 무엇을 보고했나요?#

Shopify는 2026년 6월 AI 검색에서 유입된 주문이 전년 대비 13배 늘었으며 전환율은 49%, 평균 주문 금액은 14% 더 높다고 보고했습니다. 이 수치는 Shopify AI 검색 보고 내용이며 특정 MCP 엔드포인트의 성능이 아닙니다. Shopify 보고를 참고하세요.

구현에서 가장 우선할 단계는 무엇인가요?#

구체적인 작업 하나를 선택하고 현재 Shopify 엔드포인트 문서에 따라 전체 요청과 고객 경험을 테스트하세요. 카탈로그, 체크아웃, 주문 조회, 구매 후 수정 절차를 각각 구분하세요.

함께 읽으면 좋은 글#

Shopify 에이전트 기반 스토어프런트로 ChatGPT에서 판매하는 방법 · 고객이 Shopify 주문을 직접 수정하도록 하는 방법