mcp-shopify — MCP-сервер для Claude Code: заказы и товары Shopify
Даёт агенту прямой доступ к Admin REST API Shopify: заказы, товары, клиенты, остатки и отгрузки. Пригодится, когда инструменты для магазина пишутся под Shopify, а не под региональные платформы.
claude mcp add --env SHOPIFY_SHOP=<SHOPIFY_SHOP> --env SHOPIFY_ACCESS_TOKEN=<SHOPIFY_ACCESS_TOKEN> --env SHOPIFY_API_VERSION=<SHOPIFY_API_VERSION> --transport stdio shopify -- npx -y @codespar/mcp-shopifyЧто делает mcp-shopify
Сервер поднимает 28 инструментов над Admin REST API. Среди них операции с заказами (list_orders, create_order, cancel_order), товарами и вариантами, клиентами, корректировка остатков на конкретном складе, оформление отгрузки с трекингом и возвраты по позициям. Отдельно закрыты скидки: правило цены, затем код под него, — и черновики заказов, которые потом превращаются в настоящие.
Чтобы всё это заработало, нужен custom app в админке Shopify с выданными scopes на заказы, товары, клиентов, остатки и отгрузки, а из него — токен доступа. Токен и поддомен магазина передаются через SHOPIFY_SHOP и SHOPIFY_ACCESS_TOKEN. Версия API по умолчанию — 2024-01, переопределяется через SHOPIFY_API_VERSION. Без рабочего токена сервер не пройдёт авторизацию ни на одном вызове.
По умолчанию транспорт stdio: npx @codespar/mcp-shopify. Для тестов между серверами включается HTTP через MCP_HTTP=true и MCP_PORT=3000. Токен даёт всё, что разрешено scopes приложения, поэтому лишние права лучше не выдавать: агент работает с живым магазином, и cancel_order рядом с create_refund — не игрушки.
Какие задачи решает
- собрать список заказов за период с фильтрами
- пополнить остатки конкретного варианта на складе
- оформить отгрузку и приложить трекинг-номер
- выпустить скидочный код под готовое правило цены
- вернуть деньги по отдельным позициям заказа
Примеры запросов агенту
- Покажи все заказы за прошлую неделю и отметь те, что ещё не отгружены
- Создай вариант с новым SKU у товара и поставь ему цену
- Оформи возврат по двум позициям заказа и зарегистрируй вебхук на
orders/paid
Как установить mcp-shopify
Командой платформы
claude mcp add --env SHOPIFY_SHOP=<SHOPIFY_SHOP> --env SHOPIFY_ACCESS_TOKEN=<SHOPIFY_ACCESS_TOKEN> --env SHOPIFY_API_VERSION=<SHOPIFY_API_VERSION> --transport stdio shopify -- npx -y @codespar/mcp-shopifyВместо <…> подставьте свои значения
Командой платформы
codex mcp add shopify --env SHOPIFY_SHOP=<SHOPIFY_SHOP> --env SHOPIFY_ACCESS_TOKEN=<SHOPIFY_ACCESS_TOKEN> --env SHOPIFY_API_VERSION=<SHOPIFY_API_VERSION> -- npx -y @codespar/mcp-shopifyВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-shopify"
],
"env": {
"SHOPIFY_SHOP": "<SHOPIFY_SHOP>",
"SHOPIFY_ACCESS_TOKEN": "<SHOPIFY_ACCESS_TOKEN>",
"SHOPIFY_API_VERSION": "<SHOPIFY_API_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"shopify": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-shopify"
],
"env": {
"SHOPIFY_SHOP": "<SHOPIFY_SHOP>",
"SHOPIFY_ACCESS_TOKEN": "<SHOPIFY_ACCESS_TOKEN>",
"SHOPIFY_API_VERSION": "<SHOPIFY_API_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SHOPIFY_SHOP=<SHOPIFY_SHOP> -e SHOPIFY_ACCESS_TOKEN=<SHOPIFY_ACCESS_TOKEN> -e SHOPIFY_API_VERSION=<SHOPIFY_API_VERSION> shopify npx -y @codespar/mcp-shopifyВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-shopify
Как установить mcp-shopify в Claude Code?
Через маркетплейс или напрямую командой: claude mcp add mcp-shopify -e SHOPIFY_SHOP=<SHOPIFY_SHOP> -e SHOPIFY_ACCESS_TOKEN=<SHOPIFY_ACCESS_TOKEN> -- npx -y @codespar/mcp-shopify. Есть вариант с указанием версии API: `claude mcp add --env SHOPIFY_SHOP=<SHOPIFY_SHOP> --env SHOPIFY_ACCESS_TOKEN=<SHOPIFY_ACCESS_TOKEN> --env SHOPIFY_API_VERSION=<SHOPIFY_API_VERSION> --transport stdio shopify -- npx -y @codespar/mcp-shopify`.
Что делает mcp-shopify?
Соединяет агента с Admin REST API магазина Shopify и даёт 28 инструментов: заказы, товары и варианты, клиенты, остатки, отгрузки, возвраты, скидки, метаполя и вебхуки.
Что нужно для работы сервера?
Custom app в админке Shopify с нужными Admin API scopes и его access token. Токен уходит в заголовке X-Shopify-Access-Token при каждом запросе, вместе с поддоменом магазина в SHOPIFY_SHOP.
