2026년 Shopify AI 툴 5가지: 올바른 스택 구축하기

2026년 Shopify AI 툴 5가지: 올바른 스택 구축하기

2026년 Shopify AI 툴 5가지: 올바른 스택 구축하기

Shopify AI Toolkit 2026: 5가지 도구, 실체와 과장 | Revize 블로그

Shopify AI Toolkit은 단일 제품이 아닌 스택입니다. 이것이 바로 이 도구에 대해 가장 오해하고 있는 사실입니다. 머천트들은 "기능을 켜야 하는지" 계속 묻고, 개발자들은 어느 엔드포인트에 있는지 묻지만, 양쪽 모두 잘못된 답을 찾고 있습니다. AI Toolkit은 실제로 지난 6개월 동안 Shopify가 단일 마케팅 타이틀 아래 번들로 출시한 세 개의 개별 인프라 레이어입니다: AI 코딩 어시스턴트로 Shopify 앱을 빌드하기 위한 개발자 툴체인, AI 쇼핑 에이전트가 Shopify 스토어에서 거래할 수 있도록 하는 일련의 MCP 서버, 그리고 에이전트, 머천트, 결제 프로세서, 인증 제공업체가 표준 방식으로 통신할 수 있도록 하는 UCP라는 개방형 프로토콜입니다. 마지막 레이어는 생각보다 훨씬 중요합니다: 760만 건의 Shopify 주문 중 약 47건 중 1건(2.1%)은 결제 후 수정되며(Revize, 2026), 따라서 머천트를 대신해 거래하는 모든 에이전트는 결국 처리하도록 설계되지 않은 변경이나 취소 상황에 직면하게 됩니다.

월 1만 건 이상의 주문을 처리하는 Shopify Plus 스토어를 운영 중이라면 이 기술에 주목해야 합니다. 머천트의 계획 여부와 관계없이 스토어가 에이전트가 접근 가능한 상태로 전환될 것이기 때문입니다. 전환 품질에 집중하며 CX를 중시하는 Advanced 머천트라면 다음 세대의 "쇼핑 어시스턴트"가 구매 의도가 높은 고객을 머천트 스토어로 유도하거나 혹은 경쟁사로 보낼 수 있기 때문에 신경 써야 합니다. 또한 자신의 스토어나 App Store를 위해 Shopify 앱을 빌드하는 경우, AI Toolkit의 개발자 사이드를 도입한 팀은 일반적인 어드민 워크플로우의 개발 시간을 40-60% 단축했습니다. 이 가이드는 각 레이어의 역할과 2026년에 머천트가 주목해야 할 지점을 정리합니다.

Isometric illustration of the Shopify AI Toolkit architecture showing three layered MCP servers stacked over a Shopify storefront, rendered in purple and cream tones

Shopify AI Toolkit이란 무엇인가?

Shopify AI Toolkit은 Claude Code, Cursor, Gemini CLI, Codex, VS Code 등 AI 코딩 어시스턴트를 Shopify의 문서, API 스키마 및 로컬 CLI 기반 "스토어 실행" 기능에 직접 연결하는 개발자 지향 통합 솔루션입니다. 플러그인(권장, 자동 업데이트), 수동으로 설치할 수 있는 에이전트 스킬 세트, 그리고 인증 없이 개발자 로컬 머신에서 실행되는 로컬 Dev MCP 서버 형태로 제공됩니다.

대체 대상: 2025년 3월 3일에 단종된 기존 .dev Assistant VS Code 익스텐션입니다. 기반 기술: 2024년 말 Anthropic이 출시하고 현재 모든 주요 AI 코딩 툴이 지원하는 개방형 표준인 Model Context Protocol(MCP)입니다.




Diagram showing a developer's AI assistant connecting through the Shopify Dev MCP server to Shopify documentation, GraphQL Admin API schema, and a CLI-backed store execute pipeline

실질적인 측면에서, Toolkit의 Dev MCP 사이트가 제공하는 기능을 통해 개발자는 AI 지원 에디터를 벗어나지 않고도 다음 작업을 수행할 수 있습니다:



  • 3개월 전 일반 웹 크롤러가 색인한 정보가 아닌, 현재 API 버전에 맞는 쿼리 관련성으로 라이브 Shopify.dev 문서를 검색합니다.

  • GraphQL Admin API 스키마를 정밀 분석하여, AI 어시스턴트가 존재하지 않는 필드를 임의로 생성하는 대신 올바른 필드명과 타입으로 쿼리를 작성하도록 합니다.

  • 개발자가 코드를 실제로 실행하기도 전에, 생성된 GraphQL 코드와 컴포넌트 코드가 실제 스키마에 맞는지 검증합니다.

  • shopify store authshopify store execute를 통해 특정 스토어에 대해 검증된 Admin 작업을 실행하여, "처음 10개 상품 보여줘"를 개발자 자신의 스토어에서 가져온 실제 결과로 변환합니다.

이 마지막 기능이 일상적인 개발 방식을 가장 크게 변화시킵니다. "쿼리 작성 → 어드민 전환 → 실행 → 결과 확인 → 복귀 → 반복" 단계를 에디터 내 단일 왕복 작업으로 단축시킵니다.

하지만 이것은 세 개의 레이어 중 하나에 불과합니다. 사람들이 여기서 만족할 때 혼란이 시작됩니다.

모든 머천트가 알아야 할 세 가지 MCP 서버

Dev MCP 외에도 Shopify는 세 가지 MCP 서버를 더 제공합니다. 머천트에게 중요한 것은 바로 이것들입니다. AI 쇼핑 에이전트가 스토어프런트, 카탈로그, 고객 주문과 상호작용하는 방식을 정의하기 때문입니다.

1. Storefront MCP — 단일 머천트, 단일 에이전트

Storefront MCP 서버는 모든 개별 Shopify 스토어가 에이전트와의 상호작용을 위해 노출하는 엔드포인트입니다. 인증은 필요하지 않습니다. 엔드포인트 패턴은 https://{shop}.myshopify.com/api/mcp 이며 다음과 같은 JSON-RPC 호출을 허용합니다:



const mcpEndpoint = `https://your-store.myshopify.com/api/mcp`;

fetch(mcpEndpoint, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/call',
    id: 1,
    params: {
      name: 'search_shop_catalog',
      arguments: {
        query: 'organic coffee beans',
        context: 'customer preference for fair-trade single-origin'
      }
    }
  })
});
const mcpEndpoint = `https://your-store.myshopify.com/api/mcp`;

fetch(mcpEndpoint, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/call',
    id: 1,
    params: {
      name: 'search_shop_catalog',
      arguments: {
        query: 'organic coffee beans',
        context: 'customer preference for fair-trade single-origin'
      }
    }
  })
});

Storefront MCP가 노출하는 툴에는 search_shop_catalog(자연어 쿼리로 상품 검색), search_shop_policies_and_faqs(배송, 반품 등에 대한 고객 질문 답변), update_cart(장바구니 추가, 제거, 수량 업데이트), get_order_status, get_most_recent_order_status 등이 포함됩니다. 특히 마지막 기능이 중요합니다. Storefront MCP를 기반으로 구축된 AI 에이전트는 재방문 고객의 주문 상태를 확인하고, 지연을 감지하며, 반품을 시작하는 등 사람이 처리하던 CX 작업을 수행할 수 있습니다.

2. Catalog MCP — 단일 에이전트, 모든 Shopify 머천트

Catalog MCP는 반대의 개념입니다. 에이전트가 단 한 번의 호출로 적격한 모든 Shopify 머천트를 검색할 수 있도록 하는 글로벌 검색 레이어입니다. Storefront MCP와 달리, Dev Dashboard에서 발급받은 JWT 토큰(60분 TTL, 클라이언트 자격 증명을 통해 발급)을 통한 인증이 필요합니다. 사용자가 "캐나다로 배송되는 120달러 이하의 러닝화를 찾아줘"라고 요청할 때 ChatGPT의 쇼핑 모드, Perplexity의 커머스 레이어, Claude의 에이전트 통합 기능이 쿼리하는 서버가 바로 이것입니다. 개별 스토어가 아닌 Catalog MCP를 타겟팅합니다.

주요 도구는 search_global_products(가격, 배송, 상품 옵션 필터를 적용한 크로스 머천트 검색)와 get_global_product_details(해당 SKU를 판매하는 모든 머천트의 전체 옵션 매트릭스를 반환하는 Universal Product ID 조회) 두 가지입니다. 결과는 Universal Product ID (UPID) 기준으로 그룹화되므로 여러 스토어에 걸친 중복 SKU가 에이전트에게 불필요한 중복 결과를 제공하지 않도록 방지합니다.




Illustration of the four Shopify MCP servers — Dev MCP, Storefront MCP, Catalog MCP, and Customer Accounts MCP — with data flowing to AI agents and merchant stores

3. Customer Accounts MCP — 기억하는 에이전트

Customer Accounts MCP 레이어는 구매 후 경험을 가장 크게 변화시킬 가능성이 높은 레이어입니다. 고객이 계정을 보유한 머천트 전체에 걸쳐, 인증된 에이전트에게 해당 고객의 주문 내역, 주소록, 계정 상태에 대한 읽기 권한을 제공합니다. 구체적으로, 구매자의 개인 에이전트는 Customer Accounts MCP를 호출하여 "내 헤드폰 주문이 언제 도착하나요?"에 답변할 수 있으며, 고객이 지원 양식에 주문 번호를 직접 입력하지 않고도 반품을 트리거할 수 있습니다.

대량 주문을 처리하는 운영자에게 이는 1차 지원 업무의 상당 부분을 에이전트 처리 흐름으로 자동화할 수 있음을 의미합니다. CX에 집중하는 머천트에게 이것은 기회이자 위협이 될 수 있습니다. 고객을 응대하는 에이전트가 머천트 자체 에이전트인지, Shopify의 에이전트인지, 아니면 제3자 에이전트인지에 따라 달라지기 때문입니다. 초기 배포의 대부분은 하이브리드 형태입니다: 머천트 자체 브랜드 에이전트가 인증된 고객을 대신하여 Customer Accounts MCP를 호출합니다.



서버

호출 주체

인증

주요 용도

Dev MCP

AI 코딩 툴을 통한 개발자

없음 (로컬)

문서 검색, 스키마 분석, 스토어 작업 실행

Storefront MCP

에이전트 (브랜드 또는 제3자)

없음

단일 스토어 검색, 장바구니 작업, 정책 Q&A, 주문 상태 확인

Catalog MCP

에이전트 (주로 제3자)

JWT (Dev Dashboard)

크로스 머천트 상품 검색 및 조회

Customer Accounts MCP

인증된 에이전트

Shopify 계정을 통한 OAuth

주문 내역, 계정 정보, 구매 후 작업

Universal Commerce Protocol (UCP): 레이어 아래의 레이어

네 가지 MCP 서버는 모두 UCP를 준수합니다. 이 약어는 중요합니다. Universal Commerce Protocol은 플랫폼(에이전트 및 애플리케이션), 머천트, 인증 제공업체, 결제 서비스 제공업체(PSP) 등 네 가지 유형의 행위자가 커머스 거래를 위해 웹 전반에서 일관되게 통신하는 방식을 정의하기 위해 Shopify가 제정한 개방형 표준입니다.

UCP는 Shopify 전용 기술이 아닙니다. 사양이 공개되어 있어 제3자 구현이 권장되며, 명확한 목표는 OpenAI가 구축한 에이전트가 Shopify, BigCommerce 또는 맞춤형 플랫폼에서 매번 새로운 통합 코드를 작성하지 않고도 결제를 완료할 수 있는 상호 운용 가능한 레이어를 구축하는 것입니다.

UCP가 정의하는 세 가지 핵심 기능:



  1. Discovery (탐색) — 머천트 간 검색, 상품 상세 정보 조회, 구매자가 원하는 상품을 찾도록 지원. Shopify는 Catalog MCP 및 Storefront MCP를 통해 이를 구현합니다.

  2. Checkout (결제) — 결제 세션 생성, 구매자 정보 수집, 결제 수단 연결, 거래 완료. Shopify는 Storefront MCP 장바구니 툴과 별도의 Checkout Kit(임베디드 및 브라우저 기반 결제 모두 지원)의 조합을 통해 이를 구현합니다.

  3. Orders (주문) — 확정된 거래 추적, 배송 이벤트, 환불, 반품 처리. Shopify는 Customer Accounts MCP 및 기존 Admin API를 통해 이를 구현합니다.




Sequence diagram showing an AI agent completing a commerce flow across a buyer, merchant, payment service provider, and credential provider using the Universal Commerce Protocol

머천트에게 주는 실질적인 영향: Shopify를 사용 중이고 Storefront MCP를 활성화한 경우(대부분의 스토어에서 기본 활성화됨), 스토어는 이미 UCP 기반으로 구축된 에이전트에게 노출 가능한 상태입니다. "ChatGPT와 통합"하거나 "Claude와 통합"할 필요가 없습니다. UCP와 통합하면 모든 UCP 준수 에이전트가 접근할 수 있게 됩니다. 이는 1999년 SEO가 오가닉 검색 영역에서 해결한 패턴과 동일합니다. 하나의 표준, 다수의 소비자. 더 자세한 기술 사양이 궁금하다면 UCP 상세 가이드를 참고하십시오.

향후 18개월 동안 머천트에게 발생할 변화

확실성이 높은 순서대로 정리한 세 가지 구체적인 변화입니다:

1. 에이전트 기반 트래픽이 일시적 유행이 아닌 실제 채널로 자리 잡습니다. 이미 ChatGPT 기반 쇼핑 노출도가 높은 스토어의 경우 세션의 3~8%가 에이전트 추천을 통해 유입되고 있습니다. 2026년 4분기까지 대부분의 소비자 지향 AI 어시스턴트는 커머스 통합 기능을 갖추게 될 것입니다. ChatGPT 판매 가이드에서 이 채널에 특화된 전술적 최적화 방법을 다룹니다.

2. 구매 후 경험이 셀프서비스에서 에이전트 지원 서비스로 이동합니다. 주문 상태 조회, 반품 개시, 주소 변경, 할인 소급 적용 등 현재 Revize나 기타 구매 후 관리 앱이 처리하는 모든 1차 작업이 에이전트 대화 형태로 통합됩니다. 도구 호출은 기존과 동일한 API를 타겟팅하지만, 사용자 인터페이스가 웹 양식에서 자연어 대화로 이동합니다. 기본 워크플로우를 해결하지 못한 머천트는 에이전트를 도입할 준비가 되지 않은 것입니다. 에이전트는 망가진 구매 후 프로세스를 해결해 주지 않으며, 오히려 그 약점을 드러낼 뿐입니다.

3. 상품 데이터 품질이 ROI 극대화의 핵심이 됩니다. UCP 환경에서 에이전트는 상품 상세 정보를 기반으로 머천트의 상품을 구매자에게 노출할지 여부를 결정합니다. 타이틀, 설명, 기술 사양, 소재, 옵션 조합, 재고 신호 등 모든 필드가 이제 사람이 아닌 모델에 의해 평가됩니다. 정제되고 구조화된 상품 데이터를 가진 머천트는 에이전트 탐색에서 부실한 데이터를 가진 머천트보다 우위를 점하게 됩니다. 인간 고객과 달리, 에이전트는 부실한 콘텐츠를 억지로 읽어 내려가지 않으며, 단지 순위에서 제외할 뿐입니다.

개발자 또는 에이전시로서 AI Toolkit 사용하기

Toolkit의 개발자 사이드 설정 흐름은 전체 구조 중 가장 간단한 부분입니다.




Developer workstation with Claude Code open alongside terminal running Shopify CLI, with the Shopify Dev MCP server connecting both to documentation and a live development store

Claude Code를 사용하는 경우, Shopify 플러그인 설치를 한 번만 실행하면 Dev MCP 서버가 자동으로 등록됩니다. 이후 Claude Code와의 모든 대화에서 문서 검색, 스키마 분석, shopify store execute를 도구 호출로 사용할 수 있습니다. 프로젝트별 별도 설정은 필요하지 않습니다.

Cursor를 사용하는 경우, Cursor MCP 구성 파일에 Dev MCP 서버를 추가합니다. 설정은 5줄짜리 JSON 블록으로 끝납니다. 다음 재시작 시 Cursor가 해당 도구들을 자동으로 감지합니다.

Gemini CLI를 사용하는 경우, Shopify GitHub 스킬 리포지토리에서 스킬을 설치하여 통합할 수 있습니다.

플러그인과 별개인 에이전트 스킬 (Agent skills)은 리포지토리의 .agent/skills/ 디렉토리에 추가하는 마크다운 파일입니다. 프로젝트별 맞춤 설정이 필요한 경우에 적합한 패턴입니다. 예를 들어, 스토어의 명명 규칙, 테스트 방식, 배포 파이프라인을 AI에게 알려주어 생성된 코드가 머천트의 표준에 자동으로 부합하도록 지시하는 스킬 파일을 작성할 수 있습니다.

생산성 향상은 확실하지만 한계도 있습니다. 이를 본격적으로 도입한 팀들의 경우, 상용구 GraphQL 쿼리 작성, 웹훅 핸들러 스캐폴딩, Polaris 컴포넌트 레이아웃, CLI 워크플로우 자동화 등 AI가 실제로 잘하는 작업에서 앱 개발 속도가 빨라지는 것을 확인했습니다. 그러나 아키텍처 의사결정, 교차 시스템 디버깅, 성능 최적화와 같이 Dev MCP가 노출하지 않는 맥락이 필요한 작업의 속도는 크게 향상되지 않습니다.

내 스토어에 에이전트 쇼핑 활성화하기

대부분의 Shopify 스토어는 Storefront MCP 엔드포인트가 기본적으로 활성화되어 있습니다. 30초 만에 테스트해 볼 수 있습니다:



curl -X POST https://YOUR-STORE.myshopify.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'
curl -X POST https://YOUR-STORE.myshopify.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

도구 목록이 반환된다면 스토어가 에이전트 접근 가능 상태인 것입니다. 이를 기반으로 브랜드 전용 에이전트(스토어프런트의 "쇼핑 어시스턴트" 채팅 위젯)를 빌드하려면 Shopify의 Shop Chat Agent 템플릿을 사용하는 것이 가장 빠릅니다. 임베디드 채팅 UI, MCP 클라이언트, 스트리밍 응답 처리 기능이 포함되어 있으며 LLM으로 Claude, GPT, Gemini를 선택하여 적용할 수 있는 스타터 리포지토리입니다.

자체 에이전트를 배포하고자 하는 머천트를 위한 현실적인 90일 로드맵은 다음과 같습니다:

  • 1-2주차: Shop Chat Agent 템플릿을 클론하고, 프롬프트와 UI를 브랜드에 맞게 맞춤 설정한 뒤, 선호하는 LLM을 연동합니다.

  • 3-4주차: 테스트 테마에 배포하고 장바구니, 카탈로그, 주문 상태 흐름에 대해 내부 QA를 실행합니다.

  • 5-8주차: 소규모 고객 세그먼트를 대상으로 소프트 론칭을 진행하고, 해결률(인간 상담원에게 이관되지 않고 에이전트가 자체 해결한 지원 문의 비율)을 측정합니다.

  • 9-13주차: 대화 기록을 바탕으로 프롬프트를 미세 조정하고, 브랜드 전용 정책 및 상품 지식을 추가한 뒤 전체 트래픽으로 확대 적용합니다.

가장 빈번하게 발생하는 치명적인 실수는 3~4주차 단계를 생략하는 것입니다. 내부 QA를 거치지 않으면, 스토어에서 실제로 취급하지 않는 상품을 에이전트가 자신 있게 추천하거나, 할인가 적용 오류, 잘못된 예상 배송일 반환 등 고객에게 노출되어서는 안 될 문제들이 실제 서비스 중에 노출됩니다.

에이전트 스택에서 구매 후 인프라가 차지하는 위치

에이전트는 탐색과 결제를 원활하게 처리합니다. 하지만 머천트가 에이전트 호출이 가능한 구매 후 인프라를 갖추지 않았다면, 구매 후 프로세스는 제대로 처리하지 못합니다.

주문 수정, 주소 변경, 교환, 결제 후 할인 적용 등은 구매자가 "내 주문을 변경할 수 있나요?"라고 질문할 때 에이전트가 처리해야 하는 작업입니다. Customer Accounts MCP는 에이전트에게 주문에 대한 읽기 권한만 제공하므로, 쓰기 작업(실제 주문 수정)은 다른 곳에서 실행되어야 합니다. 현재 대부분의 스토어에서는 이를 고객 지원 티켓이나 Shopify 어드민 수동 수정을 통해 처리합니다. 에이전트가 기본 CX 인터페이스가 됨에 따라 모든 머천트가 해결해야 할 공백이 바로 이 부분입니다.

Revize는 주소 변경, 옵션 변경, 상품 추가, 취소, 할인 소급 적용 등 바로 이러한 시나리오를 위해 빌드된 구매 후 수정 레이어입니다. 에이전트 호출이 시작될 때 기본 워크플로우가 즉시 작동할 수 있도록 에이전트 접근 가능한 수정 엔드포인트를 적극적으로 개발하고 있습니다. 에이전트 전략에서 구매 후 프로세스를 어떻게 배치할지 고민 중이라면 Shopify App Store에서 Revize를 검토해 보십시오.

자주 묻는 질문 (FAQ)

Shopify AI Toolkit을 한 문장으로 요약하면 무엇인가요?

Shopify AI Toolkit은 AI 코딩 어시스턴트용 Dev MCP 서버, AI 쇼핑 에이전트용 4개의 UCP 준수 MCP 서버(Storefront, Catalog, Customer Accounts, Dev), 그리고 이들을 연결하는 Universal Commerce Protocol 사양으로 구성된 3개 레이어의 패키지입니다.

Shopify AI Toolkit은 무료인가요?

네. Dev MCP 서버는 인증 없이 로컬에서 무료로 실행됩니다. Storefront MCP 엔드포인트는 추가 비용 없이 모든 스토어에 노출됩니다. Catalog MCP는 JWT 자격 증명을 위해 무료 Dev Dashboard 계정이 필요합니다. Customer Accounts MCP는 기존 Shopify 고객 인증 체계를 사용합니다.

MCP를 사용하려면 스토어가 Shopify Plus 플랜이어야 하나요?

아니요. Storefront MCP 엔드포인트는 모든 플랜의 모든 Shopify 스토어에서 기본적으로 활성화되어 있습니다. Catalog MCP는 플랜과 관계없이 Shopify의 자격 기준을 충족하는 모든 머천트의 상품에 작동합니다. 저장된 카탈로그나 맞춤형 액세스 범위와 같은 일부 고급 에이전트 커머스 기능만 Plus 플랜이 필요합니다.

Storefront MCP와 Catalog MCP의 차이점은 무엇인가요?

Storefront MCP는 단일 머천트 스토어로 범위가 제한되며 인증이 필요하지 않습니다. 구매자가 이미 쇼핑할 스토어를 선택한 경우 에이전트가 이를 사용합니다. 반면 Catalog MCP는 크로스 머천트 방식으로 동작하며 JWT 인증이 필요합니다. 구매자가 모든 Shopify 스토어를 대상으로 검색할 때 에이전트가 이를 사용합니다.

Universal Commerce Protocol이란 무엇인가요?

UCP는 AI 에이전트, 머천트, 결제 서비스 제공업체, 인증 제공업체가 커머스 거래 과정에서 통신하는 방식을 정의한 Shopify의 개방형 사양입니다. core 기능으로 탐색(Discovery), 결제(Checkout), 주문(Orders)을 정의하며, Shopify 이외의 플랫폼도 구현할 수 있도록 설계되었습니다.

ChatGPT, Claude, Gemini가 모두 Shopify의 MCP 서버를 사용하게 되나요?

이미 각사의 에이전트 및 쇼핑 모드를 통해 사용하고 있습니다. Anthropic의 MCP 표준을 기반으로 구축된 에이전트는 Shopify의 MCP 서버에 기본적으로 연결할 수 있습니다. OpenAI의 에이전트 SDK도 MCP를 직접 지원합니다. Google Gemini의 경우 Shopify 개발자 문서에 브릿징 패턴이 정의되어 있습니다.

에이전트 쇼핑을 활성화하면 전환율에 부정적인 영향을 주나요?

초기 데이터에 따르면 그렇지 않으며, 오히려 반대인 경우가 많습니다. 에이전트 기반 트래픽은 이미 구매자가 에이전트에게 원하는 것을 명확히 요청한 상태이므로 더 높은 구매 의도를 가지고 유입되는 경향이 있습니다. 또한 Storefront MCP의 update_cart 도구는 고객이 직접 탐색할 필요 없이 상품이 담긴 장바구니를 바로 제공합니다. 전환율이 떨어지는 경우는 에이전트 프롬프트가 부실하여 스토어에서 취급하지 않는 상품을 추천함으로써 고객을 이탈시키는 경우뿐입니다.

AI Toolkit은 고객 데이터 프라이버시를 어떻게 처리하나요?

Dev MCP는 개발자의 로컬 머신에서 실행되며 기본적으로 외부로 스토어 데이터를 전송하지 않습니다. Storefront MCP 호출은 서버 간 통신으로 실행되므로 개인정보(PII) 노출 우려가 없습니다. Customer Accounts MCP는 에이전트가 주문 내역이나 계정 데이터에 액세스하기 전에 고객으로부터 명시적인 OAuth 동의를 받습니다. 네 가지 레이어 모두 Shopify의 API 라이선스 및 데이터 처리 약관의 적용을 받습니다.

경쟁사의 에이전트가 MCP를 통해 내 스토어에서 거래할 수 있나요?

네, 이는 의도된 설계입니다. 모든 UCP 준수 에이전트는 Storefront MCP 엔드포인트를 통해 머천트 카탈로그를 검색하고 결제를 생성할 수 있습니다. 거래 가능한 대상을 제한하고 싶다면 기존에 사용하던 것과 동일한 제어 수단(속도 제한, IP 차단, Catalog MCP용 머천트 레벨 액세스 제한)을 적용하면 됩니다. 대부분의 머천트에게는 스토어프런트를 더 많은 에이전트에 노출하는 것이 매출 측면에서 이득입니다.

스토어가 에이전트 검색 결과에 노출되도록 하려면 무엇을 해야 하나요?

정제된 상품 데이터가 필요합니다. 에이전트는 모델에 의해 평가된 타이틀 품질, 설명 연관성, 상세 사양 완성도, 재고 신호 등을 바탕으로 상품을 노출합니다. 이는 SEO를 구동하는 필드와 동일합니다. 상품 페이지 데이터가 부실한 머천트는 에이전트 탐색 순위에서 밀려납니다. 이것이 에이전트 검색 성과를 개선하는 데 가장 큰 ROI를 제공하는 레버입니다.

AI Toolkit과 Shopify Functions의 관계는 무엇인가요?

서로 다른 레이어에 존재하며 중복되지 않습니다. Shopify Functions는 결제 진행 중 머천트를 대신해 맞춤형 결제 및 장바구니 로직을 실행합니다. 반면 AI Toolkit은 외부 에이전트가 스토어프런트와 상호작용할 수 있도록 합니다. 에이전트가 Storefront MCP의 update_cart를 호출하면, 일반적인 장바구니 업데이트와 동일하게 스토어에 구성된 모든 Functions가 트리거됩니다. Functions 마이그레이션에 대한 상세 내용은 여기에서 다룹니다.

에이전트가 내 스토어에서 수행하는 작업을 어떻게 디버깅하나요?

Storefront MCP 요청은 다른 Storefront API 호출과 동일하게 로깅되며, 어드민의 스토어 API 요청 로그에 나타납니다. 또한 자체 브랜드 에이전트에 분석 도구를 빌드할 수도 있습니다. Shop Chat Agent 템플릿에는 모든 사용자 메시지, 도구 호출, 도구 응답을 백엔드에 기록하는 대화 로그 훅이 포함되어 있습니다. 제3자 에이전트의 경우, 업스트림 에이전트 대화 내용은 볼 수 없으며 아웃바운드 API 호출만 확인할 수 있습니다.

관련 문서



2026년 8월 업데이트. Revize는 고객 셀프서비스 기반의 구매 후 주문 수정을 지원하는 Shopify 앱입니다. 배송 시작 전에 지원 티켓 없이 배송지 주소 변경, 옵션 및 상품 변경, 취소, 환불 및 스토어 크레딧 적립을 고객이 직접 처리할 수 있도록 지원합니다. 고객이 직접 Shopify 주문을 수정하도록 허용하는 방법을 자세히 알아보거나, Shopify App Store에서 Revize를 만나보십시오.

Shopify AI Toolkit은 단일 제품이 아닌 스택입니다. 이것이 바로 이 도구에 대해 가장 오해하고 있는 사실입니다. 머천트들은 "기능을 켜야 하는지" 계속 묻고, 개발자들은 어느 엔드포인트에 있는지 묻지만, 양쪽 모두 잘못된 답을 찾고 있습니다. AI Toolkit은 실제로 지난 6개월 동안 Shopify가 단일 마케팅 타이틀 아래 번들로 출시한 세 개의 개별 인프라 레이어입니다: AI 코딩 어시스턴트로 Shopify 앱을 빌드하기 위한 개발자 툴체인, AI 쇼핑 에이전트가 Shopify 스토어에서 거래할 수 있도록 하는 일련의 MCP 서버, 그리고 에이전트, 머천트, 결제 프로세서, 인증 제공업체가 표준 방식으로 통신할 수 있도록 하는 UCP라는 개방형 프로토콜입니다. 마지막 레이어는 생각보다 훨씬 중요합니다: 760만 건의 Shopify 주문 중 약 47건 중 1건(2.1%)은 결제 후 수정되며(Revize, 2026), 따라서 머천트를 대신해 거래하는 모든 에이전트는 결국 처리하도록 설계되지 않은 변경이나 취소 상황에 직면하게 됩니다.

월 1만 건 이상의 주문을 처리하는 Shopify Plus 스토어를 운영 중이라면 이 기술에 주목해야 합니다. 머천트의 계획 여부와 관계없이 스토어가 에이전트가 접근 가능한 상태로 전환될 것이기 때문입니다. 전환 품질에 집중하며 CX를 중시하는 Advanced 머천트라면 다음 세대의 "쇼핑 어시스턴트"가 구매 의도가 높은 고객을 머천트 스토어로 유도하거나 혹은 경쟁사로 보낼 수 있기 때문에 신경 써야 합니다. 또한 자신의 스토어나 App Store를 위해 Shopify 앱을 빌드하는 경우, AI Toolkit의 개발자 사이드를 도입한 팀은 일반적인 어드민 워크플로우의 개발 시간을 40-60% 단축했습니다. 이 가이드는 각 레이어의 역할과 2026년에 머천트가 주목해야 할 지점을 정리합니다.

Isometric illustration of the Shopify AI Toolkit architecture showing three layered MCP servers stacked over a Shopify storefront, rendered in purple and cream tones

Shopify AI Toolkit이란 무엇인가?

Shopify AI Toolkit은 Claude Code, Cursor, Gemini CLI, Codex, VS Code 등 AI 코딩 어시스턴트를 Shopify의 문서, API 스키마 및 로컬 CLI 기반 "스토어 실행" 기능에 직접 연결하는 개발자 지향 통합 솔루션입니다. 플러그인(권장, 자동 업데이트), 수동으로 설치할 수 있는 에이전트 스킬 세트, 그리고 인증 없이 개발자 로컬 머신에서 실행되는 로컬 Dev MCP 서버 형태로 제공됩니다.

대체 대상: 2025년 3월 3일에 단종된 기존 .dev Assistant VS Code 익스텐션입니다. 기반 기술: 2024년 말 Anthropic이 출시하고 현재 모든 주요 AI 코딩 툴이 지원하는 개방형 표준인 Model Context Protocol(MCP)입니다.




Diagram showing a developer's AI assistant connecting through the Shopify Dev MCP server to Shopify documentation, GraphQL Admin API schema, and a CLI-backed store execute pipeline

실질적인 측면에서, Toolkit의 Dev MCP 사이트가 제공하는 기능을 통해 개발자는 AI 지원 에디터를 벗어나지 않고도 다음 작업을 수행할 수 있습니다:



  • 3개월 전 일반 웹 크롤러가 색인한 정보가 아닌, 현재 API 버전에 맞는 쿼리 관련성으로 라이브 Shopify.dev 문서를 검색합니다.

  • GraphQL Admin API 스키마를 정밀 분석하여, AI 어시스턴트가 존재하지 않는 필드를 임의로 생성하는 대신 올바른 필드명과 타입으로 쿼리를 작성하도록 합니다.

  • 개발자가 코드를 실제로 실행하기도 전에, 생성된 GraphQL 코드와 컴포넌트 코드가 실제 스키마에 맞는지 검증합니다.

  • shopify store authshopify store execute를 통해 특정 스토어에 대해 검증된 Admin 작업을 실행하여, "처음 10개 상품 보여줘"를 개발자 자신의 스토어에서 가져온 실제 결과로 변환합니다.

이 마지막 기능이 일상적인 개발 방식을 가장 크게 변화시킵니다. "쿼리 작성 → 어드민 전환 → 실행 → 결과 확인 → 복귀 → 반복" 단계를 에디터 내 단일 왕복 작업으로 단축시킵니다.

하지만 이것은 세 개의 레이어 중 하나에 불과합니다. 사람들이 여기서 만족할 때 혼란이 시작됩니다.

모든 머천트가 알아야 할 세 가지 MCP 서버

Dev MCP 외에도 Shopify는 세 가지 MCP 서버를 더 제공합니다. 머천트에게 중요한 것은 바로 이것들입니다. AI 쇼핑 에이전트가 스토어프런트, 카탈로그, 고객 주문과 상호작용하는 방식을 정의하기 때문입니다.

1. Storefront MCP — 단일 머천트, 단일 에이전트

Storefront MCP 서버는 모든 개별 Shopify 스토어가 에이전트와의 상호작용을 위해 노출하는 엔드포인트입니다. 인증은 필요하지 않습니다. 엔드포인트 패턴은 https://{shop}.myshopify.com/api/mcp 이며 다음과 같은 JSON-RPC 호출을 허용합니다:



const mcpEndpoint = `https://your-store.myshopify.com/api/mcp`;

fetch(mcpEndpoint, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/call',
    id: 1,
    params: {
      name: 'search_shop_catalog',
      arguments: {
        query: 'organic coffee beans',
        context: 'customer preference for fair-trade single-origin'
      }
    }
  })
});

Storefront MCP가 노출하는 툴에는 search_shop_catalog(자연어 쿼리로 상품 검색), search_shop_policies_and_faqs(배송, 반품 등에 대한 고객 질문 답변), update_cart(장바구니 추가, 제거, 수량 업데이트), get_order_status, get_most_recent_order_status 등이 포함됩니다. 특히 마지막 기능이 중요합니다. Storefront MCP를 기반으로 구축된 AI 에이전트는 재방문 고객의 주문 상태를 확인하고, 지연을 감지하며, 반품을 시작하는 등 사람이 처리하던 CX 작업을 수행할 수 있습니다.

2. Catalog MCP — 단일 에이전트, 모든 Shopify 머천트

Catalog MCP는 반대의 개념입니다. 에이전트가 단 한 번의 호출로 적격한 모든 Shopify 머천트를 검색할 수 있도록 하는 글로벌 검색 레이어입니다. Storefront MCP와 달리, Dev Dashboard에서 발급받은 JWT 토큰(60분 TTL, 클라이언트 자격 증명을 통해 발급)을 통한 인증이 필요합니다. 사용자가 "캐나다로 배송되는 120달러 이하의 러닝화를 찾아줘"라고 요청할 때 ChatGPT의 쇼핑 모드, Perplexity의 커머스 레이어, Claude의 에이전트 통합 기능이 쿼리하는 서버가 바로 이것입니다. 개별 스토어가 아닌 Catalog MCP를 타겟팅합니다.

주요 도구는 search_global_products(가격, 배송, 상품 옵션 필터를 적용한 크로스 머천트 검색)와 get_global_product_details(해당 SKU를 판매하는 모든 머천트의 전체 옵션 매트릭스를 반환하는 Universal Product ID 조회) 두 가지입니다. 결과는 Universal Product ID (UPID) 기준으로 그룹화되므로 여러 스토어에 걸친 중복 SKU가 에이전트에게 불필요한 중복 결과를 제공하지 않도록 방지합니다.




Illustration of the four Shopify MCP servers — Dev MCP, Storefront MCP, Catalog MCP, and Customer Accounts MCP — with data flowing to AI agents and merchant stores

3. Customer Accounts MCP — 기억하는 에이전트

Customer Accounts MCP 레이어는 구매 후 경험을 가장 크게 변화시킬 가능성이 높은 레이어입니다. 고객이 계정을 보유한 머천트 전체에 걸쳐, 인증된 에이전트에게 해당 고객의 주문 내역, 주소록, 계정 상태에 대한 읽기 권한을 제공합니다. 구체적으로, 구매자의 개인 에이전트는 Customer Accounts MCP를 호출하여 "내 헤드폰 주문이 언제 도착하나요?"에 답변할 수 있으며, 고객이 지원 양식에 주문 번호를 직접 입력하지 않고도 반품을 트리거할 수 있습니다.

대량 주문을 처리하는 운영자에게 이는 1차 지원 업무의 상당 부분을 에이전트 처리 흐름으로 자동화할 수 있음을 의미합니다. CX에 집중하는 머천트에게 이것은 기회이자 위협이 될 수 있습니다. 고객을 응대하는 에이전트가 머천트 자체 에이전트인지, Shopify의 에이전트인지, 아니면 제3자 에이전트인지에 따라 달라지기 때문입니다. 초기 배포의 대부분은 하이브리드 형태입니다: 머천트 자체 브랜드 에이전트가 인증된 고객을 대신하여 Customer Accounts MCP를 호출합니다.



서버

호출 주체

인증

주요 용도

Dev MCP

AI 코딩 툴을 통한 개발자

없음 (로컬)

문서 검색, 스키마 분석, 스토어 작업 실행

Storefront MCP

에이전트 (브랜드 또는 제3자)

없음

단일 스토어 검색, 장바구니 작업, 정책 Q&A, 주문 상태 확인

Catalog MCP

에이전트 (주로 제3자)

JWT (Dev Dashboard)

크로스 머천트 상품 검색 및 조회

Customer Accounts MCP

인증된 에이전트

Shopify 계정을 통한 OAuth

주문 내역, 계정 정보, 구매 후 작업

Universal Commerce Protocol (UCP): 레이어 아래의 레이어

네 가지 MCP 서버는 모두 UCP를 준수합니다. 이 약어는 중요합니다. Universal Commerce Protocol은 플랫폼(에이전트 및 애플리케이션), 머천트, 인증 제공업체, 결제 서비스 제공업체(PSP) 등 네 가지 유형의 행위자가 커머스 거래를 위해 웹 전반에서 일관되게 통신하는 방식을 정의하기 위해 Shopify가 제정한 개방형 표준입니다.

UCP는 Shopify 전용 기술이 아닙니다. 사양이 공개되어 있어 제3자 구현이 권장되며, 명확한 목표는 OpenAI가 구축한 에이전트가 Shopify, BigCommerce 또는 맞춤형 플랫폼에서 매번 새로운 통합 코드를 작성하지 않고도 결제를 완료할 수 있는 상호 운용 가능한 레이어를 구축하는 것입니다.

UCP가 정의하는 세 가지 핵심 기능:



  1. Discovery (탐색) — 머천트 간 검색, 상품 상세 정보 조회, 구매자가 원하는 상품을 찾도록 지원. Shopify는 Catalog MCP 및 Storefront MCP를 통해 이를 구현합니다.

  2. Checkout (결제) — 결제 세션 생성, 구매자 정보 수집, 결제 수단 연결, 거래 완료. Shopify는 Storefront MCP 장바구니 툴과 별도의 Checkout Kit(임베디드 및 브라우저 기반 결제 모두 지원)의 조합을 통해 이를 구현합니다.

  3. Orders (주문) — 확정된 거래 추적, 배송 이벤트, 환불, 반품 처리. Shopify는 Customer Accounts MCP 및 기존 Admin API를 통해 이를 구현합니다.




Sequence diagram showing an AI agent completing a commerce flow across a buyer, merchant, payment service provider, and credential provider using the Universal Commerce Protocol

머천트에게 주는 실질적인 영향: Shopify를 사용 중이고 Storefront MCP를 활성화한 경우(대부분의 스토어에서 기본 활성화됨), 스토어는 이미 UCP 기반으로 구축된 에이전트에게 노출 가능한 상태입니다. "ChatGPT와 통합"하거나 "Claude와 통합"할 필요가 없습니다. UCP와 통합하면 모든 UCP 준수 에이전트가 접근할 수 있게 됩니다. 이는 1999년 SEO가 오가닉 검색 영역에서 해결한 패턴과 동일합니다. 하나의 표준, 다수의 소비자. 더 자세한 기술 사양이 궁금하다면 UCP 상세 가이드를 참고하십시오.

향후 18개월 동안 머천트에게 발생할 변화

확실성이 높은 순서대로 정리한 세 가지 구체적인 변화입니다:

1. 에이전트 기반 트래픽이 일시적 유행이 아닌 실제 채널로 자리 잡습니다. 이미 ChatGPT 기반 쇼핑 노출도가 높은 스토어의 경우 세션의 3~8%가 에이전트 추천을 통해 유입되고 있습니다. 2026년 4분기까지 대부분의 소비자 지향 AI 어시스턴트는 커머스 통합 기능을 갖추게 될 것입니다. ChatGPT 판매 가이드에서 이 채널에 특화된 전술적 최적화 방법을 다룹니다.

2. 구매 후 경험이 셀프서비스에서 에이전트 지원 서비스로 이동합니다. 주문 상태 조회, 반품 개시, 주소 변경, 할인 소급 적용 등 현재 Revize나 기타 구매 후 관리 앱이 처리하는 모든 1차 작업이 에이전트 대화 형태로 통합됩니다. 도구 호출은 기존과 동일한 API를 타겟팅하지만, 사용자 인터페이스가 웹 양식에서 자연어 대화로 이동합니다. 기본 워크플로우를 해결하지 못한 머천트는 에이전트를 도입할 준비가 되지 않은 것입니다. 에이전트는 망가진 구매 후 프로세스를 해결해 주지 않으며, 오히려 그 약점을 드러낼 뿐입니다.

3. 상품 데이터 품질이 ROI 극대화의 핵심이 됩니다. UCP 환경에서 에이전트는 상품 상세 정보를 기반으로 머천트의 상품을 구매자에게 노출할지 여부를 결정합니다. 타이틀, 설명, 기술 사양, 소재, 옵션 조합, 재고 신호 등 모든 필드가 이제 사람이 아닌 모델에 의해 평가됩니다. 정제되고 구조화된 상품 데이터를 가진 머천트는 에이전트 탐색에서 부실한 데이터를 가진 머천트보다 우위를 점하게 됩니다. 인간 고객과 달리, 에이전트는 부실한 콘텐츠를 억지로 읽어 내려가지 않으며, 단지 순위에서 제외할 뿐입니다.

개발자 또는 에이전시로서 AI Toolkit 사용하기

Toolkit의 개발자 사이드 설정 흐름은 전체 구조 중 가장 간단한 부분입니다.




Developer workstation with Claude Code open alongside terminal running Shopify CLI, with the Shopify Dev MCP server connecting both to documentation and a live development store

Claude Code를 사용하는 경우, Shopify 플러그인 설치를 한 번만 실행하면 Dev MCP 서버가 자동으로 등록됩니다. 이후 Claude Code와의 모든 대화에서 문서 검색, 스키마 분석, shopify store execute를 도구 호출로 사용할 수 있습니다. 프로젝트별 별도 설정은 필요하지 않습니다.

Cursor를 사용하는 경우, Cursor MCP 구성 파일에 Dev MCP 서버를 추가합니다. 설정은 5줄짜리 JSON 블록으로 끝납니다. 다음 재시작 시 Cursor가 해당 도구들을 자동으로 감지합니다.

Gemini CLI를 사용하는 경우, Shopify GitHub 스킬 리포지토리에서 스킬을 설치하여 통합할 수 있습니다.

플러그인과 별개인 에이전트 스킬 (Agent skills)은 리포지토리의 .agent/skills/ 디렉토리에 추가하는 마크다운 파일입니다. 프로젝트별 맞춤 설정이 필요한 경우에 적합한 패턴입니다. 예를 들어, 스토어의 명명 규칙, 테스트 방식, 배포 파이프라인을 AI에게 알려주어 생성된 코드가 머천트의 표준에 자동으로 부합하도록 지시하는 스킬 파일을 작성할 수 있습니다.

생산성 향상은 확실하지만 한계도 있습니다. 이를 본격적으로 도입한 팀들의 경우, 상용구 GraphQL 쿼리 작성, 웹훅 핸들러 스캐폴딩, Polaris 컴포넌트 레이아웃, CLI 워크플로우 자동화 등 AI가 실제로 잘하는 작업에서 앱 개발 속도가 빨라지는 것을 확인했습니다. 그러나 아키텍처 의사결정, 교차 시스템 디버깅, 성능 최적화와 같이 Dev MCP가 노출하지 않는 맥락이 필요한 작업의 속도는 크게 향상되지 않습니다.

내 스토어에 에이전트 쇼핑 활성화하기

대부분의 Shopify 스토어는 Storefront MCP 엔드포인트가 기본적으로 활성화되어 있습니다. 30초 만에 테스트해 볼 수 있습니다:



curl -X POST https://YOUR-STORE.myshopify.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

도구 목록이 반환된다면 스토어가 에이전트 접근 가능 상태인 것입니다. 이를 기반으로 브랜드 전용 에이전트(스토어프런트의 "쇼핑 어시스턴트" 채팅 위젯)를 빌드하려면 Shopify의 Shop Chat Agent 템플릿을 사용하는 것이 가장 빠릅니다. 임베디드 채팅 UI, MCP 클라이언트, 스트리밍 응답 처리 기능이 포함되어 있으며 LLM으로 Claude, GPT, Gemini를 선택하여 적용할 수 있는 스타터 리포지토리입니다.

자체 에이전트를 배포하고자 하는 머천트를 위한 현실적인 90일 로드맵은 다음과 같습니다:

  • 1-2주차: Shop Chat Agent 템플릿을 클론하고, 프롬프트와 UI를 브랜드에 맞게 맞춤 설정한 뒤, 선호하는 LLM을 연동합니다.

  • 3-4주차: 테스트 테마에 배포하고 장바구니, 카탈로그, 주문 상태 흐름에 대해 내부 QA를 실행합니다.

  • 5-8주차: 소규모 고객 세그먼트를 대상으로 소프트 론칭을 진행하고, 해결률(인간 상담원에게 이관되지 않고 에이전트가 자체 해결한 지원 문의 비율)을 측정합니다.

  • 9-13주차: 대화 기록을 바탕으로 프롬프트를 미세 조정하고, 브랜드 전용 정책 및 상품 지식을 추가한 뒤 전체 트래픽으로 확대 적용합니다.

가장 빈번하게 발생하는 치명적인 실수는 3~4주차 단계를 생략하는 것입니다. 내부 QA를 거치지 않으면, 스토어에서 실제로 취급하지 않는 상품을 에이전트가 자신 있게 추천하거나, 할인가 적용 오류, 잘못된 예상 배송일 반환 등 고객에게 노출되어서는 안 될 문제들이 실제 서비스 중에 노출됩니다.

에이전트 스택에서 구매 후 인프라가 차지하는 위치

에이전트는 탐색과 결제를 원활하게 처리합니다. 하지만 머천트가 에이전트 호출이 가능한 구매 후 인프라를 갖추지 않았다면, 구매 후 프로세스는 제대로 처리하지 못합니다.

주문 수정, 주소 변경, 교환, 결제 후 할인 적용 등은 구매자가 "내 주문을 변경할 수 있나요?"라고 질문할 때 에이전트가 처리해야 하는 작업입니다. Customer Accounts MCP는 에이전트에게 주문에 대한 읽기 권한만 제공하므로, 쓰기 작업(실제 주문 수정)은 다른 곳에서 실행되어야 합니다. 현재 대부분의 스토어에서는 이를 고객 지원 티켓이나 Shopify 어드민 수동 수정을 통해 처리합니다. 에이전트가 기본 CX 인터페이스가 됨에 따라 모든 머천트가 해결해야 할 공백이 바로 이 부분입니다.

Revize는 주소 변경, 옵션 변경, 상품 추가, 취소, 할인 소급 적용 등 바로 이러한 시나리오를 위해 빌드된 구매 후 수정 레이어입니다. 에이전트 호출이 시작될 때 기본 워크플로우가 즉시 작동할 수 있도록 에이전트 접근 가능한 수정 엔드포인트를 적극적으로 개발하고 있습니다. 에이전트 전략에서 구매 후 프로세스를 어떻게 배치할지 고민 중이라면 Shopify App Store에서 Revize를 검토해 보십시오.

자주 묻는 질문 (FAQ)

Shopify AI Toolkit을 한 문장으로 요약하면 무엇인가요?

Shopify AI Toolkit은 AI 코딩 어시스턴트용 Dev MCP 서버, AI 쇼핑 에이전트용 4개의 UCP 준수 MCP 서버(Storefront, Catalog, Customer Accounts, Dev), 그리고 이들을 연결하는 Universal Commerce Protocol 사양으로 구성된 3개 레이어의 패키지입니다.

Shopify AI Toolkit은 무료인가요?

네. Dev MCP 서버는 인증 없이 로컬에서 무료로 실행됩니다. Storefront MCP 엔드포인트는 추가 비용 없이 모든 스토어에 노출됩니다. Catalog MCP는 JWT 자격 증명을 위해 무료 Dev Dashboard 계정이 필요합니다. Customer Accounts MCP는 기존 Shopify 고객 인증 체계를 사용합니다.

MCP를 사용하려면 스토어가 Shopify Plus 플랜이어야 하나요?

아니요. Storefront MCP 엔드포인트는 모든 플랜의 모든 Shopify 스토어에서 기본적으로 활성화되어 있습니다. Catalog MCP는 플랜과 관계없이 Shopify의 자격 기준을 충족하는 모든 머천트의 상품에 작동합니다. 저장된 카탈로그나 맞춤형 액세스 범위와 같은 일부 고급 에이전트 커머스 기능만 Plus 플랜이 필요합니다.

Storefront MCP와 Catalog MCP의 차이점은 무엇인가요?

Storefront MCP는 단일 머천트 스토어로 범위가 제한되며 인증이 필요하지 않습니다. 구매자가 이미 쇼핑할 스토어를 선택한 경우 에이전트가 이를 사용합니다. 반면 Catalog MCP는 크로스 머천트 방식으로 동작하며 JWT 인증이 필요합니다. 구매자가 모든 Shopify 스토어를 대상으로 검색할 때 에이전트가 이를 사용합니다.

Universal Commerce Protocol이란 무엇인가요?

UCP는 AI 에이전트, 머천트, 결제 서비스 제공업체, 인증 제공업체가 커머스 거래 과정에서 통신하는 방식을 정의한 Shopify의 개방형 사양입니다. core 기능으로 탐색(Discovery), 결제(Checkout), 주문(Orders)을 정의하며, Shopify 이외의 플랫폼도 구현할 수 있도록 설계되었습니다.

ChatGPT, Claude, Gemini가 모두 Shopify의 MCP 서버를 사용하게 되나요?

이미 각사의 에이전트 및 쇼핑 모드를 통해 사용하고 있습니다. Anthropic의 MCP 표준을 기반으로 구축된 에이전트는 Shopify의 MCP 서버에 기본적으로 연결할 수 있습니다. OpenAI의 에이전트 SDK도 MCP를 직접 지원합니다. Google Gemini의 경우 Shopify 개발자 문서에 브릿징 패턴이 정의되어 있습니다.

에이전트 쇼핑을 활성화하면 전환율에 부정적인 영향을 주나요?

초기 데이터에 따르면 그렇지 않으며, 오히려 반대인 경우가 많습니다. 에이전트 기반 트래픽은 이미 구매자가 에이전트에게 원하는 것을 명확히 요청한 상태이므로 더 높은 구매 의도를 가지고 유입되는 경향이 있습니다. 또한 Storefront MCP의 update_cart 도구는 고객이 직접 탐색할 필요 없이 상품이 담긴 장바구니를 바로 제공합니다. 전환율이 떨어지는 경우는 에이전트 프롬프트가 부실하여 스토어에서 취급하지 않는 상품을 추천함으로써 고객을 이탈시키는 경우뿐입니다.

AI Toolkit은 고객 데이터 프라이버시를 어떻게 처리하나요?

Dev MCP는 개발자의 로컬 머신에서 실행되며 기본적으로 외부로 스토어 데이터를 전송하지 않습니다. Storefront MCP 호출은 서버 간 통신으로 실행되므로 개인정보(PII) 노출 우려가 없습니다. Customer Accounts MCP는 에이전트가 주문 내역이나 계정 데이터에 액세스하기 전에 고객으로부터 명시적인 OAuth 동의를 받습니다. 네 가지 레이어 모두 Shopify의 API 라이선스 및 데이터 처리 약관의 적용을 받습니다.

경쟁사의 에이전트가 MCP를 통해 내 스토어에서 거래할 수 있나요?

네, 이는 의도된 설계입니다. 모든 UCP 준수 에이전트는 Storefront MCP 엔드포인트를 통해 머천트 카탈로그를 검색하고 결제를 생성할 수 있습니다. 거래 가능한 대상을 제한하고 싶다면 기존에 사용하던 것과 동일한 제어 수단(속도 제한, IP 차단, Catalog MCP용 머천트 레벨 액세스 제한)을 적용하면 됩니다. 대부분의 머천트에게는 스토어프런트를 더 많은 에이전트에 노출하는 것이 매출 측면에서 이득입니다.

스토어가 에이전트 검색 결과에 노출되도록 하려면 무엇을 해야 하나요?

정제된 상품 데이터가 필요합니다. 에이전트는 모델에 의해 평가된 타이틀 품질, 설명 연관성, 상세 사양 완성도, 재고 신호 등을 바탕으로 상품을 노출합니다. 이는 SEO를 구동하는 필드와 동일합니다. 상품 페이지 데이터가 부실한 머천트는 에이전트 탐색 순위에서 밀려납니다. 이것이 에이전트 검색 성과를 개선하는 데 가장 큰 ROI를 제공하는 레버입니다.

AI Toolkit과 Shopify Functions의 관계는 무엇인가요?

서로 다른 레이어에 존재하며 중복되지 않습니다. Shopify Functions는 결제 진행 중 머천트를 대신해 맞춤형 결제 및 장바구니 로직을 실행합니다. 반면 AI Toolkit은 외부 에이전트가 스토어프런트와 상호작용할 수 있도록 합니다. 에이전트가 Storefront MCP의 update_cart를 호출하면, 일반적인 장바구니 업데이트와 동일하게 스토어에 구성된 모든 Functions가 트리거됩니다. Functions 마이그레이션에 대한 상세 내용은 여기에서 다룹니다.

에이전트가 내 스토어에서 수행하는 작업을 어떻게 디버깅하나요?

Storefront MCP 요청은 다른 Storefront API 호출과 동일하게 로깅되며, 어드민의 스토어 API 요청 로그에 나타납니다. 또한 자체 브랜드 에이전트에 분석 도구를 빌드할 수도 있습니다. Shop Chat Agent 템플릿에는 모든 사용자 메시지, 도구 호출, 도구 응답을 백엔드에 기록하는 대화 로그 훅이 포함되어 있습니다. 제3자 에이전트의 경우, 업스트림 에이전트 대화 내용은 볼 수 없으며 아웃바운드 API 호출만 확인할 수 있습니다.

관련 문서



2026년 8월 업데이트. Revize는 고객 셀프서비스 기반의 구매 후 주문 수정을 지원하는 Shopify 앱입니다. 배송 시작 전에 지원 티켓 없이 배송지 주소 변경, 옵션 및 상품 변경, 취소, 환불 및 스토어 크레딧 적립을 고객이 직접 처리할 수 있도록 지원합니다. 고객이 직접 Shopify 주문을 수정하도록 허용하는 방법을 자세히 알아보거나, Shopify App Store에서 Revize를 만나보십시오.

Shopify AI Toolkit은 단일 제품이 아닌 스택입니다. 이것이 바로 이 도구에 대해 가장 오해하고 있는 사실입니다. 머천트들은 "기능을 켜야 하는지" 계속 묻고, 개발자들은 어느 엔드포인트에 있는지 묻지만, 양쪽 모두 잘못된 답을 찾고 있습니다. AI Toolkit은 실제로 지난 6개월 동안 Shopify가 단일 마케팅 타이틀 아래 번들로 출시한 세 개의 개별 인프라 레이어입니다: AI 코딩 어시스턴트로 Shopify 앱을 빌드하기 위한 개발자 툴체인, AI 쇼핑 에이전트가 Shopify 스토어에서 거래할 수 있도록 하는 일련의 MCP 서버, 그리고 에이전트, 머천트, 결제 프로세서, 인증 제공업체가 표준 방식으로 통신할 수 있도록 하는 UCP라는 개방형 프로토콜입니다. 마지막 레이어는 생각보다 훨씬 중요합니다: 760만 건의 Shopify 주문 중 약 47건 중 1건(2.1%)은 결제 후 수정되며(Revize, 2026), 따라서 머천트를 대신해 거래하는 모든 에이전트는 결국 처리하도록 설계되지 않은 변경이나 취소 상황에 직면하게 됩니다.

월 1만 건 이상의 주문을 처리하는 Shopify Plus 스토어를 운영 중이라면 이 기술에 주목해야 합니다. 머천트의 계획 여부와 관계없이 스토어가 에이전트가 접근 가능한 상태로 전환될 것이기 때문입니다. 전환 품질에 집중하며 CX를 중시하는 Advanced 머천트라면 다음 세대의 "쇼핑 어시스턴트"가 구매 의도가 높은 고객을 머천트 스토어로 유도하거나 혹은 경쟁사로 보낼 수 있기 때문에 신경 써야 합니다. 또한 자신의 스토어나 App Store를 위해 Shopify 앱을 빌드하는 경우, AI Toolkit의 개발자 사이드를 도입한 팀은 일반적인 어드민 워크플로우의 개발 시간을 40-60% 단축했습니다. 이 가이드는 각 레이어의 역할과 2026년에 머천트가 주목해야 할 지점을 정리합니다.

Isometric illustration of the Shopify AI Toolkit architecture showing three layered MCP servers stacked over a Shopify storefront, rendered in purple and cream tones

Shopify AI Toolkit이란 무엇인가?

Shopify AI Toolkit은 Claude Code, Cursor, Gemini CLI, Codex, VS Code 등 AI 코딩 어시스턴트를 Shopify의 문서, API 스키마 및 로컬 CLI 기반 "스토어 실행" 기능에 직접 연결하는 개발자 지향 통합 솔루션입니다. 플러그인(권장, 자동 업데이트), 수동으로 설치할 수 있는 에이전트 스킬 세트, 그리고 인증 없이 개발자 로컬 머신에서 실행되는 로컬 Dev MCP 서버 형태로 제공됩니다.

대체 대상: 2025년 3월 3일에 단종된 기존 .dev Assistant VS Code 익스텐션입니다. 기반 기술: 2024년 말 Anthropic이 출시하고 현재 모든 주요 AI 코딩 툴이 지원하는 개방형 표준인 Model Context Protocol(MCP)입니다.




Diagram showing a developer's AI assistant connecting through the Shopify Dev MCP server to Shopify documentation, GraphQL Admin API schema, and a CLI-backed store execute pipeline

실질적인 측면에서, Toolkit의 Dev MCP 사이트가 제공하는 기능을 통해 개발자는 AI 지원 에디터를 벗어나지 않고도 다음 작업을 수행할 수 있습니다:



  • 3개월 전 일반 웹 크롤러가 색인한 정보가 아닌, 현재 API 버전에 맞는 쿼리 관련성으로 라이브 Shopify.dev 문서를 검색합니다.

  • GraphQL Admin API 스키마를 정밀 분석하여, AI 어시스턴트가 존재하지 않는 필드를 임의로 생성하는 대신 올바른 필드명과 타입으로 쿼리를 작성하도록 합니다.

  • 개발자가 코드를 실제로 실행하기도 전에, 생성된 GraphQL 코드와 컴포넌트 코드가 실제 스키마에 맞는지 검증합니다.

  • shopify store authshopify store execute를 통해 특정 스토어에 대해 검증된 Admin 작업을 실행하여, "처음 10개 상품 보여줘"를 개발자 자신의 스토어에서 가져온 실제 결과로 변환합니다.

이 마지막 기능이 일상적인 개발 방식을 가장 크게 변화시킵니다. "쿼리 작성 → 어드민 전환 → 실행 → 결과 확인 → 복귀 → 반복" 단계를 에디터 내 단일 왕복 작업으로 단축시킵니다.

하지만 이것은 세 개의 레이어 중 하나에 불과합니다. 사람들이 여기서 만족할 때 혼란이 시작됩니다.

모든 머천트가 알아야 할 세 가지 MCP 서버

Dev MCP 외에도 Shopify는 세 가지 MCP 서버를 더 제공합니다. 머천트에게 중요한 것은 바로 이것들입니다. AI 쇼핑 에이전트가 스토어프런트, 카탈로그, 고객 주문과 상호작용하는 방식을 정의하기 때문입니다.

1. Storefront MCP — 단일 머천트, 단일 에이전트

Storefront MCP 서버는 모든 개별 Shopify 스토어가 에이전트와의 상호작용을 위해 노출하는 엔드포인트입니다. 인증은 필요하지 않습니다. 엔드포인트 패턴은 https://{shop}.myshopify.com/api/mcp 이며 다음과 같은 JSON-RPC 호출을 허용합니다:



const mcpEndpoint = `https://your-store.myshopify.com/api/mcp`;

fetch(mcpEndpoint, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/call',
    id: 1,
    params: {
      name: 'search_shop_catalog',
      arguments: {
        query: 'organic coffee beans',
        context: 'customer preference for fair-trade single-origin'
      }
    }
  })
});

Storefront MCP가 노출하는 툴에는 search_shop_catalog(자연어 쿼리로 상품 검색), search_shop_policies_and_faqs(배송, 반품 등에 대한 고객 질문 답변), update_cart(장바구니 추가, 제거, 수량 업데이트), get_order_status, get_most_recent_order_status 등이 포함됩니다. 특히 마지막 기능이 중요합니다. Storefront MCP를 기반으로 구축된 AI 에이전트는 재방문 고객의 주문 상태를 확인하고, 지연을 감지하며, 반품을 시작하는 등 사람이 처리하던 CX 작업을 수행할 수 있습니다.

2. Catalog MCP — 단일 에이전트, 모든 Shopify 머천트

Catalog MCP는 반대의 개념입니다. 에이전트가 단 한 번의 호출로 적격한 모든 Shopify 머천트를 검색할 수 있도록 하는 글로벌 검색 레이어입니다. Storefront MCP와 달리, Dev Dashboard에서 발급받은 JWT 토큰(60분 TTL, 클라이언트 자격 증명을 통해 발급)을 통한 인증이 필요합니다. 사용자가 "캐나다로 배송되는 120달러 이하의 러닝화를 찾아줘"라고 요청할 때 ChatGPT의 쇼핑 모드, Perplexity의 커머스 레이어, Claude의 에이전트 통합 기능이 쿼리하는 서버가 바로 이것입니다. 개별 스토어가 아닌 Catalog MCP를 타겟팅합니다.

주요 도구는 search_global_products(가격, 배송, 상품 옵션 필터를 적용한 크로스 머천트 검색)와 get_global_product_details(해당 SKU를 판매하는 모든 머천트의 전체 옵션 매트릭스를 반환하는 Universal Product ID 조회) 두 가지입니다. 결과는 Universal Product ID (UPID) 기준으로 그룹화되므로 여러 스토어에 걸친 중복 SKU가 에이전트에게 불필요한 중복 결과를 제공하지 않도록 방지합니다.




Illustration of the four Shopify MCP servers — Dev MCP, Storefront MCP, Catalog MCP, and Customer Accounts MCP — with data flowing to AI agents and merchant stores

3. Customer Accounts MCP — 기억하는 에이전트

Customer Accounts MCP 레이어는 구매 후 경험을 가장 크게 변화시킬 가능성이 높은 레이어입니다. 고객이 계정을 보유한 머천트 전체에 걸쳐, 인증된 에이전트에게 해당 고객의 주문 내역, 주소록, 계정 상태에 대한 읽기 권한을 제공합니다. 구체적으로, 구매자의 개인 에이전트는 Customer Accounts MCP를 호출하여 "내 헤드폰 주문이 언제 도착하나요?"에 답변할 수 있으며, 고객이 지원 양식에 주문 번호를 직접 입력하지 않고도 반품을 트리거할 수 있습니다.

대량 주문을 처리하는 운영자에게 이는 1차 지원 업무의 상당 부분을 에이전트 처리 흐름으로 자동화할 수 있음을 의미합니다. CX에 집중하는 머천트에게 이것은 기회이자 위협이 될 수 있습니다. 고객을 응대하는 에이전트가 머천트 자체 에이전트인지, Shopify의 에이전트인지, 아니면 제3자 에이전트인지에 따라 달라지기 때문입니다. 초기 배포의 대부분은 하이브리드 형태입니다: 머천트 자체 브랜드 에이전트가 인증된 고객을 대신하여 Customer Accounts MCP를 호출합니다.



서버

호출 주체

인증

주요 용도

Dev MCP

AI 코딩 툴을 통한 개발자

없음 (로컬)

문서 검색, 스키마 분석, 스토어 작업 실행

Storefront MCP

에이전트 (브랜드 또는 제3자)

없음

단일 스토어 검색, 장바구니 작업, 정책 Q&A, 주문 상태 확인

Catalog MCP

에이전트 (주로 제3자)

JWT (Dev Dashboard)

크로스 머천트 상품 검색 및 조회

Customer Accounts MCP

인증된 에이전트

Shopify 계정을 통한 OAuth

주문 내역, 계정 정보, 구매 후 작업

Universal Commerce Protocol (UCP): 레이어 아래의 레이어

네 가지 MCP 서버는 모두 UCP를 준수합니다. 이 약어는 중요합니다. Universal Commerce Protocol은 플랫폼(에이전트 및 애플리케이션), 머천트, 인증 제공업체, 결제 서비스 제공업체(PSP) 등 네 가지 유형의 행위자가 커머스 거래를 위해 웹 전반에서 일관되게 통신하는 방식을 정의하기 위해 Shopify가 제정한 개방형 표준입니다.

UCP는 Shopify 전용 기술이 아닙니다. 사양이 공개되어 있어 제3자 구현이 권장되며, 명확한 목표는 OpenAI가 구축한 에이전트가 Shopify, BigCommerce 또는 맞춤형 플랫폼에서 매번 새로운 통합 코드를 작성하지 않고도 결제를 완료할 수 있는 상호 운용 가능한 레이어를 구축하는 것입니다.

UCP가 정의하는 세 가지 핵심 기능:



  1. Discovery (탐색) — 머천트 간 검색, 상품 상세 정보 조회, 구매자가 원하는 상품을 찾도록 지원. Shopify는 Catalog MCP 및 Storefront MCP를 통해 이를 구현합니다.

  2. Checkout (결제) — 결제 세션 생성, 구매자 정보 수집, 결제 수단 연결, 거래 완료. Shopify는 Storefront MCP 장바구니 툴과 별도의 Checkout Kit(임베디드 및 브라우저 기반 결제 모두 지원)의 조합을 통해 이를 구현합니다.

  3. Orders (주문) — 확정된 거래 추적, 배송 이벤트, 환불, 반품 처리. Shopify는 Customer Accounts MCP 및 기존 Admin API를 통해 이를 구현합니다.




Sequence diagram showing an AI agent completing a commerce flow across a buyer, merchant, payment service provider, and credential provider using the Universal Commerce Protocol

머천트에게 주는 실질적인 영향: Shopify를 사용 중이고 Storefront MCP를 활성화한 경우(대부분의 스토어에서 기본 활성화됨), 스토어는 이미 UCP 기반으로 구축된 에이전트에게 노출 가능한 상태입니다. "ChatGPT와 통합"하거나 "Claude와 통합"할 필요가 없습니다. UCP와 통합하면 모든 UCP 준수 에이전트가 접근할 수 있게 됩니다. 이는 1999년 SEO가 오가닉 검색 영역에서 해결한 패턴과 동일합니다. 하나의 표준, 다수의 소비자. 더 자세한 기술 사양이 궁금하다면 UCP 상세 가이드를 참고하십시오.

향후 18개월 동안 머천트에게 발생할 변화

확실성이 높은 순서대로 정리한 세 가지 구체적인 변화입니다:

1. 에이전트 기반 트래픽이 일시적 유행이 아닌 실제 채널로 자리 잡습니다. 이미 ChatGPT 기반 쇼핑 노출도가 높은 스토어의 경우 세션의 3~8%가 에이전트 추천을 통해 유입되고 있습니다. 2026년 4분기까지 대부분의 소비자 지향 AI 어시스턴트는 커머스 통합 기능을 갖추게 될 것입니다. ChatGPT 판매 가이드에서 이 채널에 특화된 전술적 최적화 방법을 다룹니다.

2. 구매 후 경험이 셀프서비스에서 에이전트 지원 서비스로 이동합니다. 주문 상태 조회, 반품 개시, 주소 변경, 할인 소급 적용 등 현재 Revize나 기타 구매 후 관리 앱이 처리하는 모든 1차 작업이 에이전트 대화 형태로 통합됩니다. 도구 호출은 기존과 동일한 API를 타겟팅하지만, 사용자 인터페이스가 웹 양식에서 자연어 대화로 이동합니다. 기본 워크플로우를 해결하지 못한 머천트는 에이전트를 도입할 준비가 되지 않은 것입니다. 에이전트는 망가진 구매 후 프로세스를 해결해 주지 않으며, 오히려 그 약점을 드러낼 뿐입니다.

3. 상품 데이터 품질이 ROI 극대화의 핵심이 됩니다. UCP 환경에서 에이전트는 상품 상세 정보를 기반으로 머천트의 상품을 구매자에게 노출할지 여부를 결정합니다. 타이틀, 설명, 기술 사양, 소재, 옵션 조합, 재고 신호 등 모든 필드가 이제 사람이 아닌 모델에 의해 평가됩니다. 정제되고 구조화된 상품 데이터를 가진 머천트는 에이전트 탐색에서 부실한 데이터를 가진 머천트보다 우위를 점하게 됩니다. 인간 고객과 달리, 에이전트는 부실한 콘텐츠를 억지로 읽어 내려가지 않으며, 단지 순위에서 제외할 뿐입니다.

개발자 또는 에이전시로서 AI Toolkit 사용하기

Toolkit의 개발자 사이드 설정 흐름은 전체 구조 중 가장 간단한 부분입니다.




Developer workstation with Claude Code open alongside terminal running Shopify CLI, with the Shopify Dev MCP server connecting both to documentation and a live development store

Claude Code를 사용하는 경우, Shopify 플러그인 설치를 한 번만 실행하면 Dev MCP 서버가 자동으로 등록됩니다. 이후 Claude Code와의 모든 대화에서 문서 검색, 스키마 분석, shopify store execute를 도구 호출로 사용할 수 있습니다. 프로젝트별 별도 설정은 필요하지 않습니다.

Cursor를 사용하는 경우, Cursor MCP 구성 파일에 Dev MCP 서버를 추가합니다. 설정은 5줄짜리 JSON 블록으로 끝납니다. 다음 재시작 시 Cursor가 해당 도구들을 자동으로 감지합니다.

Gemini CLI를 사용하는 경우, Shopify GitHub 스킬 리포지토리에서 스킬을 설치하여 통합할 수 있습니다.

플러그인과 별개인 에이전트 스킬 (Agent skills)은 리포지토리의 .agent/skills/ 디렉토리에 추가하는 마크다운 파일입니다. 프로젝트별 맞춤 설정이 필요한 경우에 적합한 패턴입니다. 예를 들어, 스토어의 명명 규칙, 테스트 방식, 배포 파이프라인을 AI에게 알려주어 생성된 코드가 머천트의 표준에 자동으로 부합하도록 지시하는 스킬 파일을 작성할 수 있습니다.

생산성 향상은 확실하지만 한계도 있습니다. 이를 본격적으로 도입한 팀들의 경우, 상용구 GraphQL 쿼리 작성, 웹훅 핸들러 스캐폴딩, Polaris 컴포넌트 레이아웃, CLI 워크플로우 자동화 등 AI가 실제로 잘하는 작업에서 앱 개발 속도가 빨라지는 것을 확인했습니다. 그러나 아키텍처 의사결정, 교차 시스템 디버깅, 성능 최적화와 같이 Dev MCP가 노출하지 않는 맥락이 필요한 작업의 속도는 크게 향상되지 않습니다.

내 스토어에 에이전트 쇼핑 활성화하기

대부분의 Shopify 스토어는 Storefront MCP 엔드포인트가 기본적으로 활성화되어 있습니다. 30초 만에 테스트해 볼 수 있습니다:



curl -X POST https://YOUR-STORE.myshopify.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

도구 목록이 반환된다면 스토어가 에이전트 접근 가능 상태인 것입니다. 이를 기반으로 브랜드 전용 에이전트(스토어프런트의 "쇼핑 어시스턴트" 채팅 위젯)를 빌드하려면 Shopify의 Shop Chat Agent 템플릿을 사용하는 것이 가장 빠릅니다. 임베디드 채팅 UI, MCP 클라이언트, 스트리밍 응답 처리 기능이 포함되어 있으며 LLM으로 Claude, GPT, Gemini를 선택하여 적용할 수 있는 스타터 리포지토리입니다.

자체 에이전트를 배포하고자 하는 머천트를 위한 현실적인 90일 로드맵은 다음과 같습니다:

  • 1-2주차: Shop Chat Agent 템플릿을 클론하고, 프롬프트와 UI를 브랜드에 맞게 맞춤 설정한 뒤, 선호하는 LLM을 연동합니다.

  • 3-4주차: 테스트 테마에 배포하고 장바구니, 카탈로그, 주문 상태 흐름에 대해 내부 QA를 실행합니다.

  • 5-8주차: 소규모 고객 세그먼트를 대상으로 소프트 론칭을 진행하고, 해결률(인간 상담원에게 이관되지 않고 에이전트가 자체 해결한 지원 문의 비율)을 측정합니다.

  • 9-13주차: 대화 기록을 바탕으로 프롬프트를 미세 조정하고, 브랜드 전용 정책 및 상품 지식을 추가한 뒤 전체 트래픽으로 확대 적용합니다.

가장 빈번하게 발생하는 치명적인 실수는 3~4주차 단계를 생략하는 것입니다. 내부 QA를 거치지 않으면, 스토어에서 실제로 취급하지 않는 상품을 에이전트가 자신 있게 추천하거나, 할인가 적용 오류, 잘못된 예상 배송일 반환 등 고객에게 노출되어서는 안 될 문제들이 실제 서비스 중에 노출됩니다.

에이전트 스택에서 구매 후 인프라가 차지하는 위치

에이전트는 탐색과 결제를 원활하게 처리합니다. 하지만 머천트가 에이전트 호출이 가능한 구매 후 인프라를 갖추지 않았다면, 구매 후 프로세스는 제대로 처리하지 못합니다.

주문 수정, 주소 변경, 교환, 결제 후 할인 적용 등은 구매자가 "내 주문을 변경할 수 있나요?"라고 질문할 때 에이전트가 처리해야 하는 작업입니다. Customer Accounts MCP는 에이전트에게 주문에 대한 읽기 권한만 제공하므로, 쓰기 작업(실제 주문 수정)은 다른 곳에서 실행되어야 합니다. 현재 대부분의 스토어에서는 이를 고객 지원 티켓이나 Shopify 어드민 수동 수정을 통해 처리합니다. 에이전트가 기본 CX 인터페이스가 됨에 따라 모든 머천트가 해결해야 할 공백이 바로 이 부분입니다.

Revize는 주소 변경, 옵션 변경, 상품 추가, 취소, 할인 소급 적용 등 바로 이러한 시나리오를 위해 빌드된 구매 후 수정 레이어입니다. 에이전트 호출이 시작될 때 기본 워크플로우가 즉시 작동할 수 있도록 에이전트 접근 가능한 수정 엔드포인트를 적극적으로 개발하고 있습니다. 에이전트 전략에서 구매 후 프로세스를 어떻게 배치할지 고민 중이라면 Shopify App Store에서 Revize를 검토해 보십시오.

자주 묻는 질문 (FAQ)

Shopify AI Toolkit을 한 문장으로 요약하면 무엇인가요?

Shopify AI Toolkit은 AI 코딩 어시스턴트용 Dev MCP 서버, AI 쇼핑 에이전트용 4개의 UCP 준수 MCP 서버(Storefront, Catalog, Customer Accounts, Dev), 그리고 이들을 연결하는 Universal Commerce Protocol 사양으로 구성된 3개 레이어의 패키지입니다.

Shopify AI Toolkit은 무료인가요?

네. Dev MCP 서버는 인증 없이 로컬에서 무료로 실행됩니다. Storefront MCP 엔드포인트는 추가 비용 없이 모든 스토어에 노출됩니다. Catalog MCP는 JWT 자격 증명을 위해 무료 Dev Dashboard 계정이 필요합니다. Customer Accounts MCP는 기존 Shopify 고객 인증 체계를 사용합니다.

MCP를 사용하려면 스토어가 Shopify Plus 플랜이어야 하나요?

아니요. Storefront MCP 엔드포인트는 모든 플랜의 모든 Shopify 스토어에서 기본적으로 활성화되어 있습니다. Catalog MCP는 플랜과 관계없이 Shopify의 자격 기준을 충족하는 모든 머천트의 상품에 작동합니다. 저장된 카탈로그나 맞춤형 액세스 범위와 같은 일부 고급 에이전트 커머스 기능만 Plus 플랜이 필요합니다.

Storefront MCP와 Catalog MCP의 차이점은 무엇인가요?

Storefront MCP는 단일 머천트 스토어로 범위가 제한되며 인증이 필요하지 않습니다. 구매자가 이미 쇼핑할 스토어를 선택한 경우 에이전트가 이를 사용합니다. 반면 Catalog MCP는 크로스 머천트 방식으로 동작하며 JWT 인증이 필요합니다. 구매자가 모든 Shopify 스토어를 대상으로 검색할 때 에이전트가 이를 사용합니다.

Universal Commerce Protocol이란 무엇인가요?

UCP는 AI 에이전트, 머천트, 결제 서비스 제공업체, 인증 제공업체가 커머스 거래 과정에서 통신하는 방식을 정의한 Shopify의 개방형 사양입니다. core 기능으로 탐색(Discovery), 결제(Checkout), 주문(Orders)을 정의하며, Shopify 이외의 플랫폼도 구현할 수 있도록 설계되었습니다.

ChatGPT, Claude, Gemini가 모두 Shopify의 MCP 서버를 사용하게 되나요?

이미 각사의 에이전트 및 쇼핑 모드를 통해 사용하고 있습니다. Anthropic의 MCP 표준을 기반으로 구축된 에이전트는 Shopify의 MCP 서버에 기본적으로 연결할 수 있습니다. OpenAI의 에이전트 SDK도 MCP를 직접 지원합니다. Google Gemini의 경우 Shopify 개발자 문서에 브릿징 패턴이 정의되어 있습니다.

에이전트 쇼핑을 활성화하면 전환율에 부정적인 영향을 주나요?

초기 데이터에 따르면 그렇지 않으며, 오히려 반대인 경우가 많습니다. 에이전트 기반 트래픽은 이미 구매자가 에이전트에게 원하는 것을 명확히 요청한 상태이므로 더 높은 구매 의도를 가지고 유입되는 경향이 있습니다. 또한 Storefront MCP의 update_cart 도구는 고객이 직접 탐색할 필요 없이 상품이 담긴 장바구니를 바로 제공합니다. 전환율이 떨어지는 경우는 에이전트 프롬프트가 부실하여 스토어에서 취급하지 않는 상품을 추천함으로써 고객을 이탈시키는 경우뿐입니다.

AI Toolkit은 고객 데이터 프라이버시를 어떻게 처리하나요?

Dev MCP는 개발자의 로컬 머신에서 실행되며 기본적으로 외부로 스토어 데이터를 전송하지 않습니다. Storefront MCP 호출은 서버 간 통신으로 실행되므로 개인정보(PII) 노출 우려가 없습니다. Customer Accounts MCP는 에이전트가 주문 내역이나 계정 데이터에 액세스하기 전에 고객으로부터 명시적인 OAuth 동의를 받습니다. 네 가지 레이어 모두 Shopify의 API 라이선스 및 데이터 처리 약관의 적용을 받습니다.

경쟁사의 에이전트가 MCP를 통해 내 스토어에서 거래할 수 있나요?

네, 이는 의도된 설계입니다. 모든 UCP 준수 에이전트는 Storefront MCP 엔드포인트를 통해 머천트 카탈로그를 검색하고 결제를 생성할 수 있습니다. 거래 가능한 대상을 제한하고 싶다면 기존에 사용하던 것과 동일한 제어 수단(속도 제한, IP 차단, Catalog MCP용 머천트 레벨 액세스 제한)을 적용하면 됩니다. 대부분의 머천트에게는 스토어프런트를 더 많은 에이전트에 노출하는 것이 매출 측면에서 이득입니다.

스토어가 에이전트 검색 결과에 노출되도록 하려면 무엇을 해야 하나요?

정제된 상품 데이터가 필요합니다. 에이전트는 모델에 의해 평가된 타이틀 품질, 설명 연관성, 상세 사양 완성도, 재고 신호 등을 바탕으로 상품을 노출합니다. 이는 SEO를 구동하는 필드와 동일합니다. 상품 페이지 데이터가 부실한 머천트는 에이전트 탐색 순위에서 밀려납니다. 이것이 에이전트 검색 성과를 개선하는 데 가장 큰 ROI를 제공하는 레버입니다.

AI Toolkit과 Shopify Functions의 관계는 무엇인가요?

서로 다른 레이어에 존재하며 중복되지 않습니다. Shopify Functions는 결제 진행 중 머천트를 대신해 맞춤형 결제 및 장바구니 로직을 실행합니다. 반면 AI Toolkit은 외부 에이전트가 스토어프런트와 상호작용할 수 있도록 합니다. 에이전트가 Storefront MCP의 update_cart를 호출하면, 일반적인 장바구니 업데이트와 동일하게 스토어에 구성된 모든 Functions가 트리거됩니다. Functions 마이그레이션에 대한 상세 내용은 여기에서 다룹니다.

에이전트가 내 스토어에서 수행하는 작업을 어떻게 디버깅하나요?

Storefront MCP 요청은 다른 Storefront API 호출과 동일하게 로깅되며, 어드민의 스토어 API 요청 로그에 나타납니다. 또한 자체 브랜드 에이전트에 분석 도구를 빌드할 수도 있습니다. Shop Chat Agent 템플릿에는 모든 사용자 메시지, 도구 호출, 도구 응답을 백엔드에 기록하는 대화 로그 훅이 포함되어 있습니다. 제3자 에이전트의 경우, 업스트림 에이전트 대화 내용은 볼 수 없으며 아웃바운드 API 호출만 확인할 수 있습니다.

관련 문서



2026년 8월 업데이트. Revize는 고객 셀프서비스 기반의 구매 후 주문 수정을 지원하는 Shopify 앱입니다. 배송 시작 전에 지원 티켓 없이 배송지 주소 변경, 옵션 및 상품 변경, 취소, 환불 및 스토어 크레딧 적립을 고객이 직접 처리할 수 있도록 지원합니다. 고객이 직접 Shopify 주문을 수정하도록 허용하는 방법을 자세히 알아보거나, Shopify App Store에서 Revize를 만나보십시오.

Shopify 스토어를 개선하십시오. 고객 경험이 최우선입니다.

© Copyright 2024, All Rights Reserved

Shopify 스토어를 개선하십시오. 고객 경험이 최우선입니다.

© Copyright 2024, All Rights Reserved

Shopify 스토어를 개선하십시오. 고객 경험이 최우선입니다.

© Copyright 2024, All Rights Reserved

Shopify 스토어를 개선하십시오. 고객 경험이 최우선입니다.

© Copyright 2024, All Rights Reserved