SkillFoxx
Telegram

MCP-сервер для AmoCRM (через REST-прокси)

AmoCRM MCP Server

MCP-сервер stdio с семью инструментами для сделок AmoCRM, который ходит не в API напрямую, а в отдельно развернутый FastAPI-прокси

  • 2 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

Почему такой уровень

  • Создает и удаляет сделки в AmoCRM
  • Хранит client_secret и токены доступа на стороне отдельного бэкенда
Все причины и проверки
Российский стек

garrik24/mcp-amocrm-serverАвтор:Garrik24

Похожий инструмент с большим сообществом: AmoCRM MCP Server, 12 ★ репозитория

Установка

Сервисы

Ручная установка

pip install -r requirements.txt
cp .env.example .env

Установка зависимостей FastAPI-бэкенда и подготовка .env перед запуском.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Создает и удаляет сделки в 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 за последнюю неделю через MCP

MCP

Транспорт
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 на стороне бэкенда.

Обсуждение

Вопросов и отзывов пока нет.

amoCRM — все инструменты
Российский стек

Компактный MCP-сервер на FastMCP с 21 инструментом для AmoCRM: контакты, сделки, задачи, примечания, теги, воронки одним файлом server.py

MCP-серверШирокий доступ
Российский стек

Минимальный MCP-сервер для amoCRM API v4: чтение и создание сделок, контактов и примечаний, OAuth2 и долгосрочный токен

MCP-серверШирокий доступ12
Российский стек

MCP-сервер для API v4 amoCRM (Kommo): сделки, контакты, компании, задачи, воронки, неразобранное и аналитика

MCP-серверШирокий доступ2
Российский стек

MCP-сервер на FastMCP с 39 инструментами по 11 доменам amoCRM: лиды, контакты, аналитика, батч-операции, деплой одним проектом Vercel на аккаунт

MCP-серверШирокий доступ1
Российский стек

MCP-сервер на чистом Node.js с 29 инструментами по amoCRM и универсальным вызовом любого эндпоинта API, запускается npx прямо с GitHub

MCP-серверШирокий доступ
Российский стек

Самостоятельно развернутый MCP на чистом Node.js с 41 инструментом для Kommo (amoCRM): сделки, воронки, задачи, очередь диалогов, salesbot

MCP-серверШирокий доступ1

Коротко о README

README начинается с раздела о критических изменениях безопасности (удалены секреты из кода, добавлена проверка переменных окружения), затем описывает установку зависимостей, .env с параметрами AmoCRM, запуск через uvicorn, эндпоинты авторизации и работы с данными, вебхуки и деплой на Railway с перечнем переменных окружения проекта.

Бейдж для README

Сообщить о проблеме