Shopify запустила Shop MCP 13 октября, предоставив разработчикам единое размещённое подключение для поиска товаров, корзин и оформления заказов. Сервис доступен по адресу 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 способа подключения либо приложение, вызывающее сервер по HTTP. Используйте корневой URL https://mcp.shop.com/; добавление /mcp приводит к ошибке 404. Инструменты поиска и корзины работают без аккаунта Shop. Вход позволяет помощнику использовать сохранённые предпочтения и адреса, находить заказы и предлагать Shop Pay, если продавец поддерживает его. Для помощника с собственным HTTP-кодом Shopify описывает OAuth-поток для устройства, который покупатель одобряет на сайте Shop.

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

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

  1. Подключите сервис и проверьте поиск. Настройте клиент с помощью https://mcp.shop.com/ и загрузите Shop skill от Shopify, если клиент поддерживает его. Shopify предлагает проверить подключение запросом на поиск трёх настольных ламп без создания корзины. Рабочий поиск возвращает товары с продавцом, ценой в указанной валюте и ссылкой продавца. Разработчики, использующие HTTP, могут следовать краткому руководству JSON-RPC Shopify с обязательными заголовками протокола и запросом search_catalog. Это проверка только для чтения, вход не нужен.
  2. Выберите точный товар. Выполните search_catalog с запросом и требованиями покупателя. Поиск возвращает рекомендуемый вариант; если покупателю нужен другой размер или цвет, используйте get_product. Перед показом или покупкой сопоставьте product.selected и возвращённый variant.options со всеми указанными покупателем размерами, цветами и другими параметрами. Shopify предупреждает, что система может незаметно ослабить выбор. После выбора товара или изменения параметра снова вызовите get_product, чтобы проверить текущую доступность и цену. Точно сохраните ID варианта и домен продавца из ответа. Не считайте, что продавец сохранит ранее показанную цену. Показывайте предупреждение рядом с соответствующим товаром. Эти проверки описаны в разделе Поиск товаров.
  3. Создавайте корзину по запросу. Если покупатель просит собрать товары, вызовите create_cart для выбранного продавца и варианта. Корзина сохраняет товары, но не размещает заказ. Разделяйте товары разных продавцов по корзинам: Shopify указывает, что каждая корзина и оформление заказа относятся к одному продавцу. Результат должен содержать ID корзины и её позиции. Если покупатель только просматривает товары, остановитесь после поиска; в руководстве Shopify по корзинам сказано, что интерес к товару сам по себе не разрешает создавать корзину.
  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 по оформлению сказано отправлять complete_checkout только один раз после одобрения, а затем проверять полученный статус. Отдельный процесс одобрения для магазинов вне Shopify позволяет покупателю одобрить оплату в Shop и предоставить карту для собственного оформления заказа магазина; это не поток оплаты у продавца Shopify из шагов 3 и 4.
  6. Проверьте результат.Только status: completed со статусом order подтверждает, что продавец создал заказ. Если платёж ещё обрабатывается, используйте get_checkout, чтобы перечитать статус. Shopify сообщает, что при запуске вебхуков нет, поэтому интеграции нужно опрашивать get_checkout для получения обновлений. Если вызов завершения истёк по времени или ответ неясен, не отправляйте его повторно и не открывайте замену. Прочитайте существующий заказ; если в нём нет обоих статусов completed и order, сообщите покупателю, что покупка не подтверждена, и передайте continue_url.

Ограничения и восстановление

По словам Shopify, поиск работает без учётных данных. В примечании о запуске разработчикам, которым нужны более высокие лимиты запросов, предлагается API-ключ в Shopify Dev Dashboard, но публичная цена и таблица лимитов для него не приводятся. Цены товаров, доставка и налоги поступают из текущего оформления; перед оплатой покупателю следует проверить их. У агента также могут быть собственные расходы на хостинг или модель, если разработчик использует такие услуги. В объявлении эти расходы не оцениваются.

Неудачное чтение можно повторить после указанной retry_after задержки. Для создания и обновления корзин и оформления заказа в руководстве Shopify по ошибкам рекомендуется применять ключ идемпотентности и читать существующий ресурс до повтора записи с неопределённым результатом. Если запрос создания без ключа завершился ошибкой до возврата ID, результат неизвестен; не создавайте второй наугад. Для complete_checkout правило строже: никогда не повторяйте этот вызов после неопределённого ответа. Страница продавца остаётся путём для покупателя, если requires_escalation или отсутствие платёжных данных мешает агенту завершить процесс.

Считайте ID заказа, ссылки оформления, токены доступа и платёжные инструменты чувствительными данными. Shopify указывает, что ID оформления и continue_url содержат ключи доступа; не включайте их в журналы или аналитику, а ссылкой делитесь только с покупателем. В справочнике по аутентификации сказано передавать токен Shop только в заголовке авторизации к https://mcp.shop.com/. Платёжный инструмент может содержать учётные данные; не выводите и не записывайте их.

Ранее BIG CHANGE рассказывала об инструментах оформления заказа для браузерных агентов Shopify. В этом выпуске размещённого MCP описан отдельный процесс, начинающийся с поиска в каталоге. Примечание о выпуске и руководства Shopify объясняют, что разработчики могут вызывать и какие ответы проверять; они не доказывают рост конверсии, надёжность под нагрузкой или совершённую BIG CHANGE покупку.

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