amocrm-kommo-mcp

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

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

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

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

  • Долгосрочный токен открывает всю CRM: клиентов, телефоны, суммы сделок и задачи сотрудников
  • Записывающие инструменты создают и меняют сделки, примечания и задачи в рабочем аккаунте
Все причины и проверки
Российский стек

penmadebykisss/amocrm-kommo-mcp

Установка

Сервисы

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

claude mcp add amocrm -e AMOCRM_DOMAIN=mycompany.amocrm.ru -e AMOCRM_TOKEN=токен -- npx -y github:penmadebykisss/amocrm-kommo-mcp

Команда из README, домен и токен замените своими.

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

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

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

  • Долгосрочный токен открывает всю CRM: клиентов, телефоны, суммы сделок и задачи сотрудников
  • Записывающие инструменты создают и меняют сделки, примечания и задачи в рабочем аккаунте

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

Что делает

Сервер на Node.js подключает Claude, Cursor и других ассистентов к amoCRM и международной версии Kommo по долгосрочному токену. Инструментов двенадцать с префиксом `crm_`. Читают `crm_account`, `crm_search_leads`, `crm_get_lead`, `crm_find_contact` и `crm_tasks`: поиск сделок по тексту, воронке, этапу, менеджеру и периоду, карточка сделки с телефонами контактов и открытыми задачами, поиск контакта по имени, телефону или почте. Аналитику руководителя дают `crm_pipeline_report` и `crm_stale_leads`. Первый строит отчет по воронке: этапы, выиграно и проиграно, конверсия, средний чек, цикл сделки и рейтинг менеджеров. Второй находит сделки без изменений N дней, без задачи или с просроченной задачей. Записывающих инструментов пять, они помечены в README карандашом: `crm_create_lead`, `crm_update_lead`, `crm_add_note`, `crm_create_task` и `crm_complete_task`. Ассистент показывает, что запишет, и ждет согласия. Сервер соблюдает лимит amoCRM в 7 запросов в секунду и повторяет вызов при ответе 429.

Для кого. Руководителям отделов продаж на amoCRM или Kommo, которые вручную собирают воронку, ищут забытые сделки и просроченные задачи менеджеров.

Подходит, если

  • Итоги сентября: сколько сделок выиграно и у кого из менеджеров лучшая конверсия
  • К планерке собирается список сделок, которые неделю не двигаются, с суммой, застрявшей в них
  • Входящий звонок: клиента находят по номеру и сразу видят его открытые сделки
  • Новую сделку «Сайт для кафе» на 90 000 с контактом Иван заводят фразой и ставят задачу на завтра в 11

Не подходит, если

  • Токен долгосрочный и открывает все данные аккаунта: ограничить его по сущностям нельзя
  • Отчет охватывает больше 10 000 сделок за период: отчет по воронке считает до этого предела
  • Задача выходит за сделки, контакты, компании и задачи, например счета и товары

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

Сколько сделок мы выиграли в сентябре и у кого лучшая конверсия? Покажи также сделки без движения дольше недели.

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

AMOCRM_DOMAIN обязательная
Домен аккаунта, например `mycompany.amocrm.ru`.
AMOCRM_TOKEN обязательная, секрет
Долгосрочный токен внешней интеграции amoCRM.

Ограничения

Нужен Node.js 18 и долгосрочный токен: в amoCRM его создают через «amoМаркет», «Создать интеграцию», «Внешняя интеграция» с доступом ко всем данным, затем вкладка «Ключи и доступы». Домен аккаунта берется из адресной строки, например `mycompany.amocrm.ru` или `mycompany.kommo.com`.

Лимит amoCRM составляет 7 запросов в секунду, сервер выдерживает интервал сам. Отчет по воронке считает до 10 000 сделок за период, параметр `max_leads`. Тесты `npm test` идут на моке API v4, реальный аккаунт не нужен. Облачный доступ с готовым адресом и ключом автор продает по подписке через Telegram.

Как отключить. Удалите сервер командой `claude mcp remove amocrm` и отзовите долгосрочный токен во «Внешней интеграции» amoCRM.

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

Как подключить amocrm-kommo-mcp к Claude Code?

Создайте долгосрочный токен и выполните `claude mcp add amocrm -e AMOCRM_DOMAIN=mycompany.amocrm.ru -e AMOCRM_TOKEN=токен -- npx -y github:penmadebykisss/amocrm-kommo-mcp`.

Работает ли сервер с Kommo?

Да. Домен задается переменной `AMOCRM_DOMAIN`, например `mycompany.kommo.com`, остальные настройки совпадают с amoCRM.

Что показывает отчет по воронке?

Суммы по этапам, выигранные и проигранные сделки, конверсию, средний чек, цикл и рейтинг менеджеров, но не больше 10 000 сделок за период.

Какие инструменты меняют данные?

`crm_create_lead`, `crm_update_lead`, `crm_add_note`, `crm_create_task` и `crm_complete_task`. Ассистент показывает, что запишет, и ждет согласия.

Есть ли облачная версия без установки?

Да, автор выдает адрес и ключ для удаленного MCP по подписке, связаться с ним можно в Telegram. Развертывание такого сервера описано в `docs/cloud.md`.

Обсуждение

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

Российский стек

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

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

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

MCP-серверШирокий доступ16Звезды репозитория
Российский стек

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

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

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

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

MCP-сервер с бизнес-инструментами поверх amoCRM для руководителя отдела продаж: сводка, зависшие сделки, сравнение менеджеров

MCP-серверРасширенный доступ
Российский стек

MCP-сервер на TypeScript с отдельным модулем на каждую сущность AmoCRM: задачи, воронки, лиды, пользователи, примечания, события

MCP-серверРасширенный доступ

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
amocrm-kommo-mcp (эта карточка)нетAPI-ключ0
AmoCRM MCP Serverнетключ необязателен12другой сервер amoCRM без отчетов по воронке и рейтинга менеджеров
amoCRM MCP: запуск без клонирования через npxнетAPI-ключ0сервер amoCRM без поддержки Kommo и аналитики продаж

Коротко о README

README показывает примеры вопросов ассистенту, таблицу из двенадцати инструментов, получение токена, настройку Claude Desktop, Claude Code и Cursor, ограничения, проверку и контакты автора для настройки под ключ.

Бейдж для README

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

Foxx AIamocrm-kommo-mcp
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.