SkillFoxx
Telegram

amoCRM MCP с защитой от опасной записи

Я Мебель — amoCRM MCP

Коннектор к amoCRM API v4 с двухуровневой защитой записи: правки за флагом WRITE_ENABLED, удаление требует отдельного флага и confirm=true

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

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

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

  • При WRITE_ENABLED=true агент может создавать и редактировать сделки, контакты, задачи и файлы
  • При включенном DANGEROUS_WRITE_ENABLED агент может удалять записи, хотя и с явным confirm на каждый вызов
Все причины и проверки
Российский стек

repinsvatoslav7-eng/amocrm-mcpАвтор:repinsvatoslav7-eng

Установка

Работает в
Сервисы

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

uvicorn server:app --host 0.0.0.0 --port $PORT --proxy-headers --forwarded-allow-ips="*"

Стартовая команда, уже прописанная в render.yaml.

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

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

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

  • При WRITE_ENABLED=true агент может создавать и редактировать сделки, контакты, задачи и файлы
  • При включенном DANGEROUS_WRITE_ENABLED агент может удалять записи, хотя и с явным confirm на каждый вызов

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер разворачивается на Render и дает агенту широкий охват amoCRM API v4: диагностику аккаунта, сделки со списком, поиском, карточкой, созданием и пакетными операциями, контакты и компании, задачи, примечания, связи сущностей, дополнительные поля, теги, вебхуки, источники, каталоги, покупателей, неразобранное и файлы с загрузкой через официальный chunked API. Универсальные инструменты amo_api_get, amo_api_post, amo_api_patch и amo_api_delete закрывают редкие эндпоинты API v4, для которых нет отдельной функции. Запись разрешена только при WRITE_ENABLED=true, а удаление и другие разрушительные действия дополнительно требуют DANGEROUS_WRITE_ENABLED=true на сервере и явного confirm=true в конкретном вызове инструмента.

Для кого. Для команд на ChatGPT или другом MCP-клиенте, которые хотят широкий доступ к amoCRM, но с явными предохранителями против случайного удаления или массовой правки.

Подходит, если

  • Нужен широкий охват amoCRM API v4, включая файлы, каталоги и вебхуки, а не только базовые сделки и контакты
  • Важна защита от случайного удаления: два независимых флага плюс confirm на каждый опасный вызов
  • Настраиваете сквозную аналитику и нужно сверять поля вроде metrika_client_id, yclid и UTM-меток в карточках лидов

Не подходит, если

  • Нужна только Kommo, международная версия без .amocrm.ru доменов
  • Не готовы держать переменные окружения на Render и хотите работать без облачного деплоя

Пример запроса к агенту

Через amo_health_check проверь подключение, затем найди дублирующиеся сделки по одному лиду и покажи их метки UTM

MCP

Транспорт
http
Авторизация
API-ключ

Переменные окружения

AMOCRM_BASE_URL обязательная
Адрес аккаунта amoCRM вида https://поддомен.amocrm.ru
AMOCRM_ACCESS_TOKEN обязательная, секрет
Долгосрочный токен приватной интеграции amoCRM
MCP_SECRET обязательная, секрет
Секрет для заголовка Authorization при подключении клиента к /mcp
WRITE_ENABLED
Разрешает обычную запись: создание и редактирование сущностей
DANGEROUS_WRITE_ENABLED
Вместе с confirm=true в вызове разрешает удаление и другие разрушительные операции, по умолчанию false

Ограничения

Развертывание рассчитано на Render, других вариантов деплоя README не описывает. Первоначальная настройка требует одобрения приватной интеграции в amoMarket, что занимает время. Проект изначально сделан для конкретной компании «Я Мебель», но код параметризован через переменные окружения и подходит для любого аккаунта amoCRM.

Как отключить. Отключите коннектор в настройках ChatGPT или MCP-клиента и остановите сервис на Render.

Частые вопросы

Как включить удаление сделок?

Нужны одновременно DANGEROUS_WRITE_ENABLED=true на сервере и параметр confirm=true в самом вызове инструмента, по умолчанию оба отключены.

Работает ли это с Kommo?

README ориентирован на amoCRM с доменом .amocrm.ru, для Kommo нужен другой сервер.

Обсуждение

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

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

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

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

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

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

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

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

MCP-сервер с бизнес-инструментами поверх amoCRM для руководителя отдела продаж: сводка, зависшие сделки, сравнение менеджеров

MCP-серверРасширенный доступ
Российский стек

Небольшой amoCRM MCP-сервер на Node.js с пошаговой русскоязычной инструкцией без терминала: от токена amoCRM до подключения в Claude Code через Render

MCP-серверРасширенный доступ
Российский стек

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

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

Коротко о README

README описывает архитектуру ChatGPT через MCP на Render к amoCRM API v4, перечисляет группы инструментов по сущностям, объясняет двухуровневую защиту записи, дает шаги создания приватной интеграции в amoMarket, переменные окружения для Render, безопасную последовательность первой проверки без записи и отдельный раздел про настройку сквозной аналитики с полями metrika_client_id, yclid и UTM-метками.

Бейдж для README

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