Markdown 버전

AI-translated from English; not yet reviewed by a fluent editor.

# 쇼핑 에이전트를 Shopify Shop MCP에 연결하는 방법

> Shopify의 새 Shop MCP는 카탈로그 검색, 판매자 장바구니, 결제를 연결합니다. 이 문서 기반 안내서는 설정, 구매자 승인 단계, 주문 확인의 경계를 설명합니다.

By BIG CHANGE Editorial

Published: 2026-10-14T12:58:17.853Z
Updated: 2026-10-14T12:58:17.853Z
Canonical: https://bigchange.ai/blog/connect-shopping-agent-shopify-shop-mcp

![Conceptual charcoal illustration of a product shelf, a shopping basket holding one cup, and a blank checkout terminal; a shopper's hand pauses short of the terminal.](https://bigchange.ai/api/media/file/shop-mcp-catalog-to-checkout-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual Shop MCP interface, agent test or purchase is depicted.

Shopify는 [10월 13일 Shop MCP를 출시해](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) 개발자에게 상품 검색, 장바구니, 결제를 위한 호스팅 연결을 제공합니다. 서비스 주소는 `https://mcp.shop.com/`입니다. 17개 도구로 Shopify Catalog의 상품을 찾고 상품을 판매하는 판매자의 결제를 열 수 있습니다. 카탈로그 검색에는 API 키가 필요하지 않습니다. 실제 구매는 여전히 구매자가 승인해야 합니다.

이 안내서는 MCP 호환 어시스턴트를 구성하는 개발자를 위한 것입니다. 아래 단계는 10월 14일에 확인한 Shopify 문서를 따릅니다. BIG CHANGE는 에이전트를 연결하거나 장바구니를 만들거나 구매하지 않았습니다. 따라서 이 안내서는 관찰된 성능이 아니라 예상 결과를 설명합니다.

## 주요 변화

- **무엇이 달라졌나:** Shopify는 이제 카탈로그 검색부터 판매자 장바구니와 결제까지 이어지는 호스팅 MCP 연결을 제공합니다. 로그인한 구매자가 명시적으로 확인한 뒤 Shop Pay로 결제를 완료하는 방법도 문서화했습니다.
- **누가 사용할 수 있나:** 프로토콜 버전 `2026-07-28`을 지원하는 MCP 클라이언트 개발자 또는 문서화된 HTTP 호출을 수행하는 코드입니다. 오래된 클라이언트가 `initialize` 핸드셰이크만 지원하면 직접 연결할 수 없습니다.
- **확인할 사항:** 결제는 한 판매자와의 거래입니다. `completed`와 `order`가 함께 확인되어야 구매가 완료됩니다. 장바구니, 결제 링크 또는 처리 중인 결제만으로는 확인되지 않습니다.

## 연결하기 전에

원격 HTTP 서버를 지원하는 MCP 클라이언트와 Shopify가 문서화한 [연결 방식](https://shop.dev/docs/connect)을 지원하는 MCP 클라이언트 또는 HTTP로 서버를 호출하는 앱이 필요합니다. 루트 URL `https://mcp.shop.com/`을 사용하세요. `/mcp`를 추가하면 404가 반환됩니다. 검색 및 장바구니 도구는 Shop 계정 없이 작동합니다. 로그인하면 어시스턴트가 저장된 설정과 주소를 사용하고, 주문을 찾고, 판매자가 지원할 경우 Shop Pay를 제안할 수 있습니다. 자체 HTTP 코드를 사용하는 어시스턴트의 경우 Shopify는 구매자가 Shop 사이트에서 승인하는 OAuth 기기 흐름을 문서화했습니다.

검색 전에 상품 쿼리, 배송 국가, 통화를 선택하세요. 구매자가 말한 요구사항과 검색 맥락을 구분하세요. 국가나 통화는 결과 현지화에 도움이 되고, 가격 상한·크기·배송지는 필터입니다. API 가격은 해당 통화의 최소 단위로 표시됩니다. 서비스가 요청한 필터를 적용하지 못했다고 알릴 수 있으므로, 결과가 필터를 충족한다고 주장하기 전에 응답의 `messages` 필드를 확인해야 합니다. [Shopify 검색 안내](https://shop.dev/docs/search)에서 이 차이와 페이지당 1\~50개 결과 제한을 설명합니다.

## 검색에서 주문까지의 문서화된 경로

1. **연결하고 검색을 확인합니다.** 클라이언트에 `https://mcp.shop.com/`를 설정하고, 클라이언트가 지원하면 Shopify의 [Shop skill](https://shop.dev/docs/connect)을 불러옵니다. Shopify는 장바구니를 만들지 않고 책상 램프 세 개를 찾는 요청으로 연결을 확인하라고 권합니다. 정상 검색은 판매자, 명시된 통화의 가격, 판매자 링크가 있는 상품을 반환합니다. HTTP를 사용하는 개발자는 필수 프로토콜 헤더와 [ 요청이 포함된 Shopify의 ](https://shop.dev/docs/quickstart)JSON-RPC 빠른 시작`search_catalog`을 따를 수 있습니다. 이 검사는 읽기 전용이며 로그인할 필요가 없습니다.
2. **정확한 상품을 선택합니다.** 구매자의 쿼리와 요구사항으로 `search_catalog`를 실행합니다. 검색은 대표 옵션을 반환합니다. 구매자가 다른 크기나 색상을 원하면 `get_product`를 사용하세요. 표시하거나 구매하기 전에 `product.selected`와 반환된 `variant.options`를 구매자가 지정한 크기·색상 및 다른 선택 사항과 모두 비교합니다. Shopify는 선택 조건이 경고 없이 완화될 수 있다고 말합니다. 구매자가 상품을 고르거나 옵션을 변경하면 `get_product`를 다시 호출해 현재 재고와 가격을 확인합니다. 해당 옵션 ID와 판매자 도메인을 반환된 그대로 보존하세요. 판매자가 이전에 표시한 가격을 지킬 것이라고 가정하지 마세요. 경고는 해당 상품 옆에 표시하세요. 이러한 검사는 [상품 찾기](https://shop.dev/docs/search)에 문서화되어 있습니다.
3. **요청을 받으면 장바구니를 만듭니다.** 상품을 모아 달라는 구매자의 지시에 따라 선택한 판매자와 옵션에 대해 `create_cart`를 호출합니다. 장바구니는 상품을 저장할 뿐 주문을 넣지 않습니다. Shopify에 따르면 장바구니와 결제는 판매자 한 곳에 속하므로 다른 판매자의 상품은 별도 장바구니에 보관합니다. 결과에는 장바구니 ID와 항목이 포함되어야 합니다. 구매자가 둘러보기만 원하면 검색 후 멈추세요. Shopify의 [장바구니 안내](https://shop.dev/docs/checkout)에 따르면 상품에 대한 관심만으로 장바구니 생성 권한이 생기지는 않습니다.
4. **결제를 열고 검토합니다.** 구매자가 총액을 묻거나 구매 준비가 되면 장바구니 ID 또는 검색 결과의 정확한 옵션 ID와 판매자 도메인으로 `create_checkout`를 호출합니다. 결제 문서에는 ID, 상태, 항목, 통화, 합계, 결제 수단, `messages`, 판매자 정책 `links`, 판매자 페이지의 `continue_url`가 반환되어야 합니다. 계속하기 전에 배송비와 세금을 포함한 현재 합계와 각 항목의 의미, 모든 경고와 정책 링크를 구매자에게 보여 주세요. 설명은 해당 상품이나 필드 옆에 둡니다. 에이전트가 결제를 완료할 수 있어도 포함된 상품과 함께 쿼리 매개변수를 포함한 변경되지 않은 `continue_url`를 구매자에게 제공하세요. 주소가 필요하면 결제 상태가 `incomplete`일 수 있고, 판매자 페이지에서 구매자가 마쳐야 하면 `requires_escalation`일 수 있습니다. Shopify에 따르면 결제는 기본적으로 6시간 후 만료됩니다.
5. **결제는 구매자가 직접 하도록 합니다.** 구매자가 로그인하면 저장된 주소와 Shop Pay가 제공될 수 있습니다. `complete_checkout`를 호출하기 전에 최신 결제를 읽고 `ready_for_complete` 상태인지 확인하고, 판매자·상품·수량·합계·사용 가능한 수단을 보여 준 뒤 구매자가 결제 수단을 선택하게 합니다. 대신 선택하지 마세요. 에이전트가 결제를 완료할 수 있어도 판매자의 변경되지 않은 `continue_url`를 구매자가 사용할 수 있게 하세요. 결제 수단이 없으면 구매자가 이 링크를 사용해야 합니다. Shopify의 [결제 안내](https://shop.dev/docs/checkout)에 따르면 승인을 받은 뒤 `complete_checkout`를 한 번 전송하고 반환된 상태를 확인합니다. Shopify 외부 매장을 위한 별도의 [승인 흐름](https://shop.dev/docs/approvals)에서는 구매자가 Shop에서 결제를 승인하고 해당 매장의 자체 결제에 쓸 카드를 제공합니다. 이는 3·4단계의 Shopify 판매자 결제 흐름과 다릅니다.
6. **결과를 확인합니다.** 판매자가 주문을 생성했다는 사실은 `status: completed`와 `order`가 있어야 확인됩니다. 결제가 계속 처리 중이면 `get_checkout`를 사용해 상태를 다시 읽습니다. Shopify는 출시 시 웹훅이 없다고 하므로 통합 프로그램은 업데이트를 위해 `get_checkout`를 폴링해야 합니다. 완료 호출이 시간 초과되거나 응답이 불분명해도 다시 보내거나 대체 결제를 열지 마세요. 기존 결제를 읽으세요. `completed`와 `order`가 모두 표시되지 않으면 구매가 확인되지 않았다고 알리고 `continue_url`를 제공하세요.

## 제한 및 복구

Shopify에 따르면 검색은 자격 증명 없이 작동합니다. 더 높은 요청 한도가 필요한 개발자는 [출시 공지](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp)에 따라 Shopify Dev Dashboard의 API 키를 사용할 수 있지만, 이 키의 공개 가격이나 한도표는 제공되지 않습니다. 판매 상품 가격, 배송비, 세금은 현재 결제에서 가져오며 구매자는 결제 전에 검토해야 합니다. 개발자가 호스팅이나 모델을 사용하면 에이전트 자체 비용도 발생할 수 있습니다. 공지는 그 비용을 수치로 제시하지 않습니다.

실패한 읽기는 명시된 `retry_after` 대기 시간 후 다시 시도할 수 있습니다. 장바구니와 결제의 생성·수정에는 Shopify [오류 안내](https://shop.dev/docs/errors)가 불확실한 쓰기를 반복하기 전에 멱등성 키를 사용하고 기존 리소스를 읽으라고 권합니다. ID를 반환하기 전에 키 없이 보낸 생성 요청이 실패하면 결과를 알 수 없습니다. 추측해 다시 만들지 마세요. `complete_checkout`는 더 엄격합니다. 응답이 불확실하면 절대로 반복하지 마세요. `requires_escalation` 또는 결제 정보 누락으로 에이전트가 완료하지 못하는 경우 구매자는 판매자 페이지를 이용합니다.

결제 ID, 결제 링크, 액세스 토큰, 결제 수단은 민감 정보로 취급하세요. Shopify에 따르면 결제 ID와 `continue_url`에는 액세스 키가 있으므로 로그나 분석 데이터에 넣지 말고 링크는 구매자에게만 공유하세요. [인증 참조](https://shop.dev/docs/authentication)는 Shop 토큰을 `https://mcp.shop.com/`에 Authorization 헤더로만 보내라고 합니다. 결제 수단에는 자격 증명이 들어갈 수 있으므로 출력하거나 기록하지 마세요.

BIG CHANGE는 이전에 Shopify의 [브라우저 에이전트 결제 도구](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout)를 다뤘습니다. 이번 호스팅 MCP는 카탈로그 탐색에서 시작하는 별도 흐름을 설명합니다. Shopify의 출시 공지와 매뉴얼은 개발자가 호출할 기능과 확인할 응답을 설명할 뿐, 전환율 향상·부하 시 신뢰성·BIG CHANGE의 실제 구매를 입증하지 않습니다.

## 출처 및 추가 읽을거리

- [Shopify 개발자 변경 기록, ‘Shop MCP로 모든 에이전트에 쇼핑 및 Shop Pay 결제 추가’, 2026년 10월 13일](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp). 출시 범위, 호스팅 엔드포인트, 17개 도구, 검색 접근, 결제 경로, 출시 시 웹훅 상태.
- [Shop MCP 개요 및 연결 안내](https://shop.dev/docs/). 현재 프로토콜, 클라이언트 요건, 로그인.
- [Shopify, 상품 찾기](https://shop.dev/docs/search). 검색 필드, 옵션 선택, 가격 단위, 필터 경고.
- [Shopify, 장바구니 및 결제](https://shop.dev/docs/checkout). 판매자 범위, 상태 의미, 결제 완료, 불확실한 결과 처리.
- [Shopify, 오류 및 재시도](https://shop.dev/docs/errors). 읽기 및 쓰기 복구 규칙.
- [Shopify, 인증](https://shop.dev/docs/authentication). Shop 계정 접근 및 토큰 처리.

## Sources

- [Shopify 개발자 변경 기록, Shop MCP로 모든 에이전트에 쇼핑 및 Shop Pay 결제 추가](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) — 출시일, 실시간 엔드포인트, 17개 도구, 키 없는 카탈로그 검색, Shop 및 비-Shopify 결제 경로, 출시 시 웹훅 없음, 더 높은 한도를 위한 Dev Dashboard 키. 독립적인 결과가 아니라 Shopify의 주장입니다.
- [Shop MCP 개요](https://shop.dev/docs/) — 호스팅 엔드포인트, 2026-07-28 MCP 버전, 2026-08-25 UCP 문서 버전, 결제당 판매자 한 곳, 완료된 주문 확인.
- [Shop MCP, 에이전트 연결](https://shop.dev/docs/connect) — 루트 URL과 프로토콜 요건, 클라이언트 연결 방식, skill 로딩, 읽기 전용 연결 검사.
- [Shop MCP, 빠른 시작](https://shop.dev/docs/quickstart) — 문서화된 JSON-RPC 검색 요청, 헤더, 응답 구조, 가격 단위, 오류.
- [Shop MCP, 상품 찾기](https://shop.dev/docs/search) — 쿼리, 필터, 맥락, 대표 옵션, 경고.
- [Shop MCP, 장바구니 및 결제](https://shop.dev/docs/checkout) — 장바구니·결제 도구 동작, 판매자 범위, 결제 필드와 상태, 사람의 결제 승인, 민감 ID, 불확실한 완료 처리.
- [Shop MCP, 오류 및 재시도](https://shop.dev/docs/errors) — 읽기 복구, 결제가 아닌 쓰기에 대한 멱등성 키, 불확실한 complete_checkout 재호출 금지.
- [Shop MCP, 인증](https://shop.dev/docs/authentication) — Shop 토큰 범위, OAuth 기기 흐름, 개인 자격 증명 보호.
- [Shop MCP, Shopify 외부 구매 승인](https://shop.dev/docs/approvals) — Shopify를 쓰지 않는 판매자 결제를 위한 별도의 구매자 승인 및 카드 경로.