MCP-сервер RetailCRM
RetailCRM MCP Server
MCP-сервер RetailCRM с готовым деплоем на Railway или Render: заказы, клиенты, товары, статистика и справочники
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты create_order, create_customer и update_customer меняют реальные заказы и клиентов в CRM
- Режима только для чтения нет, стоит выдавать ключу минимально нужные права и проверять его на тестовом аккаунте
Установка
Ручная установка
npm install -g retailcrm-mcpГлобальная установка перед настройкой .env и claude_desktop_config.json.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на TypeScript дает 19 инструментов поверх RetailCRM API: чтение и создание заказов, чтение, создание и обновление клиентов, каталог товаров, статистика по заказам и клиентам, справочники статусов, типов доставки и оплаты, сайтов, история изменений заказа, задачи. Работает по stdio для Claude Desktop или как HTTP-сервер с эндпоинтами /health, /manifest и /tools для внешних клиентов вроде Google AI Studio. В README есть кнопки развертывания на Railway и Render в один клик с последующим вводом ключа RetailCRM.
Для кого. Для владельцев магазинов на RetailCRM, которые хотят быстро поднять MCP-доступ к заказам и клиентам без своей инфраструктуры.
Подходит, если
- Нужно быстро развернуть MCP-сервер RetailCRM на бесплатном хостинге вроде Railway
- Нужен и stdio для Claude Desktop, и HTTP-манифест для других AI-инструментов
- Достаточно базового набора: заказы, клиенты, товары, статистика
Не подходит, если
- Нужен широкий охват API: платежи, файлы, сегменты, себестоимость - таких инструментов здесь нет
- Важна аккуратность README: в инструкции git clone остался плейсхолдер yourusername вместо реального владельца репозитория
- Нужен режим только для чтения: переключателя READONLY в README нет, инструменты создания и обновления доступны сразу
Пример запроса к агенту
Покажи последние 10 заказов в RetailCRM и создай задачу перезвонить клиенту с email test@example.comОграничения
README местами не вычитан: команда git clone ссылается на несуществующий yourusername/retailcrm-mcp вместо адреса этого репозитория. Нет режима только для чтения, все инструменты создания и обновления заказов и клиентов доступны сразу после настройки одного ключа API. Нет описания прав, которые нужны ключу, кроме общей рекомендации выдать доступ на чтение заказов, клиентов и товаров.
Как отключить. Удалите запись retailcrm из claude_desktop_config.json или остановите развернутый на Railway или Render сервис.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| RETAILCRM_URL обязательная | Адрес аккаунта RetailCRM вида https://ваш-аккаунт.retailcrm.ru |
| RETAILCRM_API_KEY обязательная, секрет | Ключ доступа к API RetailCRM с правами на нужные разделы |
Проверка безопасности
- Инструменты create_order, create_customer и update_customer меняют реальные заказы и клиентов в CRM
- Режима только для чтения нет, стоит выдавать ключу минимально нужные права и проверять его на тестовом аккаунте
Коротко о README
README на русском описывает деплой на Railway или Render в один клик, установку через npm install -g или git clone, настройку .env с URL и ключом RetailCRM, два варианта подключения: локальный Claude Desktop по stdio и внешний HTTP-сервер с /health, /manifest, /tools для AI Studio, список инструментов по разделам заказы, клиенты, товары, справочники и статистика, а также команды разработки и проверку через MCP Inspector.
Частые вопросы
Где взять ключ API RetailCRM?
В панели RetailCRM: Настройки, Интеграция, Ключи доступа к API. Ключу нужны права на чтение заказов, клиентов и товаров, а для create-инструментов также на запись.
Можно использовать не с Claude Desktop?
Да, режим npm run server поднимает HTTP-сервер с манифестом на /manifest, который подхватывает, например, Google AI Studio.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма