RetailCRM MCP

Установка

{
  "mcpServers": {
    "retailcrm": {
      "command": "npx",
      "args": ["-y", "@theyahia/retailcrm-mcp"],
      "env": {
        "RETAILCRM_DOMAIN": "yourstore.retailcrm.ru",
        "RETAILCRM_API_KEY": "your-api-key"
      }
    }
  }
}

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

Что делает

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

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

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

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

Ограничения

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

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

MCP

Транспорт

stdio, http

Авторизация

API-ключ

Проверка безопасности

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

Коротко о README

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

Похожие