retailCRM для MCP
Креатив IT Топ-разработчик #5 с 2015 годаretailCRM — в работе вашего ИИ-помощника
Подключите retailCRM к приложению MCP для Webasyst и работайте с CRM через привычного ИИ-агента. Найдите клиента, разберитесь в истории заказа, поставьте задачу менеджеру или подготовьте изменение данных — в одном диалоге.
230 инструментов в 26 группах доступа. От клиентов и заказов до файлов, базы знаний, программы лояльности и обращений. Вы выбираете возможности, которые нужны каждому агенту.
Находите ответы по клиентам и заказам
Ищите физических и корпоративных клиентов, открывайте карточки, контакты, компании, адреса, заметки и историю изменений.
Проверяйте заказы, статусы, оплаты и комплектацию. Просматривайте товары, предложения, группы, свойства, цены и остатки.
Получайте сведения о расходах, доставке, счетах, лояльности, звонках, обращениях и базе знаний.
Используйте справочники, пользовательские поля, словари, сегменты и данные сотрудников для точного поиска.
Переходите от вопроса к действию
Создавайте и обновляйте клиентов, заказы и задачи, добавляйте заметки и оплаты, работайте с обращениями и документами базы знаний. Для массовых сценариев доступны пакетные операции API: загрузка и сопоставление данных, изменение каталога, остатков и цен.
Загружайте файлы в retailCRM, скачивайте вложения, получайте печатные формы заказа и записи звонков. Файлы передаются через закрытое хранилище MCP-токена: без публикации общедоступных ссылок.
Операции уведомлений, телефонии, проверки кодов, интеграционных модулей и аналитики доступны в своих группах. Их работа зависит от прав API-ключа, тарифа retailCRM и подключённых сервисов.
Управляйте доступом каждого агента
Добавьте несколько аккаунтов retailCRM и выберите один из них в настройках MCP-токена. Разрешения сгруппированы по задачам: можно включить раздел целиком или отдельные инструменты. Новые инструменты требуют соответствующих прав токена.
Сначала проверьте запрос. Для операций записи есть предпросмотр без отправки в CRM. Выполнение требует явного подтверждения confirm: true . Схемы проверяют типы и вложенные поля; бизнес-правила и доступность данных проверяет retailCRM при выполнении.
Как подключить
Установите плагин в приложение MCP.
Откройте «retailCRM → Источники» в меню MCP. Добавьте каждый источник: название, HTTPS-адрес аккаунта и API-ключ. Ключ проверяется перед сохранением.
В каждом MCP-токене выберите нужный источник retailCRM и разрешённые инструменты.
Подключите MCP-клиент и начните с проверки доступа к аккаунту.
Требования и особенности
Нужны MCP 1.13.0 или новее, PHP 7.4 или новее с cURL, JSON и mbstring, аккаунт retailCRM и API-ключ с правами для выбранных операций. Shop-Script не требуется. Интерфейс доступен на русском и английском языках.
Поддерживаются HTTPS-аккаунты в доменах retailcrm.ru, retailcrm.pro и simla.com. Списки загружаются постранично. Лимит файла и ответа — 10 МБ; закрытые файлы MCP хранятся до 24 часов. Для подготовки файлов на загрузку нужно отдельно разрешить основной инструмент MCP mcp_stage_file .
Плагин охватывает все 230 исходящих операций официальной спецификации API v5. Ещё 27 описаний относятся к входящим запросам, которые реализует внешний интеграционный модуль, и не являются методами аккаунта retailCRM. Наличие инструмента не отменяет ограничений тарифа, прав ключа и настройки интеграций.
API-ключи хранятся в базе данных вашего сервера и не возвращаются в формы и обычные ответы инструментов. Администраторы базы имеют к ним доступ. Ограничьте доступ к резервным копиям и журналам MCP: в журнале могут сохраняться данные запросов и ответов.
Самостоятельная интеграция для Webasyst на основе API v5 retailCRM.



