RetailCRM MCP

retailcrm-mcp

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

  • 1 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

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

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

  • Создает и меняет заказы, клиентов и оплаты в рабочей CRM
  • Объединение клиентов и удаление оплат необратимы
  • Работает с персональными данными покупателей
Все причины и проверки
Российский стек

theyahia/retailcrm-mcp

Установка

Сервисы

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

npx skillfoxx add mcp/retailcrm-mcp

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

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

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

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

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

  • Создает и меняет заказы, клиентов и оплаты в рабочей CRM
  • Объединение клиентов и удаление оплат необратимы
  • Работает с персональными данными покупателей

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

Что делает

Сервер дает агенту 39 инструментов поверх API v5 RetailCRM. Агент ищет и создает заказы и клиентов, меняет статусы и доставку, смотрит историю изменений, остатки по складам, сегменты, расходы и справочники. Оплаты по заказу можно создать, изменить и удалить, дубли клиентов объединить. По умолчанию ответы приходят короткой сводкой нужных полей, полный объем включается параметром detail или raw. Переменная RETAILCRM_READONLY оставляет только читающие инструменты.

Для кого. Для интернет-магазинов на RetailCRM, которым нужны ответы о заказах и клиентах без ручных отчетов.

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

  • Нужно быстро узнать статус, состав и оплату заказа по номеру
  • Нужна сводка заказов и выручки за день или период
  • Нужно проверить остаток товара по складам

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

  • Нужны вебхуки: RetailCRM не создает их через API, для этого есть триггеры в админке
  • Агенту нельзя доверить изменение заказов и оплат, а режим только для чтения вы не включите

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

Покажи заказы в статусе «новый», созданные сегодня, с итоговой выручкой

MCP

Транспорт
stdio, http
Авторизация
API-ключ

Переменные окружения

RETAILCRM_DOMAIN обязательная
Домен аккаунта, например yourstore.retailcrm.ru
RETAILCRM_API_KEY обязательная, секрет
Ключ API из раздела Интеграция
RETAILCRM_READONLY
1 оставляет только читающие инструменты
RETAILCRM_RATE_LIMIT
Ограничение запросов в секунду на стороне клиента

Ограничения

Нужен ключ API RetailCRM с правами на нужные разделы, для мультисайтового ключа код site передается вручную. Версия 3 по умолчанию отдает сводку вместо сырого JSON, для старого формата нужен raw:true. merge_customers и order_payment_delete необратимы. RetailCRM допускает около 10 запросов в секунду.

Как отключить. Удалите блок retailcrm из конфигурации MCP клиента и отзовите ключ API в настройках RetailCRM.

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

Как запретить агенту менять данные?

Задайте RETAILCRM_READONLY=1, тогда инструменты создания, изменения, объединения и удаления скрываются.

Где взять ключ?

В RetailCRM: Настройки, Интеграция, Ключи API. Там же выбираются права ключа.

Обсуждение

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

MCP-сервер RetailCRM

RetailCRM MCP Server

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

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

MCP-серверШирокий доступ1Звезды репозитория
Российский стек

44 инструмента и 2 prompt-skills для RetailCRM на официальном PHP-клиенте: заказы, клиенты, склад, платежи, задачи и PII-free аналитика

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

Плагин RetailCRM: удаленный MCP-сервер по GraphQL API плюс skill, который безопасно ищет схему и подтверждает мутации у пользователя

ПлагинШирокий доступ
Российский стек

Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные

MCP-серверШирокий доступ36Звезды репозитория
Официальный

Официальный CLI и набор пакетов RetailCRM для расширений интерфейса: скаффолдинг проекта, компоненты, контексты и готовые MCP-настройки для агентов

CLIРасширенный доступ1Звезды репозитория
Российский стек

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

MCP-серверШирокий доступ10Звезды репозитория

Коротко о README

README перечисляет 39 инструментов по группам: заказы, клиенты, товары и остатки, оплаты, заметки и задачи, маркетинг, файлы, справочники и аналитика, плюс два промпта. Описаны параметры подробности ответа, получение ключа, переменные окружения, конфигурация для Claude Desktop, режим Streamable HTTP и установка через Smithery. Есть демо-промпты, раздел про вебхуки и обработку ошибок с повторами. Сервер входит в серию WWmcp, лицензия MIT.

Бейдж для README

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

Foxx AIRetailCRM MCP
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.