Shopify Admin MCP

A1 Shopify Admin MCP подключает AI-приложение к админке магазина Shopify через Admin API (GraphQL). Он помогает работать с товарами и ценами, заказами, клиентами, остатками и промокодами — на естественном языке.

Сервер привязан к одному магазину: домен задан конфигурацией, токен — Admin API access token кастомного приложения, и ни один инструмент не может уйти в чужой магазин.

• 16 инструментов. Магазин, товары и варианты, заказы, клиенты, локации и остатки, скидки — плюс произвольный GraphQL-запрос для всего остального.

• Честные HTTP 200. Мутации Shopify возвращают 200 даже при провале; сервер читает userErrors и превращает отказ в понятную ошибку. Ответ 200 без объекта data — пустой, оборванный или вовсе не GraphQL — тоже становится ошибкой, а не пустым результатом.

• Необратимые операции видны. Отмена заказа (с решениями о возврате денег и товара) и произвольный GraphQL помечены как destructive.

• Cost-бакет под контролем. Каждый ответ несёт cost: сколько стоил запрос и сколько очков осталось в бакете GraphQL.

Начните с запроса, который только читает данные:

Покажи последние заказы магазина и топ товаров с остатками.

Подключить сервер · Посмотреть сценарии · Открыть техническую документацию

Увидеть работу за минуту

Вы: Покажи последние заказы магазина и топ товаров с остатками.

Ассистент: Показывает заказы со статусами и суммами, товары с ценами и остатками. Ничего не меняется.

Вы: Подготовь скидку 20% по промокоду SUMMER на две недели.

Ассистент: Показывает параметры будущего промокода — код, размер, срок, лимиты — и запрашивает подтверждение.

Вы: Подтверждаю.

• Быстрый старт

• Что можно поручить

• Что может измениться

• Получение доступа

• Настройка

• Данные, лимиты и работа в фоне

• Техническая документация

• Поддержка

Быстрый старт

Нужны Node.js 20+, домен магазина вида my-store.myshopify.com и Admin API access token кастомного приложения (shpat_…). Для создания приложения нужны права владельца магазина или staff-права на разработку приложений.

1. Получите доступ.

2. Добавьте сервер в AI-приложение.

3. Отправьте безопасный первый запрос выше.

В Settings → Plugins → MCP servers нажмите Add server, затем добавьте npx -y mcp-shopify-admin@latest с SHOPIFY_STORE_DOMAIN и SHOPIFY_ACCESS_TOKEN.

codex mcp add shopify-admin \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  -- npx -y mcp-shopify-admin@latest
codex mcp list

Документация Codex MCP

claude mcp add \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  --transport stdio --scope user shopify-admin \
  -- npx -y mcp-shopify-admin@latest
claude mcp list

Документация Claude Code MCP

Откройте Settings → Developer → Edit Config и добавьте:

{"mcpServers":{"shopify-admin":{"command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}}

Если Edit Config недоступна, отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows. Документация Claude Desktop MCP

Добавьте {"mcpServers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}} в ~/.cursor/mcp.json на macOS/Linux или %USERPROFILE%\.cursor\mcp.json на Windows. Документация Cursor MCP

Запустите MCP: Open User Configuration и добавьте:

{"servers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"${input:shopify_store_domain}","SHOPIFY_ACCESS_TOKEN":"${input:shopify_access_token}"}}},"inputs":[{"type":"promptString","id":"shopify_store_domain","description":"Домен магазина my-store.myshopify.com"},{"type":"promptString","id":"shopify_access_token","description":"Admin API access token (shpat_…)","password":true}]}

Проверьте сервер командой MCP: List Servers. Документация VS Code MCP

Что можно поручить

• Покажи заказы за неделю, их статусы оплаты и выдачи.

• Найди товары без остатков и подними цены выбранных вариантов.

• Заведи новый товар черновиком и заполни описание.

• Поставь фактические остатки после инвентаризации.

• Создай промокод на распродажу с лимитом применений.

• Найди клиента по email и покажи его последние заказы.

Что может измениться

Создание заказов, выполнение отгрузок, изменение клиентов, публикация товаров в каналах продаж и удаление объектов не входят в набор инструментов — при необходимости это делается через graphql_request с явным подтверждением.

Получение доступа

1. Откройте админку магазина: Settings → Apps and sales channels → Develop apps (включите разработку приложений, если она выключена).

2. Создайте приложение и на вкладке Configuration выдайте нужные Admin API access scopes: read_products/write_products, read_orders, read_customers, read_locations/write_inventory, read_discounts/write_discounts — по вашим сценариям.

3. Установите приложение и на вкладке API credentials скопируйте Admin API access token (shpat_…; показывается один раз).

4. Передайте домен и токен как SHOPIFY_STORE_DOMAIN и SHOPIFY_ACCESS_TOKEN.

Токен статический и привязан к магазину. Храните его как пароль. Если позже выдать приложению новые scopes, Shopify выпустит новый токен — обновите переменную и перезапустите сервер. Для безопасных репетиций удобен development store.

Настройка

Данные, лимиты и работа в фоне

• Cost-бакет GraphQL. Каждый запрос стоит очков по сложности; бакет восстанавливается каждую секунду. Одна страница first до 250 экономнее серии мелких; сервер показывает cost с каждым результатом.

• Временные ошибки. THROTTLED повторяется автоматически с ожиданием из математики бакета. Мутации не повторяются после сетевой или 5xx ошибки, чтобы не применить изменение дважды.

• Заказы старше 60 дней требуют scope read_all_orders, который Shopify выдаёт по запросу; без него старые заказы просто не приходят.

• Постоянного наблюдения нет. Сервер работает только при вызове. Если AI-приложение поддерживает задания по расписанию, оно может периодически проверять заказы и остатки.

• Анонимная телеметрия. В неё не попадают секреты, данные магазина, аргументы и промпты; отключение: ASKADS_TELEMETRY=0.

Техническая документация

• Каталог MCP-возможностей — страницы по пользовательским задачам для каждого инструмента.

• Все инструменты и параметры

• Документация по разработке

• Документация по публикации

• Документация Shopify Admin API (GraphQL)

Поддержка

Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.