MCP-сервер для Kommo (amoCRM)
kommo-mcp
Самостоятельно развернутый MCP на чистом Node.js с 41 инструментом для Kommo (amoCRM): сделки, воронки, задачи, очередь диалогов, salesbot
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Токен дает права администратора аккаунта Kommo
- Инструменты создают, обновляют сделки массово и запускают salesbot на сделке
Установка
Ручная установка
git clone https://github.com/RonaldoESantosRevOps/kommo-mcp.git
cd kommo-mcp
npm installУстановка зависимостей перед настройкой токена.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает REST API v4 Kommo, международного бренда amoCRM, в 41 инструмент: аккаунт, воронки, пользователи, кастомные поля, поиск сделок, контактов и компаний, список задач, теги, причины отказа, элементы каталога, аудит событий с переводом этапов и авторов по именам, очередь диалогов в реальном времени, входящие Inbox, создание и обновление сделок с тегами, массовое обновление пачкой, задачи и примечания, контакты и компании, связи, статусы воронок, вебхуки, кастомные поля, элементы каталога, загрузка файлов, запуск salesbot на сделке и универсальный authenticated-passthrough kommo_request с allowlist только на хосты *.kommo.com. Каждый инструмент несет MCP-аннотации readOnlyHint и destructiveHint, так что клиент может разрешать чтение и блокировать запись на уровне протокола.
Для кого. Для отделов продаж на Kommo или amoCRM, которым нужен self-hosted сервер без посредников и с явным разделением чтения и записи.
Подходит, если
- Нужен self-hosted вариант без стороннего облачного прокси, только между своей машиной и API Kommo
- Нужна очередь диалогов в реальном времени и раздел Inbox, а не только карточки сделок
- Важно, чтобы клиент мог технически запретить деструктивные операции по MCP-аннотациям
Не подходит, если
- Нужна установка в один клик без Node.js и без своего долгоживущего токена
- Работаете не в Claude Code: README и примеры сфокусированы на нем, хотя сервер по протоколу MCP универсален
Пример запроса к агенту
Покажи очередь открытых диалогов в Kommo и сделки, которые не двигались больше семи днейОграничения
README на португальском языке. Токен доступа дает права администратора аккаунта Kommo, хранится в .env рядом с сервером. Требуется Node.js 18 или новее и аккаунт с правами администратора для выпуска долгоживущего токена. Инструмент kommo_run_salesbot запускает бота на сделке, README прямо просит подтверждать это действие перед вызовом.
Как отключить. Удалите сервер командой claude mcp remove kommo или уберите его из конфигурации своего MCP-клиента, затем удалите файл .env с токеном.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| KOMMO_SUBDOMAIN обязательная | Поддомен аккаунта Kommo, часть URL перед .kommo.com. |
| KOMMO_TOKEN обязательная, секрет | Долгоживущий токен приватной интеграции с областью crm и правами администратора аккаунта. |
Проверка безопасности
- Токен дает права администратора аккаунта Kommo
- Инструменты создают, обновляют сделки массово и запускают salesbot на сделке
Коротко о README
Португальское README перечисляет 41 инструмент по категориям (чтение, аудит, обслуживание, сделки, задачи и примечания, контакты и компании, воронки, вебхуки, кастомные поля, каталог, автоматизация, универсальный) и формат ответов с сокращенными и сырыми данными. Дает инструкцию получения долгоживущего токена в Kommo, настройку .env, smoke-тест с проверкой количества инструментов и аннотаций, регистрацию в Claude Code с тремя уровнями видимости и раздел устранения неполадок.
Частые вопросы
Работает ли это с российским amoCRM?
Да, Kommo это международный бренд той же платформы, что и amoCRM, сервер использует единый REST API v4.
Можно ли запретить агенту менять данные?
Да, каждый инструмент помечен readOnlyHint или destructiveHint, MCP-клиент может настроить разрешения по этим аннотациям.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма