amoCRM·grabarnick

amoCRM MCP — подключение и инструкция

amoCRM MCP подключает агента к API v4 amoCRM для работы со сделками, контактами и заметками.

Рабочие сервисыЛокальноАвторизация

Что умеет этот сервер

01

amoCRM MCP подключает агента к API v4 amoCRM для работы со сделками, контактами и заметками.

02

Проект поддерживает OAuth2 и описывает долгосрочный токен как отдельный вариант.

03

Прочитай известную тестовую сделку и контакт.

Задача для знакомства

Через amoCRM MCP прочитай тестовую сделку и контакт. Заметки, стадии и реквизиты не меняй.

Уточнить результат

Сверь аккаунт, IDs, воронку и stage. При истёкшем доступе проверь refresh-flow либо выбранный long-term token; не меняй transport и права наугад.

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

Выберите подходящий способ

Подключить amoCRM MCP

Скачай репозиторий, установи npm-зависимости и выполни build по README. Создай .env с AMO-параметрами, пройди нужный auth-flow. В клиенте укажи собственный абсолютный путь dist/index.js вместо пути компьютера автора.

Что понадобится

  • Node.js 18.17+, аккаунт amoCRM и данные интеграции. Нужны точный AMO_BASE_URL и выбранный способ получения токенов.
  1. 01

    Подготовь окружение

    Node.js 18.17+, аккаунт amoCRM и данные интеграции. Нужны точный AMO_BASE_URL и выбранный способ получения токенов.

  2. 02

    Установи и настрой

    Скачай репозиторий, установи npm-зависимости и выполни build по README. Создай .env с AMO-параметрами, пройди нужный auth-flow. В клиенте укажи собственный абсолютный путь dist/index.js вместо пути компьютера автора.

  3. 03

    Открой новую сессию

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

Первый запрос — пример для чата агента

Через amoCRM MCP прочитай тестовую сделку и контакт. Заметки, стадии и реквизиты не меняй.

Как проверить

Сверь аккаунт, IDs, воронку и stage. При истёкшем доступе проверь refresh-flow либо выбранный long-term token; не меняй transport и права наугад.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет amoCRM

amoCRM MCP подключает агента к API v4 amoCRM для работы со сделками, контактами и заметками.

Проект поддерживает OAuth2 и описывает долгосрочный токен как отдельный вариант. Local stdio и HTTP transports требуют разной защиты: MCP_AUTH_TOKEN нужен для защищённого HTTP-доступа, но не заменяет amoCRM token.

Что подготовить перед подключением

Node.js 18.17+, аккаунт amoCRM и данные интеграции. Нужны точный AMO_BASE_URL и выбранный способ получения токенов.

Как установить и подключить

Скачай репозиторий, установи npm-зависимости и выполни build по README. Создай .env с AMO-параметрами, пройди нужный auth-flow. В клиенте укажи собственный абсолютный путь dist/index.js вместо пути компьютера автора.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай известную тестовую сделку и контакт. Подготовь заметку черновиком с точным lead ID и контекстом; запись выполняй отдельным осмысленным действием.

Как проверить результат и решить проблемы

Сверь аккаунт, IDs, воронку и stage. При истёкшем доступе проверь refresh-flow либо выбранный long-term token; не меняй transport и права наугад.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Токены и scopes определяют доступ к реальной CRM. HTTP endpoint без отдельной защиты может открыть данные; это не устраняется одной настройкой URL аккаунта.

Исходники и документация

Репозиторий: grabarnick/amocrm-mcp-server. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о amoCRM

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