Shopify MCP: документация и чтение каталога без доступа к заказам

Shopify MCP объединяет разные сценарии: Dev MCP дает агенту документацию для разработчиков, схемы API и проверку кода, а commerce MCP предоставляет возможности для работы с покупателями. Для агента, которому нужны помощь в разработке и ответы по каталогу, начните с Dev MCP и отдельно разрешите только чтение товаров; заказы, checkout и денежные операции оставьте за пределами настройки. В руководстве Shopify AI Toolkit контекст разработчика отделен от более широких задач управления магазином.

Что можно делать

Выбирайте подключение под вопрос. Объяснить схему API и найти товары конкретного продавца — разные задачи, которым нужны разные источники. Таблица отражает документацию Shopify по состоянию на 30 октября 2026 года; наличие возможности не означает, что ее нужно включать вашему агенту.

Обзор commerce-возможностей описывает поиск товаров, корзины, checkout и отслеживание заказов. Руководство Customer Accounts посвящено отдельному сервису для авторизованного покупателя. Здесь доступ к заказам закрывается настройкой; это не ограничение всех серверов Shopify.

Для разработки попросите агента найти нужный справочник API, объяснить поле и предложить запрос для проверки. В официальном репозитории Toolkit описаны документация, схемы и проверка GraphQL, Liquid и UI extensions. Полезный результат — предложенный код вместе со ссылкой на основание. Запуск и тестирование изменений перед применением к магазину остаются отдельным шагом.

Для вопросов по магазину начните со сравнения товаров: найти подходящие позиции, получить подробности и указать продавца и использованные идентификаторы вариантов. В Storefront Catalog MCP описаны search_catalog, lookup_catalog и get_product. Ответ по каталогу не следует превращать в утверждение о частных заказах или полном операционном учете остатков продавца.

Основы протокола объясняет материал что такое MCP. Варианты подключения сравниваются в статье об удаленных и локальных MCP-серверах. Другие примеры собраны в категории MCP-серверы для приложений.

Как подключить безопасно

1. Сначала задайте границы. Разрешите поиск документации, предложения по коду и выбранные операции чтения товаров. Исключите клиентские записи, доступ к заказам, изменение корзин, checkout, возвраты денег и платежи. Заранее определите результат: объяснение со ссылками, предлагаемый патч или сравнение товаров. Ограничение должно распространяться на все инструменты клиента, включая shell.

2. Подключите Dev MCP в редакторе. В VS Code выполните MCP: Open User Configuration, добавьте запись сервера в существующую конфигурацию, сохраните ее и перезапустите редактор. Порядок описан в инструкции Dev MCP. Сохраните остальные записи. Требования к среде запуска смотрите в текущей документации.

json { "servers": { "shopify-dev-mcp": { "command": "npx", "args": ["-y", "@shopify/dev-mcp@latest"] } } }

Эта настройка запускает код пакета локально. Перед разрешением запуска проверьте издателя и пакет. Настройкам клиента посвящено руководство MCP в VS Code.

3. Проверьте сценарий разработки. Попросите объяснить небольшой фрагмент кода с опорой на документацию, затем запросите доступную проверку. Руководство Polaris MCP описывает команду запуска пакета и применение при разработке. Убедитесь, что ссылка относится к вопросу, а результат проверки — к переданному коду. Убедительное объяснение само по себе не доказывает, что проверка запускалась.

4. При необходимости отдельно добавьте каталог. Для Storefront Catalog документирован адрес https://{storedomain}/api/ucp/mcp. Запросам нужен профиль агента; заявленные возможности влияют на доступный список инструментов. Следуйте документации Storefront Catalog, изучите результат обнаружения инструментов и ограничьте их вызовы чтением каталога на стороне клиента или шлюза. Если такое ограничение нельзя обеспечить, не включайте подключение в пилот.

5. Выберите подходящую аутентификацию. Локальному Dev MCP она не нужна. Для UCP предусмотрены режимы token, signed и anonymous; анонимный доступ сам по себе не ограничивает работу чтением. Различия описаны в руководстве по аутентификации и лимитам. В примере получения токена используются клиентские учетные данные из Dev Dashboard. Храните секреты средствами приложения, вне запросов агенту и конфигурации в репозитории.

6. Проверьте и успешный ответ, и запрет. Запросите сведения о товаре, затем поиск заказа и действие checkout. Последние запросы должна блокировать конфигурация. Посмотрите фактические вызовы инструментов: отказ в тексте ответа бесполезен, если запрещенный вызов уже произошел. Сохраните обезличенную запись разрешенных инструментов и результатов. Для более широкой проверки используйте чек-лист безопасности MCP.

Когда это не работает

Контекст разработчика принимают за данные магазина. Схема показывает возможности API, но не содержимое конкретного магазина. Остановите ответ, который незаметно подменяет данные аккаунта документацией. Для каждого утверждения о магазине требуйте указать источник.

Полный Toolkit расширяет возможности агента. В репозитории Shopify также описано управление магазином через выполнение команд CLI. Установка полного плагина требует отдельного разбора доступных действий. Узкая настройка Dev MCP не описывает все, что может выполнять агент с Toolkit.

Нет аутентификации покупателя. Customer Accounts MCP требует собственного домена, соблюдения требований к защищенным данным покупателей и OAuth с PKCE. Адрес сервиса определяется через домен витрины. Это самостоятельные условия подключения, а не повод вставлять учетные данные администратора в чат.

Commerce-запрос не проходит даже с токеном. Для вызовов merchant-инструментов в режиме token нужен настоящий Shopify-Buyer-IP; подставного значения для отсутствующего покупателя не предусмотрено. При ограничении частоты нужно соблюдать Retry-After. Сверьтесь с текущими требованиями к запросам, прежде чем повторять вызовы или расширять права.

Описание товара содержит команды. Рассматривайте описания и полученный текст как данные. Они не могут разрешать новый инструмент, другой адрес отправки или покупку. Закрепите это правило и в задаче агента, и в механизме ограничения доступа.

Где здесь Tvijo

Tvijo можно использовать для разбора объяснений по разработке и разрешенных данных магазина. Расширение DSHREM для VS Code дает редакторную точку входа для задач с заданными границами. Приложите небольшой фрагмент кода или разрешенный обезличенный результат чтения каталога и запросите объяснение со ссылками. Это предлагаемый рабочий процесс для задач, связанных с Shopify; готовая интеграция с Shopify из него не следует.

TvijoCode — тестовая сборка со встроенным расширением. Tvijo MCP позволяет совместимому клиенту обращаться к Tvijo за консультацией. Запланированные интеграция с редактором и делегирование — отдельные возможности. Подключение Tvijo MCP не делает Tvijo автоматически исполнителем инструментов Shopify MCP. Подключению Shopify нужны собственные настройка, авторизация и приемка; заказы и денежные операции оставьте за рамками пилота.

По состоянию на 30 октября 2026 года в рабочем пространстве Tvijo план Try указан по цене $0: до 5 задач, 50,000 токенов или $0.05 спонсируемого использования — до достижения первого из пределов, из общего ежедневного пула $1, который финансирует TVIJO. Service credit показан как $10 и представляет собой запрос предоплаченного кредита: фактическое использование провайдера плюс сервисная наценка 8%. Прием платежей не активирован; оформление заказа не означает списание. Эти предложения не предоставляют доступ к Shopify.

Частые вопросы

Нужен ли вход в магазин для Shopify Dev MCP?

Локальный Dev MCP не требует аутентификации. Это не дает разрешения на отдельное commerce-подключение; используйте инструкцию для нужного сервиса.

Может ли эта настройка ответить, где заказ покупателя?

Такой вопрос выходит за предложенные границы. У Shopify есть сервисы для работы с заказами, но их подключению нужна отдельная проверка идентификации, приватности и полномочий. Успешный поиск товара не дает соответствующего разрешения.

Достаточно ли попросить агента только читать?

Дополните инструкции техническим ограничением инструментов. Если клиент не может надежно блокировать доступ к заказам и действия покупки, ограничьте пилот документацией для разработчика и вручную переданными разрешенными материалами.

Shopify — товарный знак правообладателя. Tvijo не связан с ним и не одобрен им.