AmoCRM MCP Server
Минимальный MCP-сервер для amoCRM API v4: чтение и создание сделок, контактов и примечаний, OAuth2 и долгосрочный токен
Установка
npm install
npm run buildВыполняется в склонированном репозитории, нужен Node.js 18.17 или новее.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту небольшой набор действий в amoCRM: список сделок и контактов с постраничным выводом, получение контакта по ID, создание сделок и контактов, в том числе пачкой, и добавление примечаний к сделкам, контактам и компаниям. Авторизация работает через долгосрочный токен или OAuth2, обмен кода на токены делается отдельным инструментом, а access token потом обновляется автоматически. Кроме stdio сервер умеет HTTP и Streamable HTTP с защитой Bearer-токеном, в репозитории есть Dockerfile и скрипты деплоя на DigitalOcean.
Для кого. Для разработчиков интеграций и отделов продаж, которые хотят заводить сделки и контакты в amoCRM из агента.
Подходит, если
- Нужно быстро завести сделку и контакт по итогам разговора
- Нужно добавить примечание к сделке без входа в интерфейс
- Нужна основа для своего MCP-сервера amoCRM
Не подходит, если
- Нужны воронки, задачи, поиск и изменение существующих сделок
- Нужен сервер, который ставится одной командой из npm
Пример запроса к агенту
Создай в amoCRM сделку «Поставка оборудования» на 250 000 рублей и добавь к ней примечание с итогами звонкаОграничения
Набор инструментов маленький: нет обновления и удаления сделок, задач и воронок. Пакет не опубликован, сервер собирают из исходников и указывают путь к dist/index.js. Нужна интеграция в amoCRM с client_id и client_secret или долгосрочный токен. Лицензия в репозитории не указана.
Как отключить. Удалите блок amocrm из конфигурации MCP клиента и отключите интеграцию или токен в настройках amoCRM.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| AMO_BASE_URL обязательная | Адрес аккаунта amoCRM |
| AMO_LONG_TERM_TOKEN секрет | Долгосрочный токен amoCRM, рекомендуемый способ |
| AMO_CLIENT_ID | client_id интеграции для OAuth2 |
| AMO_CLIENT_SECRET секрет | client_secret интеграции для OAuth2 |
| MCP_AUTH_TOKEN секрет | Bearer-токен для защиты HTTP-эндпоинтов |
Проверка безопасности
- Создает сделки, контакты и примечания в рабочей CRM
- Хранит токены доступа к аккаунту amoCRM
- HTTP-режим без MCP_AUTH_TOKEN открывает CRM для любого, кто достучится до порта
Коротко о README
README на русском описывает требования, переменные окружения для amoCRM и защиты HTTP, команды запуска для stdio, HTTP и Streamable HTTP. Приведена конфигурация Claude Desktop с путем к собранному файлу и порядок получения токенов через OAuth2. Перечислены семь инструментов с примерами вызовов, способы тестирования через MCP Inspector и отдельные скрипты для проверки API. Остальные файлы в корне подробно разбирают деплой и токены.
Частые вопросы
Какой способ авторизации проще?
Долгосрочный токен amoCRM: его не нужно обменивать и обновлять. OAuth2 подходит, если у вас уже есть своя интеграция.
Как защитить HTTP-режим?
Задайте MCP_AUTH_TOKEN, тогда эндпоинты будут принимать только запросы с этим Bearer-токеном.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
E-Commerce Skills
E-Commerce Skills by Nexscope
Большой набор текстовых скиллов для продавцов Amazon, Shopify, eBay, Etsy, TikTok Shop и Walmart: цены, листинги, реклама, рост
153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки