MCP-сервер Kommo (amoCRM)
Kommo MCP Server
MCP с 23 инструментами, ресурсами и промптами для Kommo, международной версии amoCRM: сделки, контакты, воронки, Salesbot
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты создают и меняют сделки, контакты, задачи и запускают Salesbot
- Без MCP_CONFIRM_WRITES операции записи выполняются без дополнительного подтверждения
Установка
Ручная установка
git clone https://github.com/Miguelgbastos/Kommo-MCP.git && cd Kommo-MCP && npm install && cp env.example .env && npm run build && npm startБыстрый старт из README, сервер поднимается на http://127.0.0.1:3001/mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает REST API Kommo (международный продукт российской amoCRM) в современный MCP: 23 инструмента для сделок, контактов, компаний, задач, воронок, заметок, причин отказа и запуска или остановки Salesbot, 5 ресурсов вроде отчета по продажам и дашборда, и 4 готовых промпта для анализа продаж и воронки. Отдельный инструмент ask_kommo принимает вопрос на естественном языке. Есть переключаемые транспорты stdio и Streamable HTTP, обязательная проверка Origin и токена при запуске не на localhost, и режим MCP_CONFIRM_WRITES, который требует явного confirm=true перед операциями записи.
Для кого. Для отделов продаж на Kommo или amoCRM, которым нужен полный набор инструментов с защитой от случайной записи данных.
Подходит, если
- Нужен готовый MCP с проверенными в CI тестами и обеими схемами транспорта, stdio и HTTP
- Важна защита от случайной записи: MCP_CONFIRM_WRITES требует подтверждения
- Нужны не только сырые операции с CRM, но и промпты для анализа воронки и причин отказа
Не подходит, если
- Нужен готовый npm-пакет: на момент проверки его еще не публиковали, только сборка из исходников
- Нужна отправка сообщений через Kommo: README прямо говорит, что сервер этого не делает
- Нет токена доступа к Kommo, приватной интеграции или OAuth2
Пример запроса к агенту
Покажи отчет по продажам за прошлый месяц и сравни воронки по причинам отказаОграничения
14 звезд на момент проверки, npm-пакет пока не выпущен, README и часть документации на португальском (есть отдельный README.en.md). Требует Node.js 22.13 и выше. Не отправляет сообщения клиентам: для этого README отправляет в отдельное коммьюнити с виджетом. За пределами localhost сервер отказывается стартовать без MCP_AUTH_TOKEN.
Как отключить. Остановите процесс сервера или контейнер Docker и удалите запись kommo из конфигурации MCP клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| KOMMO_BASE_URL обязательная | URL аккаунта Kommo вида https://<поддомен>.kommo.com. |
| KOMMO_ACCESS_TOKEN обязательная, секрет | Токен доступа приватной интеграции или OAuth2. |
| MCP_AUTH_TOKEN секрет | Защищает /mcp, обязателен, если сервер слушает не только localhost. |
| MCP_CONFIRM_WRITES | Требует confirm=true в инструментах, которые меняют данные. |
Проверка безопасности
- Инструменты создают и меняют сделки, контакты, задачи и запускают Salesbot
- Без MCP_CONFIRM_WRITES операции записи выполняются без дополнительного подтверждения
Коротко о README
README перечисляет 23 инструмента, 5 ресурсов и 4 промпта, таблицу переменных окружения с значениями по умолчанию, инструкции для Cursor, Claude Desktop и Docker, список HTTP-эндпоинтов health и readiness, структуру проекта и раздел troubleshooting с частыми ошибками 401, 403, 429 и 503. Лицензия MIT, есть CI, CONTRIBUTING.md и SECURITY.md.
Частые вопросы
Можно защититься от случайной массовой правки?
Да, флаг MCP_CONFIRM_WRITES=true требует confirm=true в вызове инструмента записи.
Работает с обычной amoCRM или только с Kommo?
Сервер написан под API Kommo v4, это тот же продукт amoCRM, но развернутый на домене kommo.com для международных клиентов.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма