SkillFoxx
Telegram

Spree Commerce MCP

MCP-сервер админки Spree: ассистент ищет товары, строит отчеты, отменяет заказы и правит каталог в пределах выданных прав.

  • 15 833 ★ репозитория
  • Последний коммит
  • BSD-3-Clause
MCP-серверОфициальный

Широкий доступ

Почему такой уровень

  • Ассистент отменяет заказы, фиксирует платежи и оформляет возвраты по правам пользователя.
  • Данные клиентов и заказов попадают в контекст модели.
Все причины и проверки

spree/spreeАвтор:spree

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/spree-commerce

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Ассистент отменяет заказы, фиксирует платежи и оформляет возвраты по правам пользователя.
  • Данные клиентов и заказов попадают в контекст модели.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Магазин на Spree сам размещает MCP-сервер, отдельно разворачивать ничего не нужно: гем `spree_mcp` входит в стартовый `Gemfile` новых магазинов. Адрес: `https://ваш-магазин/api/v3/admin/mcp`. Это админка с каталогом, заказами, отчетами и настройками магазина, а не витрина. Каждая задача ассистента соответствует действию Admin API: найти товары, отчитаться о продажах, отменить заказ, зафиксировать платеж, отметить доставку, добавить рынок. Права выбирает человек при подключении по OAuth, ассистент видит только одобренные задачи и никогда не выходит за права самого пользователя. Рядом есть отдельный документационный MCP `spreecommerce.org/docs/mcp` для тех, кто пишет код магазина.

Для кого. Владельцам и сотрудникам магазинов на Spree, которые хотят вести каталог, заказы и отчеты в диалоге с Claude, Cursor или ChatGPT.

Подходит, если

  • Нужно быстро выяснить, что продали в Германии за прошлый месяц, и получить отчет без выгрузки в таблицу.
  • Ассистент находит товары по условиям и правит описания пачкой.
  • Менеджер отменяет заказ или отмечает отправку и доставку прямо из диалога.
  • Разработчик магазина учит ассистента собственным задачам через пользовательские инструменты.

Не подходит, если

  • Ассистент нужен покупателям на витрине: сервер рассчитан на админку для сотрудников.
  • Идет ночная синхронизация или обмен данными без человека: для этого подходят Admin API или `spree api` CLI.
  • Сотрудникам нежелательно давать доступ к платежам и возвратам: права пришлось бы сузить при каждом подключении.

Пример запроса к агенту

Сколько заказов с доставкой в Германию было в прошлом месяце? Покажи отчет и предложи, какой заказ с ошибкой в адресе отменить, но отменяй только после моего подтверждения.

MCP

Транспорт
http
Авторизация
OAuth

Ограничения

Это серверная часть самого Spree 6 и новее: у магазина без `spree_mcp` сервера нет, его добавляют командой `spree add mcp` или строкой в `Gemfile`. Ассистент не получает ключи API, интеграции и вебхуки, роли и аккаунты сотрудников, коды подарочных карт и скидок, а также удаление клиента: эти действия за пределами сервера. Права фиксируются при подключении и не растут вместе с вашими. Ключ API сервер не принимает, для ночных задач без человека нужен Admin API. Для работы нужен вход человека в админку магазина через OAuth.

Как отключить. В админке откройте Settings, AI Agents и отзовите доступ ассистента: он перестает работать со следующего запроса. Чтобы убрать сервер совсем, удалите гем `spree_mcp` из `Gemfile`.

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

Что нужно для подключения?

Магазин на Spree 6 с `spree_mcp` и адрес `https://ваш-магазин/api/v3/admin/mcp`. Клиент отправит на вход в магазин, где вы одобряете права.

Как подключить Claude Code?

В админке откройте Settings, AI Agents, Connect an agent и выберите Claude. Вкладка Claude Code покажет готовую команду `claude mcp add --transport http` с вашим идентификатором клиента и портом `3118`.

Может ли ассистент больше, чем я?

Нет. Выдать можно только те права, что есть у вас, лишние запрошенные права отбрасываются.

Что ассистенту недоступно?

Ключи API, интеграции и вебхуки, роли, аккаунты сотрудников, коды подарочных карт и скидок, удаление клиента.

Чем это отличается от MCP документации?

Документационный сервер помогает писать код и ищет по документации Spree. Админский сервер управляет реальным магазином.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Российский стек

MCP-сервер для платформы интернет-магазинов InSales: товары, заказы, клиенты и категории через админ API

MCP-серверШирокий доступ1

RetailCRM MCP

retailcrm-mcp

Российский стек

MCP-сервер RetailCRM: заказы, клиенты, товары, остатки, оплаты, задачи и аналитика магазина через API v5

MCP-серверШирокий доступ2
Российский стек

MCP-сервер МойСклад на 60 инструментов: товары, остатки, заказы, отгрузки, приемки, платежи, отчеты по прибыли

MCP-серверШирокий доступ10
Российский стек

MCP-сервер для МойСклад: поиск товаров и остатков, контрагенты по ИНН, создание и чтение заказов, сводка по продажам одним пакетом npx

MCP-серверШирокий доступ

MCP-сервер RetailCRM

RetailCRM MCP Server

Российский стек

MCP-сервер RetailCRM с готовым деплоем на Railway или Render: заказы, клиенты, товары, статистика и справочники

MCP-серверШирокий доступ1

Локальный MCP-сервер дает ассистенту 379 инструментов eBay Sell API: листинги, заказы, выплаты, реклама и аналитика продавца.

MCP-серверШирокий доступ199

Коротко о README

README Spree упоминает локальный MCP-сервер, агентные скиллы и документационный MCP. Устройство, права и перечень задач разобраны в разделе документации `developer/mcp`.

Бейдж для README

Сообщить о проблеме