MCP 服务器

amoCRM MCP

Enables AI agents to interact with amoCRM, providing access to deals, contacts, companies, notes, tasks, and custom fields via natural language.

README

amoCRM MCP

MCP-сервер для amoCRM. Даёт ИИ-агентам (Claude Code, Claude Desktop, Cursor, Cline, Windsurf и любому MCP-клиенту) доступ к вашему аккаунту amoCRM: сделки, контакты, компании, примечания и переписки, задачи, связи между сущностями, теги и кастомные поля — плюс универсальный инструмент для вызова любого эндпоинта API.

Запускается локально по stdio, работает на чистом Node.js.

Возможности

29 инструментов, покрывающих основной REST API v4:

Категория	Инструменты
Аккаунт	`get_account`, `list_pipelines`, `list_users`
Сделки	`list_leads`, `get_lead`, `create_lead`, `update_lead`
Контакты	`list_contacts`, `get_contact`, `create_contact`, `update_contact`
Компании	`list_companies`, `get_company`, `create_company`, `update_company`
Активности	`list_notes`, `add_note`, `add_call_note`, `add_service_message`, `list_events`
Задачи	`create_task`
Связи	`link_entities`, `unlink_entities`, `list_links`
Теги	`list_tags`, `add_tags`
Поля	`list_custom_fields`, `set_custom_field`
Универсальный	`amocrm_request` — любой GET/POST/PATCH/DELETE на любой путь API

Инструмент amocrm_request гарантирует полное покрытие: если готового инструмента под задачу нет, агент всё равно сможет выполнить нужное действие.

Требования

Node.js 18 или новее (в комплекте идёт npx)
Установленный git (нужен для запуска прямо из GitHub)
Аккаунт amoCRM и долгоживущий токен доступа (см. ниже)

Быстрый старт (в одну команду)

Клонировать репозиторий вручную не нужно — npx сам скачает и запустит сервер прямо из GitHub. Достаточно указать эту команду запуска в MCP-клиенте:

npx -y github:ivan000vovanov/amocrm-mcp

Конкретные команды для Claude Code, Claude Desktop и Cursor — ниже.

Установка вручную (по желанию)

Если хотите держать код локально (например, чтобы дорабатывать):

git clone https://github.com/ivan000vovanov/amocrm-mcp.git
cd amocrm-mcp
npm install

Тогда в командах ниже вместо npx -y github:ivan000vovanov/amocrm-mcp используйте node /абсолютный/путь/amocrm-mcp/src/index.js.

Как получить токен amoCRM

Нужен долгоживущий токен приватной интеграции:

Войдите в amoCRM → Настройки → Интеграции.
Нажмите Создать интеграцию → выберите Внешнюю (приватную) интеграцию.
Задайте название и права доступа (нужен доступ к CRM), сохраните.
Откройте созданную интеграцию → вкладка Ключи и доступы.
Выпустите долгосрочный токен (long-lived access token) — скопируйте его.

Ваш AMOCRM_BASE_URL — это адрес аккаунта, например https://example.amocrm.ru.

Токен даёт полный доступ к CRM. Храните его в секрете и никогда не коммитьте в git.

Настройка в клиентах

Во всех примерах подставьте свой адрес аккаунта и токен.

Claude Code

claude mcp add amocrm \
  --env AMOCRM_BASE_URL=https://example.amocrm.ru \
  --env AMOCRM_TOKEN=ваш_токен \
  -- npx -y github:ivan000vovanov/amocrm-mcp

Claude Desktop

Откройте файл конфигурации:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте сервер:

{
  "mcpServers": {
    "amocrm": {
      "command": "npx",
      "args": ["-y", "github:ivan000vovanov/amocrm-mcp"],
      "env": {
        "AMOCRM_BASE_URL": "https://example.amocrm.ru",
        "AMOCRM_TOKEN": "ваш_токен"
      }
    }
  }
}

Перезапустите Claude Desktop.

Cursor

Settings → MCP → Add new MCP server, либо отредактируйте ~/.cursor/mcp.json:

{
  "mcpServers": {
    "amocrm": {
      "command": "npx",
      "args": ["-y", "github:ivan000vovanov/amocrm-mcp"],
      "env": {
        "AMOCRM_BASE_URL": "https://example.amocrm.ru",
        "AMOCRM_TOKEN": "ваш_токен"
      }
    }
  }
}

Cline / Windsurf и другие

Любой MCP-клиент, поддерживающий stdio, настраивается так же: команда npx с аргументами -y github:ivan000vovanov/amocrm-mcp (или node + путь к src/index.js при ручной установке) и переменные окружения AMOCRM_BASE_URL и AMOCRM_TOKEN.

Локальная проверка

Убедитесь, что сервер запускается и отдаёт список инструментов:

AMOCRM_BASE_URL=https://example.amocrm.ru \
AMOCRM_TOKEN=ваш_токен \
node src/index.js

Сервер выведет в stderr stdio server started и будет ждать команды по stdin.

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

«Покажи последние 10 сделок в основной воронке»
«Создай компанию ООО Ромашка с телефоном +7 900 000-00-00 и привяжи к ней новый контакт Иван»
«Добавь примечание к сделке 12345: клиент просил перезвонить завтра»
«Заведи задачу перезвонить по сделке 12345 на завтра в 10:00»
«Найди контакт по имени Пётр и покажи связанные с ним сделки»