amoCRM MCP

grabarnick/amocrm-mcp-server· Проверено 12.11.2026· 12на GitHub

Подключает агента к amoCRM через API v4: смотреть и создавать сделки, контакты, компании и задачи, оставлять примечания, а во втором варианте ещё считать воронку, прогноз продаж и работу менеджеров.

2 реализации:

Минимальный сервер на Node.js: сделки, контакты и примечания, вход по долгосрочному токену или OAuth2.

Как подключить

Что сделать до подключения

Node.js 18.17 или новее

Склонировать репозиторий, выполнить npm install и npm run build

Интеграция в amoCRM: client_id, client_secret и redirect_uri или долгосрочный токен

AMO_LONG_TERM_TOKEN

amoCRM → amoМаркет → ваша интеграция → вкладка «Ключи» → «Сгенерировать токен», срок от 1 дня до 5 лет; показывается один раз

AMO_BASE_URL

адрес вашего аккаунта, например https://example.amocrm.ru

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'AMO_BASE_URL=https://<ваш-аккаунт>.amocrm.ru' --env 'AMO_LONG_TERM_TOKEN=<долгосрочный токен>' --transport stdio amocrm \
  -- node /path/to/amocrm-mcp-server/dist/index.js

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.amocrm]
command = "node"
args = ["/path/to/amocrm-mcp-server/dist/index.js"]

[mcp_servers.amocrm.env]
AMO_BASE_URL = "https://<ваш-аккаунт>.amocrm.ru"
AMO_LONG_TERM_TOKEN = "<долгосрочный токен>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "amocrm": {
      "command": "node",
      "args": ["/path/to/amocrm-mcp-server/dist/index.js"],
      "env": {
        "AMO_BASE_URL": "https://<ваш-аккаунт>.amocrm.ru",
        "AMO_LONG_TERM_TOKEN": "<долгосрочный токен>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "amocrm": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/amocrm-mcp-server/dist/index.js"],
      "env": {
        "AMO_BASE_URL": "https://<ваш-аккаунт>.amocrm.ru",
        "AMO_LONG_TERM_TOKEN": "<долгосрочный токен>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "amocrm": {
      "command": "node",
      "args": ["/path/to/amocrm-mcp-server/dist/index.js"],
      "env": {
        "AMO_BASE_URL": "https://<ваш-аккаунт>.amocrm.ru",
        "AMO_LONG_TERM_TOKEN": "<долгосрочный токен>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "amocrm": {
      "command": "node",
      "args": ["/path/to/amocrm-mcp-server/dist/index.js"],
      "env": {
        "AMO_BASE_URL": "https://<ваш-аккаунт>.amocrm.ru",
        "AMO_LONG_TERM_TOKEN": "<долгосрочный токен>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "amocrm": {
        "type": "local",
        "command": ["node", "/path/to/amocrm-mcp-server/dist/index.js"],
        "environment": {
          "AMO_BASE_URL": "https://<ваш-аккаунт>.amocrm.ru",
          "AMO_LONG_TERM_TOKEN": "<долгосрочный токен>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "amocrm": {
      "command": "node",
      "args": ["/path/to/amocrm-mcp-server/dist/index.js"],
      "env": {
        "AMO_BASE_URL": "https://<ваш-аккаунт>.amocrm.ru",
        "AMO_LONG_TERM_TOKEN": "<долгосрочный токен>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "amocrm": {
      "command": "node",
      "args": ["/path/to/amocrm-mcp-server/dist/index.js"],
      "env": {
        "AMO_BASE_URL": "https://<ваш-аккаунт>.amocrm.ru",
        "AMO_LONG_TERM_TOKEN": "<долгосрочный токен>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

amocrm.listLeadsпоказывает сделки постранично

amocrm.createLeadсоздаёт сделку или несколько

amocrm.listContactsпоказывает контакты

amocrm.getContactоткрывает контакт по ID

amocrm.createContactсоздаёт контакт

amocrm.createNoteдобавляет примечание

amocrm.exchangeAuthCodeменяет код OAuth на токены

Сервер на Python с выгрузкой данных CRM в PostgreSQL: кроме сделок и задач считает аналитику воронки, прогноз продаж, выручку и эффективность менеджеров.

Как подключить

Что сделать до подключения

Python 3.10 или новее и PostgreSQL 15 или новее

Склонировать репозиторий, поставить зависимости poetry install или pip install -e . в виртуальном окружении

Создать базу командой createdb kommo_mcp

KOMMO_SUBDOMAIN

поддомен аккаунта: для example.amocrm.ru — example

KOMMO_ACCESS_TOKEN

токен доступа к API аккаунта

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'KOMMO_SUBDOMAIN=<поддомен аккаунта>' --env 'KOMMO_ACCESS_TOKEN=<токен доступа>' --env DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp --transport stdio kommomcp \
  -- /path/to/KommoMCP/venv/bin/kommo-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.kommomcp]
command = "/path/to/KommoMCP/venv/bin/kommo-mcp"
args = []

[mcp_servers.kommomcp.env]
KOMMO_SUBDOMAIN = "<поддомен аккаунта>"
KOMMO_ACCESS_TOKEN = "<токен доступа>"
DATABASE_URL = "postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "kommomcp": {
      "command": "/path/to/KommoMCP/venv/bin/kommo-mcp",
      "args": [],
      "env": {
        "KOMMO_SUBDOMAIN": "<поддомен аккаунта>",
        "KOMMO_ACCESS_TOKEN": "<токен доступа>",
        "DATABASE_URL": "postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "kommomcp": {
      "type": "stdio",
      "command": "/path/to/KommoMCP/venv/bin/kommo-mcp",
      "args": [],
      "env": {
        "KOMMO_SUBDOMAIN": "<поддомен аккаунта>",
        "KOMMO_ACCESS_TOKEN": "<токен доступа>",
        "DATABASE_URL": "postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "kommomcp": {
      "command": "/path/to/KommoMCP/venv/bin/kommo-mcp",
      "args": [],
      "env": {
        "KOMMO_SUBDOMAIN": "<поддомен аккаунта>",
        "KOMMO_ACCESS_TOKEN": "<токен доступа>",
        "DATABASE_URL": "postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "kommomcp": {
      "command": "/path/to/KommoMCP/venv/bin/kommo-mcp",
      "args": [],
      "env": {
        "KOMMO_SUBDOMAIN": "<поддомен аккаунта>",
        "KOMMO_ACCESS_TOKEN": "<токен доступа>",
        "DATABASE_URL": "postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "kommomcp": {
        "type": "local",
        "command": ["/path/to/KommoMCP/venv/bin/kommo-mcp"],
        "environment": {
          "KOMMO_SUBDOMAIN": "<поддомен аккаунта>",
          "KOMMO_ACCESS_TOKEN": "<токен доступа>",
          "DATABASE_URL": "postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "kommomcp": {
      "command": "/path/to/KommoMCP/venv/bin/kommo-mcp",
      "args": [],
      "env": {
        "KOMMO_SUBDOMAIN": "<поддомен аккаунта>",
        "KOMMO_ACCESS_TOKEN": "<токен доступа>",
        "DATABASE_URL": "postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "kommomcp": {
      "command": "/path/to/KommoMCP/venv/bin/kommo-mcp",
      "args": [],
      "env": {
        "KOMMO_SUBDOMAIN": "<поддомен аккаунта>",
        "KOMMO_ACCESS_TOKEN": "<токен доступа>",
        "DATABASE_URL": "postgresql+asyncpg://postgres:postgres@localhost:5432/kommo_mcp"
      }
    }
  }
}

Инструменты сервера

kommo_pingпроверяет связь с API

kommo_sync_startвыгружает данные CRM в базу

kommo_sync_statusпоказывает свежесть данных

kommo_pipelines_listпоказывает воронки и этапы

kommo_users_listпоказывает пользователей

kommo_leads_listпоказывает сделки с фильтрами

kommo_lead_getоткрывает сделку

kommo_leads_summaryдаёт краткую сводку по сделкам

kommo_lead_createсоздаёт сделку

kommo_lead_updateменяет сделку

kommo_contacts_listпоказывает контакты

kommo_contact_createсоздаёт контакт

kommo_tasks_listпоказывает задачи

kommo_task_createсоздаёт задачу

kommo_note_createдобавляет примечание

kommo_pipeline_analyticsсчитает конверсию и цикл сделки

kommo_funnel_analysisразбирает воронку по этапам

kommo_sales_forecastстроит прогноз продаж

kommo_manager_performanceоценивает работу менеджеров

kommo_revenue_reportпоказывает выручку по периодам

Показано 20 из 29.

Что попросить агента

«Покажи последние 10 сделок»Агент вызовет amocrm.listLeads или kommo_leads_list

«Создай сделку <название> на <сумма> рублей»Агент вызовет amocrm.createLead или kommo_lead_create

«Покажи аналитику по основной воронке за последний месяц»Агент вызовет kommo_sync_status, при необходимости kommo_sync_start, затем kommo_pipeline_analytics

«Сделай прогноз продаж на 30 дней»Агент вызовет kommo_sales_forecast

«Сравни показатели менеджеров»Агент вызовет kommo_manager_performance

Для каких задач

Показать последние сделки и открыть карточку контакта

Создать сделку с суммой и контакт по итогам разговора

Добавить примечание к сделке, контакту или компании

Поставить задачу и закрыть выполненную

Посчитать конверсию воронки, прогноз продаж и выручку по месяцам

Сравнить менеджеров по выигранным сделкам и выручке

Ограничения

Оба сервера сторонние: amoCRM их не ведёт

AmoCRM MCP Server работает только со сделками, контактами и примечаниями: задач и аналитики в нём нет

Аналитика KommoMCP работает по данным, выгруженным в PostgreSQL: перед отчётами нужен kommo_sync_start

Обычный токен amoCRM живёт 24 часа; долгосрочный действует до 5 лет и обновлять его не нужно

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
AmoCRM MCP Server	grabarnick	12	локально	токен	7	18 декабря 2025
KommoMCP	ampulex-23	8	локально	токен	29	27 февраля 2026

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

Какой токен выбрать?

Проще долгосрочный: его создают в amoМаркете на вкладке «Ключи» интеграции, срок от 1 дня до 5 лет, refresh_token не нужен. Обычный токен по OAuth2 живёт 24 часа, сервер grabarnick сам обновляет его по refresh_token.

Как получить токены через OAuth2 в AmoCRM MCP Server?

Получите authorization code в браузерном входе вашей интеграции и попросите агента вызвать amocrm.exchangeAuthCode с кодом и redirect_uri. Пришедшие access_token и refresh_token сохраните в .env.

Зачем KommoMCP база PostgreSQL?

Сервер выгружает сделки, контакты и задачи из API в локальную базу и считает отчёты по ней: конверсию, прогноз, выручку, активность. Свежесть данных показывает kommo_sync_status.

Можно запустить сервер по HTTP?

AmoCRM MCP Server — да, командами npm run start:http или npm run start:streamable на порту 8080. Задайте MCP_AUTH_TOKEN, иначе эндпоинт открыт без пароля.

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

Оба сервера запускаются на вашем компьютере и обращаются к API аккаунта на amocrm.ru по вашему токену; зарубежные аккаунты не нужны.

amoCRM MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Какую реализацию выбрать

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

Похожие серверы