MCP-сервер Kommo с автообновлением токена
Kommo MCP Server
MCP-сервер для Kommo (amoCRM) с готовым npm-пакетом и автоматическим обновлением токена доступа по refresh-токену
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты создают и меняют сделки, контакты, компании и задачи в реальном аккаунте
- Токены доступа и обновления хранятся в конфигурации MCP клиента
Установка
Ручная установка
npm install -g kommo-mcp-serverРекомендуемый способ из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает Kommo REST API v4 примерно тридцатью инструментами: лиды, контакты, компании, задачи, воронки, пользователи, заметки, дополнительные поля, теги, глобальный поиск и вебхуки. Отдельный инструмент create_lead_complex создает лид сразу вместе с контактом и компанией одним запросом. Если в конфигурации заданы refresh-токен, client id и client secret, сервер сам обновляет истекший токен доступа без ручного вмешательства. При ответе 429 от Kommo сервер ждет и повторяет запрос сам.
Для кого. Для тех, кто хочет ставить Kommo MCP одной командой npx и не следить за истечением токена вручную.
Подходит, если
- Нужна установка одной командой через npx без сборки из исходников
- Токен доступа истекает, и нужно автоматическое обновление по refresh-токену
- Нужно создавать сложные сделки с контактом и компанией одним запросом
Не подходит, если
- Нужна отправка сообщений клиентам через Kommo: README прямо говорит, что сервер этого не делает
- Смущает откровенно рекламный блок README про отдельное сообщество и бесплатный виджет: он не относится к самому MCP
Пример запроса к агенту
Создай сделку Проект для Big Company на 100000 долларов с контактом Джон Смит и компанией Big Company IncОграничения
2 звезды. Часть README посвящена продвижению отдельного сообщества автора в Бразилии и виджета отправки сообщений, эти материалы не относятся к возможностям самого MCP. Рейт-лимиты Kommo обрабатываются автоматическим ожиданием и повтором, но для больших объемов README советует свою пакетную обработку.
Как отключить. Удалите запись kommo из конфигурации MCP клиента, например claude_desktop_config.json.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| KOMMO_SUBDOMAIN обязательная | Поддомен аккаунта Kommo, например mycompany из mycompany.kommo.com. |
| KOMMO_ACCESS_TOKEN обязательная, секрет | Токен доступа приватной интеграции или OAuth2. |
| KOMMO_REFRESH_TOKEN секрет | Refresh-токен для автоматического обновления истекшего access-токена. |
| KOMMO_CLIENT_ID | Client ID интеграции, нужен вместе с refresh-токеном. |
| KOMMO_CLIENT_SECRET секрет | Client Secret интеграции, нужен вместе с refresh-токеном. |
Проверка безопасности
- Инструменты создают и меняют сделки, контакты, компании и задачи в реальном аккаунте
- Токены доступа и обновления хранятся в конфигурации MCP клиента
Коротко о README
README перечисляет управление лидами, контактами, компаниями, задачами, воронками, пользователями, заметками, дополнительными полями, тегами, поиском и вебхуками, дает инструкции по установке из npm и из исходников, конфигурацию Claude Desktop для macOS и Windows и Claude Code CLI, примеры запросов на естественном языке и раздел про рейт-лимиты и обновление токена. Есть промо-блок про отдельное бразильское сообщество Kommo, не относящийся к самому серверу.
Частые вопросы
Что нужно, чтобы токен обновлялся сам?
Задать в конфигурации KOMMO_REFRESH_TOKEN, KOMMO_CLIENT_ID и KOMMO_CLIENT_SECRET вместе с access-токеном.
Сервер умеет отправлять сообщения клиентам?
Нет, README прямо это исключает и отправляет за этим в отдельный продукт автора.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма