SkillFoxx
Telegram

MCP-сервер Kommo (amoCRM)

Kommo MCP Server

MCP с 23 инструментами, ресурсами и промптами для Kommo, международной версии amoCRM: сделки, контакты, воронки, Salesbot

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

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

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

  • Инструменты создают и меняют сделки, контакты, задачи и запускают Salesbot
  • Без MCP_CONFIRM_WRITES операции записи выполняются без дополнительного подтверждения
Все причины и проверки
Российский стек

miguelgbastos/kommo-mcpАвтор:Miguelgbastos

Установка

Сервисы

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

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.

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

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

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

  • Инструменты создают и меняют сделки, контакты, задачи и запускают Salesbot
  • Без MCP_CONFIRM_WRITES операции записи выполняются без дополнительного подтверждения

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

Что делает

Сервер оборачивает 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

Пример запроса к агенту

Покажи отчет по продажам за прошлый месяц и сравни воронки по причинам отказа

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 в инструментах, которые меняют данные.

Ограничения

14 ★ репозитория на момент проверки, npm-пакет пока не выпущен, README и часть документации на португальском (есть отдельный README.en.md). Требует Node.js 22.13 и выше. Не отправляет сообщения клиентам: для этого README отправляет в отдельное коммьюнити с виджетом. За пределами localhost сервер отказывается стартовать без MCP_AUTH_TOKEN.

Как отключить. Остановите процесс сервера или контейнер Docker и удалите запись kommo из конфигурации MCP клиента.

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

Можно защититься от случайной массовой правки?

Да, флаг MCP_CONFIRM_WRITES=true требует confirm=true в вызове инструмента записи.

Работает с обычной amoCRM или только с Kommo?

Сервер написан под API Kommo v4, это тот же продукт amoCRM, но развернутый на домене kommo.com для международных клиентов.

Обсуждение

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

amoCRM — все инструменты
Российский стек

Самостоятельно развернутый MCP на чистом Node.js с 41 инструментом для Kommo (amoCRM): сделки, воронки, задачи, очередь диалогов, salesbot

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

MCP-сервер для amoCRM и Kommo: сделки, контакты, задачи и отчеты по воронке, зависшие сделки и просроченные задачи менеджеров

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

MCP-сервер для API v4 amoCRM (Kommo): сделки, контакты, компании, задачи, воронки, неразобранное и аналитика

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

MCP-сервер для Kommo (amoCRM) с готовым npm-пакетом и автоматическим обновлением токена доступа по refresh-токену

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

Минимальный MCP-сервер для amoCRM API v4: чтение и создание сделок, контактов и примечаний, OAuth2 и долгосрочный токен

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

Компактный MCP-сервер на FastMCP с 21 инструментом для AmoCRM: контакты, сделки, задачи, примечания, теги, воронки одним файлом server.py

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

Альтернативы

Инструменты других авторов для тех же задач.

Коротко о README

README перечисляет 23 инструмента, 5 ресурсов и 4 промпта, таблицу переменных окружения с значениями по умолчанию, инструкции для Cursor, Claude Desktop и Docker, список HTTP-эндпоинтов health и readiness, структуру проекта и раздел troubleshooting с частыми ошибками 401, 403, 429 и 503. Лицензия MIT, есть CI, CONTRIBUTING.md и SECURITY.md.

Бейдж для README

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