MCP-сервер и SDK для Kommo CRM
Kommo CRM MCP Server & SDK
Npm-пакет с двойным назначением: MCP-сервер на 40 инструментов для Kommo CRM и типизированный TypeScript SDK для тех же операций в своем коде
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты создают и обновляют лиды, контакты, компании и каталоги в CRM
- Долгоживущий access token в конфигурации дает полный доступ к аккаунту Kommo
Установка
В терминале, через 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секрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь в 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 из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма