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

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

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

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

제한 및 복구

Shopify에 따르면 검색은 자격 증명 없이 작동합니다. 더 높은 요청 한도가 필요한 개발자는 출시 공지에 따라 Shopify Dev Dashboard의 API 키를 사용할 수 있지만, 이 키의 공개 가격이나 한도표는 제공되지 않습니다. 판매 상품 가격, 배송비, 세금은 현재 결제에서 가져오며 구매자는 결제 전에 검토해야 합니다. 개발자가 호스팅이나 모델을 사용하면 에이전트 자체 비용도 발생할 수 있습니다. 공지는 그 비용을 수치로 제시하지 않습니다.

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

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

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

출처 및 추가 읽을거리