RetailCRM plugin
Плагин RetailCRM для Claude Code и Codex: удаленный MCP-сервер с GraphQL-запросами к CRM и скилл с правилами безопасной работы
- 2 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Токен открывает заказы, клиентов и платежи магазина, а мутации меняют их в рабочей CRM
- В данных клиентов есть персональные: имена, телефоны, адреса доставки
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/retailcrm-mcp-pluginОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен открывает заказы, клиентов и платежи магазина, а мутации меняют их в рабочей CRM
- В данных клиентов есть персональные: имена, телефоны, адреса доставки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин подключает агента к RetailCRM по MCP и добавляет скилл `use-retailcrm`. Сервер работает удаленно по адресу https://mcp.rcrm-tech.ru/mcp и отдает четыре инструмента: `GqlSearchOperations` ищет операции GraphQL API, `GqlDescribeOperations` и `GqlDescribeTypes` отдают схему, `GqlExecuteOperation` выполняет запрос или мутацию. Скилл задает порядок работы. Агент находит нужную операцию, запрашивает ее контракт, собирает минимальный документ GraphQL, проверяет его по полученной схеме и только потом выполняет. Мутации идут после отдельного явного подтверждения пользователя. Прямые HTTP-запросы в обход MCP и методы, придуманные по памяти, скилл запрещает. Под скиллом лежат справочники по спискам, мутациям, повторяющимся запросам и разрешению типов схемы. Охват задач широкий: заказы, клиенты, доставки, оплаты, товары, остатки, пользователи, чаты, сообщения, быстрые ответы, боты и каналы.
Для кого. Владельцам и менеджерам интернет-магазинов на RetailCRM, которые хотят отдать агенту выгрузки по заказам, клиентам и остаткам и правки в карточках без ручной работы в интерфейсе.
Подходит, если
- Выгрузка заказов за период с фильтром по статусу и способу доставки, а писать запросы к API руками долго
- Менеджер просит найти клиента по телефону и показать его последние заказы вместе с оплатами
- Надо массово поправить поле в карточках товаров, причем агент сначала показывает, что изменит
- Понадобилось разобраться, какие операции и поля доступны в GraphQL API RetailCRM, и собрать корректный запрос
- В чатах и сообщениях требуется найти диалоги с ботом или быстрые ответы и посмотреть их содержимое
Не подходит, если
- Магазин работает на другой CRM: сервер говорит только с RetailCRM
- Требуется автоматическая обработка заказов по расписанию без человека: мутации требуют подтверждения в диалоге с агентом
- Токен выдать нельзя или права доступа нельзя ограничить: тогда агент получит больше доступа, чем нужно
- Работа внутри интерфейса RetailCRM или разработка встраиваемых модулей: для этого есть отдельные инструменты, например `@retailcrm/embed-ui`
Пример запроса к агенту
Найди заказы за прошлую неделю со статусом «ожидает оплаты» и покажи клиентов с телефонами, ничего не меняя.Ограничения
Нужен персональный токен RetailCRM: его создают на странице профиля в разделе токенов доступа вашей системы и выдают только права под планируемые операции. Токен показывается один раз. Агент читает его из переменной окружения `RETAILCRM_TOKEN`, поэтому переменную задают до запуска клиента.
Сервер удаленный, и запросы идут через сеть. Без интернета плагин не работает. Если MCP отвечает 401 или 403, скилл останавливается и просит настроить доступ вне диалога. Установка плагина сама не требует входа через OAuth.
В режиме отдельного MCP без плагина скилл с правилами не ставится, и безопасный порядок работы агенту придется описывать самому.
Как отключить. Удалите плагин средствами клиента: в Codex командой `codex plugin remove`, в Claude Code через менеджер плагинов. Отдельно подключенный сервер убирает `claude mcp remove retailcrm_mcp`. Токен в RetailCRM лучше отозвать на странице токенов доступа.
Частые вопросы
Как поставить плагин RetailCRM в Claude Code?
Добавьте marketplace командой `claude plugin marketplace add https://github.com/retailcrm/mcp-plugin.git` и выполните `claude plugin install retailcrm@retailcrm-plugin`. После установки откройте новую сессию, подключите токен через `RETAILCRM_TOKEN` и проверьте сервер командой `/mcp`.
Где взять токен для RetailCRM MCP?
Токен создают на странице `/profile/access-tokens/new` в вашей системе RetailCRM. Укажите название, при желании срок действия и только нужные права. Скопировать значение можно один раз, поэтому сохраните его сразу в переменную окружения.
Может ли агент изменить данные без моего согласия?
Нет, по правилам скилла мутация выполняется только после отдельного явного подтверждения. Ограничение действует на уровне инструкции агенту, поэтому реальные пределы задают права токена: выдайте только чтение, если менять данные не нужно.
Работает ли плагин в Codex?
Да, репозиторий устанавливается и в Codex, и в Claude Code. В Codex добавьте marketplace командой `codex plugin marketplace add https://github.com/retailcrm/mcp-plugin.git` и установите `codex plugin add retailcrm@retailcrm`.
Можно ли подключить только MCP без скилла?
Можно. Команда `claude mcp add --transport http retailcrm_mcp https://mcp.rcrm-tech.ru/mcp` с заголовком Authorization подключит сервер. Инструменты будут доступны, но правила построения и проверки запросов из скилла не установятся.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
RetailCRM — все инструментыПлагин RetailCRM для Codex и Claude Code
RetailCRM plugin
Плагин RetailCRM: удаленный MCP-сервер по GraphQL API плюс skill, который безопасно ищет схему и подтверждает мутации у пользователя
RetailCRM MCP
retailcrm-mcp
MCP-сервер RetailCRM: заказы, клиенты, товары, остатки, оплаты, задачи и аналитика магазина через API v5
MCP-сервер RetailCRM
RetailCRM MCP Server
MCP-сервер RetailCRM с готовым деплоем на Railway или Render: заказы, клиенты, товары, статистика и справочники
MCP RetailCRM на официальном PHP-клиенте
retailcrm-mcp
44 инструмента и 2 prompt-skills для RetailCRM на официальном PHP-клиенте: заказы, клиенты, склад, платежи, задачи и PII-free аналитика
embed-ui для расширений RetailCRM
@retailcrm/embed-ui
Официальный CLI и набор пакетов RetailCRM для расширений интерфейса: скаффолдинг проекта, компоненты, контексты и готовые MCP-настройки для агентов
Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные
Коротко о README
Репозиторий объединяет удаленный MCP-сервер RetailCRM и скилл в один пакет для двух клиентов. Описаны установка через marketplace, получение персонального токена, ручная настройка `~/.codex/config.toml` и `.mcp.json`, отдельное подключение сервера и обновление. Происхождение выпуска указано в `release-manifest.json`, лицензия MIT.