MCP RetailCRM на официальном PHP-клиенте
retailcrm-mcp
44 инструмента и 2 prompt-skills для RetailCRM на официальном PHP-клиенте: заказы, клиенты, склад, платежи, задачи и PII-free аналитика
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты создают, меняют и удаляют заказы, платежи, клиентов, задачи и заметки, включая деструктивные merge_customers и order_payment_delete
- Стоит начать с RETAILCRM_READONLY=1 и ключа с минимально нужными правами
Установка
Ручная установка
docker build -t retailcrm-mcp:3.1.0 .Сборка самодостаточного образа с Node и PHP CLI перед запуском.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Инструменты создают, меняют и удаляют заказы, платежи, клиентов, задачи и заметки, включая деструктивные merge_customers и order_payment_delete
- Стоит начать с RETAILCRM_READONLY=1 и ключа с минимально нужными правами
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер разворачивается в самодостаточном Docker-образе с Node и PHP CLI и весь обычный трафик к RetailCRM API v5 проводит через официальный клиент retailcrm/api-client-php версии 6.15.32, вызываемый из Node через PHP-мост bin/retailcrm-api.php. Дает 44 инструмента: заказы и их история, клиенты и слияние дублей, товары и категории, остатки и себестоимость по складам, платежи по заказам, заметки и задачи, сегменты и статьи расходов, файлы, справочники статусов и типов доставки. По умолчанию читающие инструменты возвращают компактную выжимку вместо полного JSON RetailCRM, полный вид включается параметром detail:full. Отдельный блок из пяти инструментов дает PII-free аналитику заказов для связки с Яндекс Метрикой: только псевдонимный HMAC-ключ для join, без имен, телефонов, email и адресов, с отказом в работе, если не задан секрет HMAC длиной от 32 символов.
Для кого. Для команд RetailCRM, которым нужен продакшн-уровень охвата API: заказы, платежи, склад, задачи, плюс аналитика без утечки персональных данных.
Подходит, если
- Нужен широкий охват RetailCRM API: платежи, файлы, себестоимость, сегменты, а не только базовые заказы и клиенты
- Нужна PII-free аналитика заказов для сопоставления с UTM-метками и Яндекс Метрикой
- Нужен режим только для чтения через RETAILCRM_READONLY для безопасного тестирования
Не подходит, если
- Нет возможности собрать или запустить Docker-образ с PHP внутри: без Docker потребуется локально ставить PHP 8.1+ и Composer
- Нужен минимальный сервер без аналитики и PHP-моста: проще взять более простой форк
- RetailCRM не поддерживает создание вебхуков через API, для событий нужно настраивать Triggers в панели отдельно
Пример запроса к агенту
Покажи заказы за сегодня со статусом новый, посчитай выручку и проверь остаток товара SKU-42 по складамMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
RETAILCRM_DOMAINобязательная- Домен аккаунта RetailCRM, например yourstore.retailcrm.ru
RETAILCRM_API_KEYобязательная, секрет- Ключ API, отправляется заголовком X-API-KEY
RETAILCRM_READONLY- Значение 1 скрывает инструменты создания, обновления, слияния и удаления
RETAILCRM_ANALYTICS_HMAC_SECRETсекрет- Ключ HMAC-SHA256 не короче 32 символов для псевдонимных join-ключей аналитики, без него аналитические инструменты не работают
Ограничения
Форк theYahia/retailcrm-mcp с большими доработками: PHP-мост, 44 инструмента, аналитика. Требует Docker или локально PHP 8.1+ с cURL, JSON, mbstring, openssl и Composer 2, поэтому тяжелее в установке, чем чистый Node-сервер. Аналитические инструменты полностью отказывают в работе без RETAILCRM_ANALYTICS_HMAC_SECRET от 32 символов. Версия v3 меняет формат ответа по умолчанию на сжатую выжимку вместо сырого JSON.
Как отключить. Удалите запись retailcrm из конфигурации MCP-клиента и остановите Docker-контейнер сервера.
Частые вопросы
Как ограничить сервер только чтением?
Задать RETAILCRM_READONLY=1, тогда инструменты создания, обновления, слияния и удаления скрываются.
Почему аналитика заказов не возвращает имена и телефоны?
Это осознанное ограничение: проекция allowlist-полей исключает имена, телефоны, email, адреса и произвольные кастомные поля, для связки заказов используется только псевдонимный HMAC-ключ.
Похожие
MCP-серверыОфициальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма
Коротко о README
README подробно описывает 44 инструмента по разделам, компактный по умолчанию формат ответа с переключателями detail и raw, PII-free аналитический слой с точным описанием, какие поля никогда не отдаются, переменные окружения включая RETAILCRM_READONLY и RETAILCRM_ANALYTICS_HMAC_SECRET, запуск в Docker по stdio и HTTP, локальный запуск без Docker, архитектуру моста к официальному PHP-клиенту с единственным исключением для загрузки файлов через прямой cURL, отсутствие вебхуков в API RetailCRM и необходимость Triggers в панели.