amoCRM MCP Server
Простой MCP-сервер для amoCRM на Python: сделки, контакты, компании, задачи, воронки и заметки для Claude Desktop
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает и меняет сделки, контакты и компании в рабочем аккаунте amoCRM
- Токен интеграции дает полный доступ, а не только чтение
Установка
Ручная установка
git clone https://github.com/DocAtWork2026/amocrm-mcp.git
cd amocrm-mcp
pip install -r requirements.txtПосле установки скопируйте .env.example в .env и заполните AMOCRM_DOMAIN и AMOCRM_TOKEN.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту доступ к базовым сущностям amoCRM по долгоживущему токену API. Можно получать список и карточку сделки, создавать и обновлять сделки, читать и создавать контакты и компании, создавать и смотреть задачи, получать список воронок и их стадий, список пользователей аккаунта и общую информацию об аккаунте, а также добавлять и читать заметки на любой сущности. Сервер это один файл server.py, который запускается напрямую командой python с адресом до файла в конфигурации Claude Desktop.
Для кого. Для отделов продаж и небольших команд на amoCRM, которым нужен простой доступ агента к сделкам и контактам без сложной настройки.
Подходит, если
- Нужно быстро создать или обновить сделку из диалога с агентом
- Нужно посмотреть список задач и воронки продаж, не открывая amoCRM
- Нужен маленький сервер без Docker и лишней инфраструктуры
Не подходит, если
- Нужны сложные сущности amoCRM: кастомные поля со сложной логикой, автоматизации, digital pipeline не описаны в README
- Нужно ограничить агента только чтением: токен дает полный доступ уровня интеграции
- Нужен готовый пакет в npm или PyPI: сервер запускается только из клона репозитория
Пример запроса к агенту
Создай сделку «Заявка с сайта, Иванов» в воронке продаж и добавь задачу позвонить завтра в 10:00Ограничения
Нужен Python 3.10+ и долгоживущий токен интеграции amoCRM, который выдается с правами всей интеграции, а не с урезанным набором. Сервер не разбит на модули: вся логика в одном файле server.py. README не описывает пагинацию и обработку ошибок API, если лимиты amoCRM будут исчерпаны.
Как отключить. Удалите блок amocrm из claude_desktop_config.json и отзовите долгоживущий токен в настройках интеграции amoCRM.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| AMOCRM_DOMAIN обязательная | Поддомен аккаунта amoCRM |
| AMOCRM_TOKEN обязательная, секрет | Долгоживущий токен интеграции amoCRM |
Проверка безопасности
- Создает и меняет сделки, контакты и компании в рабочем аккаунте amoCRM
- Токен интеграции дает полный доступ, а не только чтение
Коротко о README
README на английском кратко перечисляет поддерживаемые сущности amoCRM и требования: Python 3.10+ и долгоживущий токен. Показаны установка через git clone и pip, файл .env с доменом и токеном, инструкция по получению токена через amoMarket и готовый блок конфигурации Claude Desktop для macOS и Windows. Таблица инструментов перечисляет все 16 доступных вызовов. Лицензия MIT.
Частые вопросы
Где взять токен amoCRM?
В настройках аккаунта amoCRM в разделе amoMarket создать внешнюю интеграцию, затем во вкладке «Ключи и доступы» сгенерировать долгоживущий токен.
Можно ли ограничить права токена?
README не описывает такой сценарий, токен интеграции дает доступ ко всем сущностям, перечисленным в списке инструментов.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма