SkillFoxx
Telegram

MCP-сервер RetailCRM

RetailCRM MCP Server

MCP-сервер RetailCRM с готовым деплоем на Railway или Render: заказы, клиенты, товары, статистика и справочники

  • 1 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Инструменты create_order, create_customer и update_customer меняют реальные заказы и клиентов в CRM
  • Режима только для чтения нет, стоит выдавать ключу минимально нужные права и проверять его на тестовом аккаунте
Все причины и проверки
Российский стек

aryazansev/retailcrm-mcpАвтор:aryazansev

Установка

Сервисы

Ручная установка

npm install -g retailcrm-mcp

Глобальная установка перед настройкой .env и claude_desktop_config.json.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Инструменты create_order, create_customer и update_customer меняют реальные заказы и клиентов в CRM
  • Режима только для чтения нет, стоит выдавать ключу минимально нужные права и проверять его на тестовом аккаунте

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер на 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

MCP

Транспорт
stdio, http
Авторизация
API-ключ

Переменные окружения

RETAILCRM_URL обязательная
Адрес аккаунта RetailCRM вида https://ваш-аккаунт.retailcrm.ru
RETAILCRM_API_KEY обязательная, секрет
Ключ доступа к API RetailCRM с правами на нужные разделы

Ограничения

README местами не вычитан: команда git clone ссылается на несуществующий yourusername/retailcrm-mcp вместо адреса этого репозитория. Нет режима только для чтения, все инструменты создания и обновления заказов и клиентов доступны сразу после настройки одного ключа API. Нет описания прав, которые нужны ключу, кроме общей рекомендации выдать доступ на чтение заказов, клиентов и товаров.

Как отключить. Удалите запись retailcrm из claude_desktop_config.json или остановите развернутый на Railway или Render сервис.

Частые вопросы

Где взять ключ API RetailCRM?

В панели RetailCRM: Настройки, Интеграция, Ключи доступа к API. Ключу нужны права на чтение заказов, клиентов и товаров, а для create-инструментов также на запись.

Можно использовать не с Claude Desktop?

Да, режим npm run server поднимает HTTP-сервер с манифестом на /manifest, который подхватывает, например, Google AI Studio.

Обсуждение

Вопросов и отзывов пока нет.

RetailCRM — все инструменты

RetailCRM MCP

retailcrm-mcp

Российский стек

MCP-сервер RetailCRM: заказы, клиенты, товары, остатки, оплаты, задачи и аналитика магазина через API v5

MCP-серверШирокий доступ2
Российский стек

44 инструмента и 2 prompt-skills для RetailCRM на официальном PHP-клиенте: заказы, клиенты, склад, платежи, задачи и PII-free аналитика

MCP-серверШирокий доступ
Официальный

Плагин RetailCRM для Claude Code и Codex: удаленный MCP-сервер с GraphQL-запросами к CRM и скилл с правилами безопасной работы

ПлагинШирокий доступ3
Российский стек

Плагин RetailCRM: удаленный MCP-сервер по GraphQL API плюс skill, который безопасно ищет схему и подтверждает мутации у пользователя

ПлагинШирокий доступ
Российский стек

Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные

MCP-серверШирокий доступ38
Официальный

Официальный CLI и набор пакетов RetailCRM для расширений интерфейса: скаффолдинг проекта, компоненты, контексты и готовые MCP-настройки для агентов

CLIРасширенный доступ1

Коротко о README

README на русском описывает деплой на Railway или Render в один клик, установку через npm install -g или git clone, настройку .env с URL и ключом RetailCRM, два варианта подключения: локальный Claude Desktop по stdio и внешний HTTP-сервер с /health, /manifest, /tools для AI Studio, список инструментов по разделам заказы, клиенты, товары, справочники и статистика, а также команды разработки и проверку через MCP Inspector.

Бейдж для README

Сообщить о проблеме