Версия Markdown

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

# Как подключить торгового агента к Shop MCP от Shopify

> Новый Shop MCP от Shopify связывает поиск по каталогу, корзины продавцов и оформление заказа. Это руководство по документации объясняет настройку, шаг одобрения покупателя и границы проверки заказа.

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 [запустила Shop MCP 13 октября](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 помощника. Шаги ниже основаны на документации Shopify, проверенной 14 октября. BIG CHANGE не подключала агента, не создавала корзину и не совершала покупку. Поэтому описаны ожидаемые результаты, а не наблюдаемая производительность.

## Главное изменение

- **Что изменилось:** Теперь Shopify предлагает размещённое подключение MCP — от поиска в каталоге до корзины продавца и оформления заказа. Компания также описывает завершение оплаты через Shop Pay для вошедшего в систему покупателя после явного подтверждения.
- **Кто может использовать:** Разработчики MCP-клиента с поддержкой версии протокола `2026-07-28` или кода, выполняющего описанные HTTP-запросы. Старый клиент, использующий только рукопожатие `initialize`, напрямую подключиться не сможет.
- **Что проверить:** Оформление заказа — транзакция с одним продавцом. Только `completed` вместе с `order` подтверждают покупку; корзина, ссылка на оформление заказа или обрабатываемый платёж этого не подтверждают.

## Перед подключением

Нужен MCP-клиент с поддержкой удалённых HTTP-серверов и описанного Shopify [способа подключения](https://shop.dev/docs/connect) либо приложение, вызывающее сервер по HTTP. Используйте корневой URL `https://mcp.shop.com/`; добавление `/mcp` приводит к ошибке 404. Инструменты поиска и корзины работают без аккаунта Shop. Вход позволяет помощнику использовать сохранённые предпочтения и адреса, находить заказы и предлагать Shop Pay, если продавец поддерживает его. Для помощника с собственным HTTP-кодом Shopify описывает OAuth-поток для устройства, который покупатель одобряет на сайте Shop.

До поиска выберите запрос товара, страну назначения и валюту. Отделяйте требования покупателя от контекста поиска: страна или валюта помогают локализовать результаты; ограничение цены, размер или адрес доставки — это фильтр. API указывает цены в младших денежных единицах. Приложению следует прочитать поле `messages` в ответе, прежде чем утверждать, что результат соответствует фильтру: сервис может сообщить, что нужный фильтр применить не удалось. [Руководство Shopify по поиску](https://shop.dev/docs/search) объясняет это различие и ограничение от 1 до 50 результатов на страницу.

## Описанный путь от поиска до заказа

1. **Подключите сервис и проверьте поиск.** Настройте клиент с помощью `https://mcp.shop.com/` и загрузите [Shop skill](https://shop.dev/docs/connect) от Shopify, если клиент поддерживает его. Shopify предлагает проверить подключение запросом на поиск трёх настольных ламп без создания корзины. Рабочий поиск возвращает товары с продавцом, ценой в указанной валюте и ссылкой продавца. Разработчики, использующие HTTP, могут следовать [краткому руководству JSON-RPC](https://shop.dev/docs/quickstart) Shopify с обязательными заголовками протокола и запросом `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. **Откройте и проверьте оформление заказа.** Когда покупатель спрашивает общую цену или готов купить, вызовите `create_checkout` с ID корзины либо точными ID варианта и доменом продавца из результатов поиска. Документ оформления заказа должен возвращать ID, статус, позиции, валюту, суммы, способы оплаты, `messages`, правила продавца `links` и `continue_url` для его страницы. До продолжения покажите покупателю текущие суммы с названиями, включая доставку и налоги, все предупреждения и ссылки на правила. Размещайте пояснения рядом с соответствующим товаром или полем. Передайте покупателю неизменённую `continue_url` вместе с её параметрами запроса и охватываемыми товарами, даже если агент может завершить оформление. Статус может быть `incomplete` при необходимости указать адрес или `requires_escalation`, если покупателю нужно завершить процесс на странице продавца. По умолчанию оформление заказа Shopify истекает через шесть часов.
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 и предоставить карту для собственного оформления заказа магазина; это не поток оплаты у продавца Shopify из шагов 3 и 4.
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) разработчикам, которым нужны более высокие лимиты запросов, предлагается API-ключ в Shopify Dev Dashboard, но публичная цена и таблица лимитов для него не приводятся. Цены товаров, доставка и налоги поступают из текущего оформления; перед оплатой покупателю следует проверить их. У агента также могут быть собственные расходы на хостинг или модель, если разработчик использует такие услуги. В объявлении эти расходы не оцениваются.

Неудачное чтение можно повторить после указанной `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/`. Платёжный инструмент может содержать учётные данные; не выводите и не записывайте их.

Ранее BIG CHANGE рассказывала об [инструментах оформления заказа для браузерных агентов](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout) Shopify. В этом выпуске размещённого MCP описан отдельный процесс, начинающийся с поиска в каталоге. Примечание о выпуске и руководства Shopify объясняют, что разработчики могут вызывать и какие ответы проверять; они не доказывают рост конверсии, надёжность под нагрузкой или совершённую BIG CHANGE покупку.

## Источники и дополнительная литература

- [Журнал изменений Shopify для разработчиков, «Добавление покупок и оформления Shop Pay в любой агент с помощью Shop MCP», 13 октября 2026 года](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 Pay в любой агент с помощью Shop MCP](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/) — Размещённая конечная точка, версия MCP от 2026-07-28, версия документа UCP от 2026-08-25, один продавец на оформление и подтверждение завершённого заказа.
- [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.