이 글의 목차
Shopify AI Toolkit은 개발자 도구 모음입니다. Shopify의 Universal Commerce Protocol(UCP)과 커머스 엔드포인트는 관련은 있지만 플랫폼의 별도 요소입니다. 이 가이드는 현재 Toolkit, Shopify 개발자 문서의 UCP 엔드포인트, 스토어 운영자에게 제공하는 기능을 설명합니다. Revize 분석에서는 주문의 5.2%가 체크아웃 후 수정되었습니다(Revize, 2026). 이는 구매 후 운영의 배경 정보이며 AI 주문에 관한 주장이 아닙니다.
Toolkit은 지원 AI 코딩 도구에서 개발자가 최신 Shopify 문서와 API 안내를 찾는 데 도움을 줄 수 있습니다. 판매자는 자체 필요, 현재 Shopify 엔드포인트 문서, 각 에이전트 제공업체의 동작을 바탕으로 커머스 연동을 평가해야 합니다. 이 가이드는 검증 가능한 부분에 초점을 맞춥니다.
Shopify AI Toolkit이란?
Shopify AI Toolkit은 지원 AI 개발 도구를 위한 플러그인, 에이전트 스킬, 로컬 Dev MCP 서버를 제공합니다. 현재 플러그인 지원 도구는 Claude Code, Codex, Antigravity CLI, Cursor, OpenClaw, Pi, VS Code, Hermes이며 OpenClaw, Pi, Hermes는 플러그인만 지원합니다. 현재 설정 단계와 지원 도구는 공식 AI Toolkit 문서를 확인하세요. Dev MCP는 로컬에서 실행되며 문서 및 스키마 도구에 Shopify 스토어 인증이 필요하지 않습니다.
로컬 Dev MCP는 Model Context Protocol을 통해 개발 리소스를 제공합니다. 스토어 운영에는 별도로 인증된 Shopify CLI 환경을 사용합니다. 문서 서버를 설치하는 것만으로 판매자 스토어에 접근할 권한이 생기지는 않습니다.
개발에 유용한 기능은 다음과 같습니다.
- 최신 문서 찾기: 연동을 생성하기 전에 적절한 API 종류와 버전을 확인합니다.
- GraphQL 스키마 살펴보기: 쿼리나 뮤테이션을 작성하기 전에 필드명, 인수, 반환 형식을 확인합니다.
- 코드 검증: 생성된 GraphQL, Liquid, 확장 코드를 Shopify 스키마와 대조한 다음, 로컬에서 실행 동작을 테스트합니다.
- CLI로 스토어 관리: 범위가 명확한 작업을 준비하고, 선택한 스토어를 인증하고, 쿼리와 변수를 검토한 뒤 실행 시점을 정합니다. 뮤테이션에는 명시적인 허용이 필요합니다.
검증은 스키마와 컴포넌트 오류를 찾아내지만, 변경 사항이 판매자의 업무 규칙에 맞는지까지 확인해 주지는 않습니다. 실행 전에 변경 내역, 요청 권한, 대상 스토어를 검토하세요.
Shopify 커머스 MCP 및 UCP 인터페이스
Shopify는 카탈로그 탐색, 체크아웃, 주문 접근을 별도 커머스 인터페이스로 문서화합니다. 엔드포인트 형식, 인증, 작업이 다르며 어느 것도 범용 에이전트 인터페이스로 다뤄서는 안 됩니다.
1. UCP를 통한 Storefront Catalog
Shopify의 스토어별 카탈로그 엔드포인트는 https://{shop}.myshopify.com/api/ucp/mcp이며, search_catalog, lookup_catalog, get_product와 meta.ucp-agent.profile의 에이전트 프로필을 사용합니다. Storefront MCP 마이그레이션 가이드는 카탈로그·장바구니 도구를 UCP로 이전하되 search_shop_policies_and_faqs는 /api/mcp에 남겨 둡니다. 검색 규약은 Storefront Catalog 문서를 확인하세요.
이 엔드포인트가 체크아웃이나 주문 변경을 처리한다고 가정하지 마세요. Shopify는 체크아웃과 주문을 각각 자체 인증, 권한, 지원 작업이 있는 별도 에이전트 인터페이스로 문서화합니다.
2. Global Catalog
Shopify는 Shopify 전체 카탈로그 탐색을 위한 Global Catalog 엔드포인트 https://catalog.shopify.com/api/ucp/mcp를 문서화합니다. 도구와 접근 요건은 판매자의 스토어별 카탈로그 엔드포인트와 다릅니다. 구축 전에 Shopify 에이전트 카탈로그 개요를 참고하고 이전 Storefront MCP 엔드포인트나 도구 예제를 재사용하지 마세요.
3. Order MCP — 에이전트에서 시작된 주문 접근
현재 Shopify Order MCP는 에이전트에서 시작된 주문의 현재 상태를 가져오는 get_order 도구를 문서화합니다. 고객의 전체 주문 이력에 대한 일반 접근이 아니며 주문을 수정하지도 않습니다. 관련 주문 접근 및 에이전트 프로필 권한이 필요합니다. 업무 절차에 사용하기 전에 Shopify Order MCP 문서를 읽으세요.
Shopify는 Checkout MCP를 통한 별도 체크아웃 기능도 문서화합니다. 인증 또는 서명된 요청이 필요하며 구매자에게 검토나 체크아웃 완료를 넘길 수 있습니다. 현재 규약은 Checkout MCP 문서를 참고하세요.
4. Customer Accounts MCP: 인증된 고객 요청
Customer Accounts MCP는 계속 지원됩니다. https://{shop}/.well-known/customer-account-api에서 mcp_api를 찾으세요. 엔드포인트 형식은 https://{shop}/customer/api/mcp입니다. PKCE를 사용하는 OAuth 인증 코드 방식으로 해당 스토어의 주문 상세 정보, 상태, 계정 환경설정에 고객별 접근 권한을 부여합니다. 앱에는 고객 인증 설정, 사용자 지정 도메인, 보호된 고객 데이터 접근 권한이 필요합니다. tools/list로 지원되는 작업을 확인하세요. 이는 에이전트를 통해 접수된 주문에 한정되는 Order MCP와 다릅니다. 어느 이름도 임의의 주문 수정을 의미하지는 않습니다.
| 인터페이스 | 용도 | 현재 문서 |
|---|---|---|
| Shopify AI Toolkit / Dev MCP | 개발자 문서 및 스키마 도구 | AI Toolkit |
| Storefront Catalog | 한 판매자의 상품 검색 | Storefront Catalog |
| 정책 및 FAQ | 판매자 정책에 대한 공개 질문 | 정책 및 FAQ 도구 — /api/mcp |
| Global Catalog | Shopify 전체 카탈로그 검색 | 에이전트 카탈로그 개요 |
| Checkout MCP | 체크아웃 세션 및 구매자 인계 | Checkout MCP |
| Order MCP | 지원되는 에이전트 접수 주문의 상태 조회 | Order MCP |
| Customer Accounts MCP | 고객이 인증한 주문 및 계정 요청 | Customer Accounts MCP — /customer/api/mcp, OAuth PKCE |
Universal Commerce Protocol(UCP): 모든 계층의 기반
Shopify는 UCP를 에이전트, 판매자, 결제 제공업체, 자격 증명 제공업체 간 상호작용을 위한 개방형 커머스 프로토콜로 설명합니다. 문서는 탐색, 체크아웃, 주문 관련 절차를 규정합니다. 구현마다 엔드포인트, 요청 형식, 인증, 권한은 여전히 다릅니다. UCP라는 명칭이 모든 클라이언트가 모든 도구를 호출할 수 있다는 뜻은 아닙니다. 절차 구현 전에 Shopify 에이전트 프로필 문서와 엔드포인트별 자료를 참고하세요.
프로토콜의 주요 영역은 다음과 같습니다:
- 카탈로그 탐색 — 문서화된 카탈로그 엔드포인트에서 상품을 찾고 지원 상품 정보를 가져옵니다.
- 체크아웃 — 문서화된 절차로 체크아웃을 생성하거나 이어 갑니다. 인증 또는 구매자 인계가 필요할 수 있습니다.
- 주문 접근 — 문서화된 프로필 및 접근 규칙에 따라 지원 주문 정보를 가져옵니다. 에이전트가 주문을 수정하거나 환불할 수 있다는 의미는 아닙니다.
판매자는 관련 Shopify 카탈로그 엔드포인트가 스토어에서 사용 가능하고 설정됐는지 확인하세요. 엔드포인트가 있다는 사실은 특정 AI 제품이 이를 사용하거나 모든 상품을 노출한다는 보장이 아닙니다. Shopify UCP 가이드와 현재 엔드포인트 문서를 검토한 뒤 지원하려는 클라이언트로 테스트하세요.
판매자가 지금 검증할 수 있는 사항
1. AI 검색 트래픽은 늘지만 MCP가 원인이라는 증거는 아닙니다. Shopify는 2026년 6월 AI 검색에서 유입된 주문이 전년 대비 13배 늘었으며 전환율은 49%, 평균 주문 금액은 14% 더 높다고 보고했습니다. 이는 Shopify가 보고한 AI 검색 수치로, 모든 판매자에 대한 전망이나 특정 MCP 엔드포인트가 주문을 만들었다는 증거가 아닙니다. Shopify의 2026년 6월 업데이트를 참고하세요.
2. 실제 구매 후 업무 절차를 확인하세요. 문서화된 Shopify Order MCP는 지원 에이전트 발생 주문 정보를 읽을 수 있지만 주문을 수정하지 않습니다. 에이전트 엔드포인트가 처리한다고 가정하지 말고 적격 주문 수정의 고객용 경로를 확인해야 합니다.
3. 상품 정보를 정확하게 유지하세요. 명확한 제목, 옵션, 판매 가능 여부, 정책은 고객과 커머스 시스템의 카탈로그 이해를 돕습니다. 특정 데이터 형식이 순위나 전환율을 보장한다고 가정하지 말고 자체 스토어에서 결과를 측정하세요.
개발자나 에이전시가 AI Toolkit 사용하기
개발 작업 하나로 시작하세요. 스키마를 살펴보고, 쿼리를 생성하고, 검증한 뒤 개발용 스토어에서 결과를 검토합니다.
지원 클라이언트용 Shopify 플러그인을 설치하거나 문서에 나온 스킬 또는 Dev MCP 설치 절차를 따르세요. 플러그인은 자동 업데이트되지만 수동으로 설치한 스킬은 직접 업데이트해야 합니다. 실제 사용하는 클라이언트의 설정 지침을 따르세요.
스토어 관리에는 필요한 권한만 사용해 Shopify CLI로 인증하세요. store execute 명령은 저장된 인증 정보를 사용해 검토한 Admin GraphQL 작업을 실행합니다. 예를 들어 다음은 개발용 스토어의 첫 10개 상품을 읽습니다.
shopify store auth --store YOUR-DEV-STORE.myshopify.com --scopes read_products
shopify store execute --store YOUR-DEV-STORE.myshopify.com --query '{ products(first: 10) { nodes { id title } } }'자리표시자를 자신의 개발용 스토어로 바꾸세요. 읽기는 뮤테이션을 활성화하지 않고 실행할 수 있지만, 쓰기에는 --allow-mutations와 해당 권한이 필요합니다. 허용하기 전에 뮤테이션과 변수 전체를 검토하고, 대상 스토어를 확인하며, 운영 환경을 변경하기 전에 의도한 동작을 테스트하세요.
내 스토어에서 에이전트 쇼핑 활성화하기
Shopify 카탈로그 엔드포인트를 기반으로 구축하려면 meta.ucp-agent.profile을 포함한 현재 Storefront Catalog 요청 형식을 따르세요. 상품 검색에 성공했다고 해서 체크아웃이나 주문 접근이 가능하다는 뜻은 아닙니다. Shopify Catalog MCP 가이드에서 검색 도구와 그 한계를 설명합니다.
브랜드 에이전트에는 Shopify의 현재 샘플 프로젝트와 엔드포인트별 체크아웃 문서를 사용하세요. 자체 카탈로그, 인증, 결제, 지원 요건에 맞춰 단계적 출시를 계획하세요. 샘플 프로젝트가 운영 연동 체크리스트는 아닙니다. 출시 전에 고객에게 보이는 상품 정보와 체크아웃 인계를 테스트하세요.
에이전트 기반 구성에서 구매 후 처리 인프라의 역할
상품 검색, 체크아웃, 주문 추적, 고객 수정에는 각각 이를 지원하는 인터페이스가 필요합니다. Shopify MCP 및 UCP 엔드포인트 가이드에서 이 책임들을 정리합니다.
Shopify는 Order MCP를 지원되는 에이전트 접수 주문의 읽기 인터페이스로 문서화하며, UCP 주문 웹훅으로 주문 상태 변화를 전달합니다. 일반 주문 수정 절차는 제공하지 않습니다. Revize는 판매자가 설정한 수정 가능 시간에 따라 주문 처리 전에 적격 주소, 옵션, 수량, 취소 변경을 위한 고객용 포털을 제공합니다. 상품 추가, 다른 상품으로 교체, 할인 적용, 스토어 크레딧 환불은 Pro 기능입니다. 직원용 주문 수정은 개발 중입니다. 포털에는 주문 상태 페이지의 Revize 앱 블록이 필요하며 이메일의 Edit Order 링크로도 열 수 있습니다. 제품 정보는 Shopify App Store의 Revize를 참고하세요.
자주 묻는 질문
Shopify AI Toolkit을 한 문장으로 설명하면?
Shopify AI Toolkit은 플러그인, 에이전트 스킬, 로컬 Dev MCP 서버를 포함하는 개발자 도구 모음입니다. Shopify 커머스 에이전트 엔드포인트와 UCP는 별도로 문서화되어 있습니다.
Shopify AI Toolkit은 무료인가요?
Shopify AI Toolkit 문서에는 별도 Toolkit 구독 가격이 나와 있지 않습니다. 비용이나 계정 요건은 현재 Shopify 플랜, AI 클라이언트, 앱, 엔드포인트 조건을 확인하세요.
MCP를 사용하려면 Shopify Plus가 필요한가요?
모든 에이전트 엔드포인트나 기능이 모든 플랜에 제공된다고 가정하지 마세요. 스토어와 특정 연동에 대한 현재 Shopify 엔드포인트 및 플랜 문서를 확인하세요.
Storefront Catalog와 Global Catalog는 어떻게 다른가요?
현재 Shopify 스토어별 카탈로그 엔드포인트는 /api/ucp/mcp로 문서화되어 있으며 Global Catalog는 별도 엔드포인트가 있습니다. 도구와 요청 요건이 다릅니다. Shopify 카탈로그 개요를 참고하세요.
Universal Commerce Protocol이란?
UCP는 Shopify 개발자 문서에 설명된 개방형 커머스 프로토콜입니다. 다른 플랫폼이나 에이전트가 같은 절차를 지원한다고 가정하기 전에 현재 사양과 엔드포인트별 문서를 읽으세요.
ChatGPT, Claude, Gemini가 모두 Shopify의 MCP 서버를 사용하나요?
제공업체 연동은 각각 독립적으로 바뀝니다. 각 제공업체의 현재 문서를 확인하고 ChatGPT, Claude, Gemini가 모든 Shopify UCP 엔드포인트나 도구를 지원한다고 가정하지 마세요.
에이전트 쇼핑을 활성화하면 구매 전환율이 떨어지나요?
공통 효과는 없습니다. 활성화하는 구체적인 채널과 고객 여정의 전환율, 체크아웃 완료, 지원 문의를 측정하세요.
AI Toolkit은 고객 데이터 개인정보 보호를 어떻게 처리하나요?
사용하는 각 도구의 현재 Shopify 및 AI 제공업체 개인정보 보호, 인증, 데이터 처리 문서를 검토하세요. 요건은 엔드포인트, 클라이언트, 요청 정보에 따라 다릅니다. 모든 호출이 로컬이거나 개인정보를 포함하지 않는다고 가정하지 마세요.
경쟁사의 에이전트도 MCP를 통해 내 스토어에서 거래할 수 있나요?
에이전트 접근은 엔드포인트, 에이전트 프로필, 인증, 현재 Shopify 통제에 따라 다릅니다. 외부 업무 절차를 활성화하기 전에 관련 Shopify 문서와 자체 접근 설정을 검토하세요. 프로토콜 호환성만으로 체크아웃 접근 권한이 부여된다고 가정하지 마세요.
내 스토어가 에이전트 검색 결과에 나오려면 무엇을 해야 하나요?
상품 정보를 정확하고 완전하게 유지한 뒤 사용할 채널의 자격 및 탐색 규칙을 확인하세요. Shopify는 특정 콘텐츠 변경 하나로 상품이 에이전트 결과에 표시된다고 약속하지 않습니다.
AI Toolkit과 Shopify Functions는 어떤 관계인가요?
Shopify Functions와 AI Toolkit은 목적이 다릅니다. Functions는 지원 커머스 로직을 구현하며 Toolkit은 개발자를 지원합니다. 특정 연동이 설정과 어떻게 상호작용하는지 엔드포인트 및 Functions 문서로 확인하세요. Shopify Functions 마이그레이션 튜토리얼에서 해당 개발 절차를 다룹니다.
에이전트가 내 스토어에서 무엇을 하는지 어떻게 확인하나요?
특정 Shopify 엔드포인트와 클라이언트에 문서화된 로그, 진단, 관측 도구를 사용하세요. 외부 에이전트가 자체 대화 로그를 별도로 제공할 수 있습니다. 연동이 무엇을 기록하고 해당 데이터를 어떻게 처리하는지 확인하세요.
함께 읽으면 좋은 글
Shopify 주문 수정 통계 · Shopify 에이전트 기반 스토어프런트로 ChatGPT에서 판매하는 방법 · 고객이 Shopify 주문을 직접 수정하도록 하는 방법