MCP-сервер для amoCRM на FastMCP
amoCRM MCP Server
MCP-сервер на FastMCP с 39 инструментами по 11 доменам amoCRM: лиды, контакты, аналитика, батч-операции, деплой одним проектом Vercel на аккаунт
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает и обновляет лиды, контакты и компании
- Хранит OAuth client_secret и refresh_token при автообновлении
Установка
Ручная установка
pip install -e .
cp .env.example .envУстановка сервера из исходников перед заполнением .env.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер построен на библиотеке FastMCP и покрывает API v4 amoCRM 39 инструментами по 11 доменам: лиды, контакты, компании, задачи, примечания, воронки, связи, аккаунт, батч-операции, неразобранное и аналитика. Токен обновляется автоматически с сохранением на диск, есть режим долгоживущего токена для простых одноаккаунтных развертываний, ограничение по частоте запросов 7 в секунду с бэкоффом при 429, нормализация HAL и JSON, единый формат ответа с данными или ошибкой. Поддерживает транспорты stdio, SSE и streamable-http. README описывает продуктивную схему: один проект Vercel на один аккаунт amoCRM, с переменными окружения в настройках проекта.
Для кого. Для разработчиков, которым нужен полнофункциональный MCP-сервер amoCRM с готовым деплоем на Vercel и поддержкой нескольких транспортов.
Подходит, если
- Нужны сразу лиды, контакты, компании, задачи, аналитика и батч-операции в одном сервере
- Нужен деплой как удаленный HTTP-сервис на Vercel, а не только локальный stdio
- Нужен встроенный rate limit и автоматическое обновление OAuth-токена
Не подходит, если
- Нужен один аккаунт amoCRM на несколько клиентов сразу: продуктивная схема README рассчитана один проект Vercel на один аккаунт
- Не хотите заводить отдельный деплой на Vercel и предпочитаете чисто локальный сервер
Пример запроса к агенту
Собери аналитику по сделкам в моей воронке amoCRM за этот месяцОграничения
Для продуктивного режима README явно описывает схему один проект Vercel на один аккаунт amoCRM, для нескольких аккаунтов нужно разворачивать несколько проектов. Здоровье сервиса проверяется отдельным эндпоинтом /healthz, который нужно мониторить самостоятельно. Требуется собственная OAuth-интеграция amoCRM с client_id, client_secret и refresh_token либо долгоживущий токен.
Как отключить. Удалите сервер amocrm из конфигурации MCP-клиента и остановите или удалите проект на Vercel, если использовали облачный деплой.
MCP
- Транспорт
- stdio, sse, http
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| AMO_SUBDOMAIN обязательная | Поддомен аккаунта amoCRM. |
| AMO_ACCESS_TOKEN обязательная, секрет | Долгоживущий токен доступа для простого одноаккаунтного режима. |
| AMO_CLIENT_ID секрет | ID интеграции для автоматического обновления токена вместе с CLIENT_SECRET и REFRESH_TOKEN. |
Проверка безопасности
- Создает и обновляет лиды, контакты и компании
- Хранит OAuth client_secret и refresh_token при автообновлении
Коротко о README
README перечисляет 39 инструментов по 11 доменам, особенности вроде rate limiting, нормализации HAL и трех транспортов, дает установку pip install -e ., настройку .env с минимальным и полным набором переменных, три способа запуска по транспортам, конфигурацию Claude Desktop и раздел о деплое на Vercel с переменными окружения проекта и эндпоинтами /mcp и /healthz.
Частые вопросы
Можно ли обслуживать несколько аккаунтов amoCRM одним сервером?
README описывает продуктивную схему один проект Vercel на один аккаунт, для нескольких аккаунтов нужно несколько развертываний.
Какие транспорты поддерживаются?
stdio для локального запуска, а также SSE и streamable-http с переменными AMO_TRANSPORT и AMO_PORT для сетевого доступа.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма