Что агент умеет делать в RetailCRM
Почти все инструменты работают с живым аккаунтом магазина. CLI embed-ui нужен разработчикам, которые пишут расширения интерфейса CRM.
- Ответы о заказах без ручных отчетов. RetailCRM MCP дает 39 инструментов, ищет и создает заказы, меняет статусы и доставку, показывает историю изменений и остатки по складам. Ответ по умолчанию приходит короткой сводкой, а полный JSON включается параметром raw.
- Склад, себестоимость и аналитика без персональных данных. MCP RetailCRM на официальном PHP-клиенте расширяет тот же сервер до 44 инструментов. Его 5 аналитических инструментов передают в связку с Яндекс Метрикой только псевдонимный HMAC-ключ, без имен, телефонов и адресов.
- Запросы к GraphQL API с подтверждением. Плагин RetailCRM для Codex и Claude Code ищет нужную операцию в схеме, собирает минимальный запрос и перед любой мутацией спрашивает разрешение пользователя.
- Быстрый сервер в облаке. MCP-сервер RetailCRM с 19 инструментами разворачивается на Railway или Render кнопкой из README и работает как с Claude Desktop, так и с внешними клиентами по HTTP.
- CRM вместе с другими сервисами. Монорепозиторий WWmcp ставит RetailCRM отдельным npm-пакетом рядом с серверами для МоегоСклада, ЮKassa, СДЭК и Битрикс24.
- Расширения интерфейса. Официальный CLI embed-ui создает проект виджета или страницы настроек и кладет в него AGENTS.md, скиллы и файл .mcp.json с описанием контекстов RetailCRM JS API.
Где взять ключ API RetailCRM
Ключ создается в разделе Настройки, Интеграция, Ключи доступа к API. При создании выбирают тип доступа. Вариант «Доступ к отдельным магазинам» ограничивает ключ выбранными магазинами, а действия включаются по группам, например «Заказы», «Клиенты» и «Справочники». Для агента лучше завести отдельный ключ и включить только нужные группы.
Запросы идут на адрес вида https://ваш-поддомен.retailcrm.ru/api/v5/, а ключ передается параметром apiKey. Если ключ видит несколько магазинов, часть методов требует код магазина в параметре site. Когда ключ готов, остается подключить сервер.
npx skillfoxx add mcp/retailcrm-mcp
Прежде чем дописать конфиг агента, CLI покажет уровень риска сервера.
Какой инструмент выбрать
Серверы и плагин работают с широким доступом, потому что создают и меняют рабочие заказы и клиентов. Минимальный уровень у embed-ui: он меняет файлы проекта расширения и к живому аккаунту не обращается. Все инструменты работают без VPN.
Для аналитика магазина лучше всего подходит RetailCRM MCP в режиме чтения. Команде, которой нужны склад, задачи и связка с Метрикой, стоит смотреть на версию с PHP-клиентом. Она тяжелее в установке и требует Docker или PHP 8.1 с Composer 2. Сервер для Railway удобен для пробы, но режима только для чтения в нем нет.
Официальный статус есть только у embed-ui. README плагина называет его официальным, однако репозиторий принадлежит личному аккаунту разработчика, а MCP-сервер работает на стороннем хосте mcp.rcrm-tech.ru без опубликованного кода.
Ограничения и безопасность
API RetailCRM принимает до 10 запросов в секунду с одного IP, а методы телефонии до 40. При превышении он отвечает ошибкой 503. Этот предел учитывает в описании и автор RetailCRM MCP.
Инструменты merge_customers и order_payment_delete необратимы. Объединенных клиентов и удаленную оплату вернуть нельзя. Серверы видят персональные данные покупателей. Поэтому ключ с доступом к клиентам стоит выдавать только под задачу. Автор сервера для Railway советует сначала проверить ключ на тестовом аккаунте.