MCP-сервер Kommo для SDR-агентов
Kommo MCP Server
Мультитенантный MCP для Kommo (amoCRM) на Fastify с подтверждением операций над несколькими записями и кешем воронок
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты меняют лиды, добавляют заметки и задачи в реальном аккаунте Kommo
- Составной Bearer-токен несет данные доступа сразу нескольких аккаунтов клиентов
Установка
Ручная установка
npm install && npm run build && npm startТребует .env с MCP_PASSWORD, PORT и HOST, скопированный из .env.example.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Fastify отдает семь инструментов для работы с лидами Kommo: список и поиск лидов, обновление лида, добавление заметок и задач, список воронок, этапов и дополнительных полей с кешем на 10 минут и час соответственно. Один Bearer-токен несет сразу три части: пароль сервера, поддомен и токен доступа Kommo, поэтому один сервер может обслуживать разные аккаунты. Отдельная система одобрения через MCP sampling переспрашивает пользователя, если под операцию (например, добавить заметку определенному человеку) подходит два и более лида.
Для кого. Для агентств, которые обслуживают несколько аккаунтов Kommo одним сервером, и для сценариев автоматизации через n8n.
Подходит, если
- Нужен один сервер на несколько аккаунтов Kommo без переразвертывания
- Важно подтверждение перед операцией, если под запрос попадает несколько записей
- Сценарий строится на n8n с шагами начать сеанс, обновить, добавить заметку, завершить
Не подходит, если
- Нужен широкий набор инструментов: здесь только семь, только для лидов, заметок, задач и справочников
- Нужны контакты и компании как отдельные сущности: сервер работает через лиды
Пример запроса к агенту
Добавь заметку лиду Лукас Кардозо о переносе звонка на завтраОграничения
2 звезды, последний пуш в декабре 2025 года. MCP_PASSWORD обязателен, без него сервер не стартует. Токен доступа Kommo передается как часть Bearer-токена в каждом запросе, а не хранится в переменных окружения сервера, поэтому его нужно передавать из клиента.
Как отключить. Остановите процесс Fastify-сервера и удалите его из конфигурации MCP клиента.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MCP_PASSWORD обязательная, секрет | Обязательный пароль сервера, первая часть составного Bearer-токена. |
| PORT | Порт HTTP-сервера, по умолчанию 3000. |
Проверка безопасности
- Инструменты меняют лиды, добавляют заметки и задачи в реальном аккаунте Kommo
- Составной Bearer-токен несет данные доступа сразу нескольких аккаунтов клиентов
Коротко о README
README на португальском описывает мультитенантный MCP на Fastify с протоколом JSON-RPC 2.0 поверх HTTP, обязательный MCP_PASSWORD, формат составного Bearer-токена, таблицу из семи инструментов с указанием Zod-валидации, время жизни кеша воронок и полей, сценарий использования с n8n и отдельные файлы USAGE.md и APPROVAL-SYSTEM.md.
Частые вопросы
Как сервер понимает, к какому аккаунту Kommo обращаться?
Из поддомена, зашитого во второй части составного Bearer-токена запроса.
Что если под операцию попадает несколько лидов с одинаковым именем?
Сервер запрашивает подтверждение через MCP sampling перед выполнением, детали в APPROVAL-SYSTEM.md.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма