MCP-сервер и SDK для Kommo CRM

Kommo CRM MCP Server & SDK

Npm-пакет с двойным назначением: MCP-сервер на 40 инструментов для Kommo CRM и типизированный TypeScript SDK для тех же операций в своем коде

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

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

  • Инструменты создают и обновляют лиды, контакты, компании и каталоги в CRM
  • Долгоживущий access token в конфигурации дает полный доступ к аккаунту Kommo
Все причины и проверки

e0duar/kommo-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/kommo-crm-mcp-server-sdk

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'KOMMO_SUBDOMAIN=<значение KOMMO_SUBDOMAIN>' --env 'KOMMO_ACCESS_TOKEN=<ваш KOMMO_ACCESS_TOKEN>' kommo-crm -- npx -y @syncraengine/kommo-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "kommo-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "kommo-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"kommo-crm","type":"stdio","command":"npx","args":["-y","@syncraengine/kommo-mcp"],"env":{"KOMMO_SUBDOMAIN":"<значение KOMMO_SUBDOMAIN>","KOMMO_ACCESS_TOKEN":"<ваш KOMMO_ACCESS_TOKEN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "kommo-crm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add kommo-crm --env 'KOMMO_SUBDOMAIN=<значение KOMMO_SUBDOMAIN>' --env 'KOMMO_ACCESS_TOKEN=<ваш KOMMO_ACCESS_TOKEN>' -- npx -y @syncraengine/kommo-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.kommo-crm]
command = "npx"
args = ["-y", "@syncraengine/kommo-mcp"]
env = { KOMMO_SUBDOMAIN = "<значение KOMMO_SUBDOMAIN>", KOMMO_ACCESS_TOKEN = "<ваш KOMMO_ACCESS_TOKEN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "kommo-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "kommo-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "kommo-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "kommo-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "kommo-crm": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "environment": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "kommo-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "kommo-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@syncraengine/kommo-mcp"
      ],
      "env": {
        "KOMMO_SUBDOMAIN": "<значение KOMMO_SUBDOMAIN>",
        "KOMMO_ACCESS_TOKEN": "<ваш KOMMO_ACCESS_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

KOMMO_SUBDOMAINобязательная
KOMMO_ACCESS_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 9c0a136.

Текст для агента

Добавь в claude_desktop_config.json сервер kommo-crm с command npx, args ["-y", "@syncraengine/kommo-mcp"] и переменными окружения KOMMO_SUBDOMAIN и KOMMO_ACCESS_TOKEN, затем перезапусти Claude Desktop.

Другие способы из описания автора
npm install @syncraengine/kommo-mcp

Установка пакета для использования как SDK в своем коде.

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

Что делает

Пакет @syncraengine/kommo-mcp публикуется в npm и работает двумя способами. Как MCP-сервер он подключается к Claude Desktop или другому клиенту через npx и дает около 40 инструментов: полное управление лидами, контактами, компаниями, задачами и заметками, работу с воронками и этапами, умный поиск пользовательских полей по имени, каталоги и товары с привязкой к лидам. Как библиотека тот же пакет можно импортировать в TypeScript или JavaScript проект и вызывать функции вроде searchContactByPhone или createLead напрямую, без MCP-протокола. Инструменты описаны как семантические, с расчетом на удобство для LLM, а сборка идет и в ESM, и в CommonJS.

Для кого. Для разработчиков, которые хотят и MCP-сервер для агента, и типобезопасный SDK для своего приложения на Kommo из одного и того же пакета.

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

  • Хотите подключить Kommo к Claude Desktop одной строкой через npx
  • Нужен типизированный TypeScript SDK для Kommo API v4 в своем коде, помимо MCP
  • Работаете с каталогами и товарами Kommo и хотите привязывать их к лидам

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

  • Ваша CRM это российская amoCRM, а не международный Kommo
  • Не пользуетесь Node.js и npm-экосистемой

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

Найди контакт по телефону в Kommo и создай для него новую сделку на 500 долларов

Ограничения

Kommo это международный продукт, отдельный от российской amoCRM с 2022 года. Авторизация только через долгоживущий access token, отдельного OAuth-флоу в README нет. Пакет свежий, независимого аудита кода нет, доверие определяется только README и лицензией MIT.

Как отключить. Удалите запись kommo-crm из mcpServers в конфигурации клиента.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
KOMMO_ACCESS_TOKEN
обязательная, секрет
Долгоживущий access token интеграции Kommo
KOMMO_SUBDOMAIN
обязательная
Субдомен аккаунта Kommo, например mycompany для mycompany.kommo.com

Проверка безопасности

  • Инструменты создают и обновляют лиды, контакты, компании и каталоги в CRM
  • Долгоживущий access token в конфигурации дает полный доступ к аккаунту Kommo

Коротко о README

README описывает пакет как решение двойного назначения, перечисляет возможности по CRUD-сущностям, каталогам и умной работе с полями, дает установку npm install @syncraengine/kommo-mcp, конфигурацию для Claude Desktop с переменными окружения, пример кода SDK с поиском контакта по телефону и созданием лида, список инструментов по категориям и шаги сборки и тестирования через MCP Inspector.

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

Можно ли использовать без MCP, просто как библиотеку?

Да, README показывает прямой импорт функций вроде createLead из пакета в свой TypeScript-код.

Какая авторизация нужна?

Долгоживущий access token из настроек интеграции Kommo и субдомен аккаунта.

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483Звезды репозитория
Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий риск28Звезды репозитория
Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий риск
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий риск
Foxx AIMCP-сервер и SDK для Kommo CRM

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