MCP-сервер для AmoCRM (через REST-прокси)
AmoCRM MCP Server
MCP-сервер stdio с семью инструментами для сделок AmoCRM, который ходит не в API напрямую, а в отдельно развернутый FastAPI-прокси
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает и удаляет сделки в AmoCRM
- Хранит client_secret и токены доступа на стороне отдельного бэкенда
Установка
Ручная установка
pip install -r requirements.txt
cp .env.example .envУстановка зависимостей FastAPI-бэкенда и подготовка .env перед запуском.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Создает и удаляет сделки в AmoCRM
- Хранит client_secret и токены доступа на стороне отдельного бэкенда
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект состоит из двух частей. app.py поднимает FastAPI-сервер, который берет на себя OAuth-авторизацию AmoCRM, обмен кода на токены, их обновление и универсальный эндпоинт для сущностей CRM, а также прием вебхуков. mcp_server.py это отдельный MCP-сервер по stdio на официальной библиотеке mcp, который не обращается в AmoCRM напрямую, а вызывает эндпоинты уже запущенного FastAPI-прокси по адресу из переменной AMOCRM_SERVER_URL. Агенту доступны семь инструментов: статус подключения, список сделок, создание простой и полной сделки, удаление сделки, сделки по диапазону дат и универсальный запрос amocrm_request к любому эндпоинту прокси.
Для кого. Для тех, кто готов развернуть отдельный REST-бэкенд для AmoCRM на Railway или Heroku и подключить к нему MCP-сервер по stdio.
Подходит, если
- Нужен отдельный REST-слой над AmoCRM с вебхуками и общим эндпоинтом сущностей, а не только MCP
- Устраивает архитектура с двумя частями: свой бэкенд плюс легкий MCP-клиент к нему
- Нужны базовые операции по сделкам: список, создание, удаление, выборка по датам
Не подходит, если
- Нужен MCP-сервер, который сам напрямую ходит в API AmoCRM без отдельного бэкенда: здесь обязателен запущенный FastAPI-прокси
- Нужны контакты, компании, задачи или примечания: инструменты MCP-сервера покрывают только сделки
- Важна аккуратная документация: README содержит противоречивые разделы про безопасность и повторяющиеся инструкции
Пример запроса к агенту
Покажи мои сделки в AmoCRM за последнюю неделю через MCPMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
AMOCRM_SERVER_URLобязательная- Адрес развернутого FastAPI-бэкенда, который MCP-сервер вызывает по HTTP.
AMOCRM_CLIENT_IDобязательная, секрет- ID интеграции AmoCRM для бэкенда app.py.
AMOCRM_CLIENT_SECRETобязательная, секрет- Секретный ключ интеграции AmoCRM для бэкенда app.py.
Ограничения
MCP-сервер сам по себе бесполезен без отдельно запущенного и доступного по сети FastAPI-прокси app.py, у которого свои переменные окружения AMOCRM_CLIENT_ID, AMOCRM_CLIENT_SECRET, AMOCRM_SUBDOMAIN и REDIRECT_URI. Набор MCP-инструментов ограничен сделками, полноценного покрытия контактов и компаний нет. README содержит следы правок безопасности (удаление секретов из кода) и несколько частично дублирующих друг друга гайдов по деплою.
Как отключить. Удалите сервер amocrm из конфигурации MCP-клиента и остановите или удалите развернутый FastAPI-бэкенд на Railway, Heroku или Vercel.
Частые вопросы
Можно ли обойтись без отдельного бэкенда?
Нет, mcp_server.py вызывает HTTP-эндпоинты app.py по AMOCRM_SERVER_URL, без запущенного бэкенда инструменты работать не будут.
Какие сущности AmoCRM доступны?
Именованные инструменты покрывают только сделки, для прочих сущностей есть универсальный POST /api/entities на стороне бэкенда.
Похожие
MCP-серверыОфициальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма
Коротко о README
README начинается с раздела о критических изменениях безопасности (удалены секреты из кода, добавлена проверка переменных окружения), затем описывает установку зависимостей, .env с параметрами AmoCRM, запуск через uvicorn, эндпоинты авторизации и работы с данными, вебхуки и деплой на Railway с перечнем переменных окружения проекта.