Bitrix24 MCP с подтверждением записи
bitrix24-mcp-server
Самостоятельно размещаемый MCP Битрикс24 с федеративным OAuth 2.1, шифрованием токенов и двухшаговым подтверждением каждой записи
- 0 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- При включенном режиме write_with_confirmation может создавать и менять сущности CRM после подтверждения
- Хранит зашифрованные OAuth-токены пользователей портала в собственной базе PostgreSQL
Похожий инструмент с большим сообществом: Bitrix24 MCP Server, 65 ★ репозитория
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ericvanin-bitrix24-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- При включенном режиме write_with_confirmation может создавать и менять сущности CRM после подтверждения
- Хранит зашифрованные OAuth-токены пользователей портала в собственной базе PostgreSQL
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер размещается самостоятельно (Docker Compose или Coolify) с собственным OAuth-приложением Битрикс24 и базой PostgreSQL. Каждый MCP-клиент проходит отдельную авторизацию OAuth 2.1 с PKCE и динамической регистрацией, токены Битрикс24 шифруются AES-256-GCM и обновляются потокобезопасно. Инструменты чтения обнаруживают схему конкретного портала: типы CRM-сущностей включая смарт-процессы через crm.type.list, поля, воронки, стадии, пользователей и элементы по универсальным методам crm.item.*. Запись сделана намеренно в два шага: инструмент подготовки (создание, обновление, смена стадии) возвращает читаемую человеком сводку и ожидающую операцию, а выполняется только после отдельного вызова подтверждения; операция атомарна и не может выполниться дважды при параллельных запросах, ожидающие операции истекают через десять минут. Каждая запись оставляет аудит-запись со статусом. Сырые REST-вызовы, удаление, администрирование схемы, роботы, бизнес-процессы и привязка событий в этой версии намеренно не открыты.
Для кого. Для команд, которым важна многопользовательская авторизация каждого клиента и жесткий контроль над записью в CRM с подтверждением каждой операции.
Подходит, если
- Несколько человек должны подключаться каждый под своей авторизацией Bitrix24, а не одним общим вебхуком
- Важно, чтобы ни одна запись в CRM не проходила без отдельного подтверждающего вызова
- Нужен аудит-лог всех подготовленных, выполненных, проваленных и отмененных записей
Не подходит, если
- Нет возможности развернуть Docker с PostgreSQL и публичным HTTPS-доменом
- Нужны сырые вызовы REST API, роботы, бизнес-процессы или удаление сущностей: их здесь нет
- Достаточно простого входящего вебхука без OAuth и базы данных
Пример запроса к агенту
Подготовь перенос сделки 4821 на стадию «Оплачено» и покажи сводку перед подтверждениемMCP
- Транспорт
- http
- Авторизация
- OAuth
Переменные окружения
BITRIX_CLIENT_IDобязательная, секрет- ID собственного OAuth-приложения Битрикс24
BITRIX_CLIENT_SECRETобязательная, секрет- Секрет OAuth-приложения Битрикс24
TOKEN_ENCRYPTION_KEYобязательная, секрет- Стабильный ключ шифрования токенов на весь срок жизни базы
MCP_AUTH_TOKENобязательная, секрет- Статический bearer-токен для операторского доступа и восстановления, минимум 32 символа
Ограничения
Это независимый проект, не официальный продукт Битрикс24, автор рекомендует сначала протестировать на непродуктивном портале. Требует Node.js 20.11+, PostgreSQL 14+ и собственное OAuth-приложение Битрикс24 с публичным HTTPS-адресом обработчика. Версия 0.3.1 принимает облачные домены *.bitrix24.* и ровно один настроенный кастомный домен портала, другие коробочные домены пока отклоняются. Реальный доступ всегда ограничен правами того пользователя Битрикс24, который прошел OAuth, и правами самого OAuth-приложения.
Как отключить. Остановите развернутый сервер (docker compose down), удалите OAuth-приложение в портале и отзовите MCP_AUTH_TOKEN.
Частые вопросы
Может ли агент записать данные без подтверждения?
Нет, режим read_only по умолчанию запрещает и подготовку, и выполнение записи; подготовка разрешается только при явном mode=write_with_confirmation, а выполняется запись отдельным вызовом bitrix_confirm_operation.
Что если два запроса попробуют подтвердить одну операцию одновременно?
Подтверждение атомарно, конкурентные запросы не могут выполнить одну и ту же операцию дважды.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыBitrix24 MCP с локальным кешем CRM
bitrix24mcp
MCP-сервер Битрикс24, который держит копию CRM в PostgreSQL или SQLite и отвечает агенту из кеша, а не с каждым запросом к REST
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
Bitrix24 MCP Server (lstkhN)
Bitrix24 MCP Server
Модуль для коробочного Битрикс24: агент безопасно читает CRM, схему MySQL, код и бизнес-процессы по SSH stdio или HTTP с Bearer-токеном
MCP-сервер Битрикс24: задачи, CRM и списки
Bitrix24 Tasks, CRM & Lists MCP Server
Модульный MCP-сервер Битрикс24 на 46 инструментов: задачи и канбан, CRM-сделки и контакты, универсальные списки, работает в Docker без стороннего кеша
MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала
MCP-сервер Битрикс24 с реальными вызовами
MCP Server for Bitrix24
MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Bitrix24 MCP с подтверждением записи (эта карточка) | нет | OAuth | 0 | |
| Bitrix24 MCP от Bit2Beat | нет | API-ключ | 6 | CRM, задачи и диск |
| MCP-сервер Bitrix24 на OAuth-приложении | нет | OAuth | 1 | база знаний |
| MCP-сервер Bitrix24 с расшифровкой звонков | нет | API-ключ | 1 | задачи, CRM и расшифровка звонков |
Коротко о README
README перечисляет включенное (собственное OAuth-приложение, шифрование токенов, read-only инструменты, обнаружение SPA, кеш метаданных схемы, подготовленные операции записи с подтверждением, аудит, стейтлес Streamable HTTP с OAuth 2.1), быстрый старт с переменными окружения, установку локального приложения Битрикс24, подключение клиентов (Claude custom connector, Claude Code, Codex, generic static-bearer), полную таблицу конфигурации, инструкции по Docker и Coolify и архитектурную схему. Ссылки на SECURITY.md перед продакшен-развертыванием.