amoCRM MCP Server
MCP-сервер для API v4 amoCRM (Kommo): сделки, контакты, компании, задачи, воронки, неразобранное и аналитика
Установка
pip install -e .
cp .env.example .env
python -m amocrm_mcpВыполняйте в клоне репозитория. Для SSE: AMO_TRANSPORT=sse AMO_PORT=8000 python -m amocrm_mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на FastMCP дает агенту 36 инструментов для amoCRM. Агент может искать, создавать и обновлять сделки, контакты, компании и задачи, добавлять примечания, связывать сущности и выполнять пакетное создание и обновление. Доступны воронки со статусами, пользователи и кастомные поля аккаунта, события и аналитика по воронкам. Входящие заявки из неразобранного можно принять или отклонить. Сервер сам обновляет OAuth-токен и соблюдает лимит запросов.
Для кого. Отделам продаж и интеграторам, которые работают в amoCRM и хотят поручать рутину агенту.
Подходит, если
- Нужно найти сделку или контакт и обновить статус без захода в интерфейс
- Нужно разобрать входящие заявки из неразобранного
- Нужна сводка по воронке и событиям за период
Не подходит, если
- Нельзя давать агенту право менять рабочие данные CRM
- Нужна готовая установка из пакета: сервер ставится только из исходников
Пример запроса к агенту
Найди в amoCRM сделку с компанией Ромашка, передвинь ее на этап «Договор» и поставь мне задачу позвонить завтраОграничения
Нужны поддомен аккаунта и OAuth-токен интеграции amoCRM, для автообновления еще client id, client secret и refresh token. Пакета в PyPI нет, установка через pip install -e . из клона. Репозиторий опубликован одним коммитом и с тех пор не обновлялся. Удаления сущностей в списке инструментов нет.
Как отключить. Уберите блок amocrm из конфигурации MCP-клиента и отключите интеграцию в настройках amoCRM.
MCP
- Транспорт
- stdio, sse
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| AMO_SUBDOMAIN обязательная | Поддомен аккаунта amoCRM |
| AMO_ACCESS_TOKEN обязательная, секрет | OAuth-токен доступа интеграции |
| AMO_CLIENT_ID | Для автообновления токена |
| AMO_CLIENT_SECRET секрет | Для автообновления токена |
| AMO_REFRESH_TOKEN секрет | Для автообновления токена |
Проверка безопасности
- Создает и массово обновляет сделки, контакты и компании в рабочей CRM
- Принимает и отклоняет входящие заявки
- Хранит OAuth-токены с доступом к базе клиентов
Коротко о README
README кратко описывает 36 инструментов в 11 группах и технические детали: обновление OAuth-токена с сохранением на диск, лимит запросов с повтором при 429 и упрощение ответов HAL+JSON. Установка из исходников, настройка через .env, запуск по stdio или SSE. Приведен пример конфигурации для Claude Desktop и шаги получения ключей в amoCRM. Лицензия MIT.
Частые вопросы
Где взять токен?
В amoCRM в разделе настроек интеграций: создайте интеграцию и скопируйте токен доступа, client id и client secret.
Работает ли с Kommo?
Да, сервер использует API v4, общий для amoCRM и Kommo.
Похожие
Официальный 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 через входящий вебхук: поиск, списки и смена стадии сделки