Bitrix24 MCP с двумя контурами доступа
bitrix24-mcp
MCP-сервер для Битрикс24 с раздельными эндпоинтами: полный админский доступ и урезанный контур для сотрудников через guard.cjs
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Админский эндпоинт вызывает любой метод Битрикс24 без ограничений
- Универсальный bitrix_call дает прямой доступ к REST API
- Секреты передаются в заголовке или адресе без ротации
Похожий инструмент с большим сообществом: Bitrix24 MCP Server, 65 ★ репозитория
Установка
- Работает в
- Сервисы
Ручная установка
npm install && node index.jsПеред запуском задайте переменные BITRIX_WEBHOOK_URL, BITRIX_ADMIN_WEBHOOK_URL и MCP_SHARED_SECRET в окружении.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Админский эндпоинт вызывает любой метод Битрикс24 без ограничений
- Универсальный bitrix_call дает прямой доступ к REST API
- Секреты передаются в заголовке или адресе без ротации
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на express и официальном SDK Model Context Protocol поднимает два эндпоинта поверх одного набора инструментов. /mcp работает с личным админским вебхуком и вызывает Битрикс24 напрямую, /mcp-staff идет через отдельный вебхук и проходит проверку в guard.cjs, который разрешает или отклоняет метод по политике. Инструменты покрывают сделки CRM (список, карточка, создание) и универсальный bitrix_call для любого метода REST API, а сотрудникам сервер объясняет в описании инструмента, что делать разрешено, а не обещает безграничный доступ. Секрет передается заголовком X-MCP-Secret или параметром key, потому что коннектор Claude не всегда умеет слать произвольные заголовки.
Для кого. Для владельца портала Битрикс24, который хочет дать себе полный доступ через MCP, а сотрудникам только ограниченный набор операций.
Подходит, если
- Нужно разделить доступ агента: полный для себя, урезанный для команды
- Нужен универсальный вызов bitrix_call для методов, которых нет среди готовых инструментов
- Коннектор агента не умеет слать кастомные заголовки, нужна авторизация параметром в адресе
Не подходит, если
- Нужна подробная документация: в репозитории нет README, поведение видно только по коду
- Нужен готовый список инструментов CRM без ручного развертывания своего сервера
- Важна проверенная политика guard.cjs с описанием, какие методы она реально разрешает
Пример запроса к агенту
Покажи список открытых сделок и создай новую по контакту ИвановMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
BITRIX_WEBHOOK_URLобязательная, секрет- Вебхук для контура сотрудников, используется через guard.cjs
BITRIX_ADMIN_WEBHOOK_URLобязательная, секрет- Личный админский вебхук с полными правами для /mcp
MCP_SHARED_SECRETобязательная, секрет- Секрет для авторизации личного эндпоинта /mcp
MCP_STAFF_SHARED_SECRETсекрет- Отдельный секрет для эндпоинта /mcp-staff
Ограничения
В репозитории нет README: описание составлено по чтению index.js, guard.cjs и public/index.html. Нет лицензии и тестов, автор один, звезд нет. Политика guard.cjs для сотрудников не задокументирована отдельно, ее нужно читать в коде перед использованием на реальных сотрудниках.
Как отключить. Остановите сервис и удалите блок сервера из конфигурации MCP клиента.
Частые вопросы
Чем /mcp отличается от /mcp-staff?
/mcp вызывает Битрикс24 напрямую полным админским вебхуком, /mcp-staff проходит через guard.cjs, который проверяет метод по политике перед вызовом.
Как передать секрет, если коннектор не шлет заголовки?
Добавить его параметром ?key=<секрет> в адрес эндпоинта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыBitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
Bitrix24 MCP Server (qwito)
Bitrix24 MCP Server
MCP-сервер на TypeScript с более чем 45 инструментами для CRM Битрикс24: контакты, сделки, лиды, компании, задачи и аналитика активности
MCP-сервер Битрикс24 с реальными вызовами
MCP Server for Bitrix24
MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
Bitrix24 MCP Server (lstkhN)
Bitrix24 MCP Server
Модуль для коробочного Битрикс24: агент безопасно читает CRM, схему MySQL, код и бизнес-процессы по SSH stdio или HTTP с Bearer-токеном
MCP-сервер Битрикс24 с OAuth на сотрудника
bitrix-mcp-server
Общий MCP-сервер Битрикс24 для всей компании: каждый сотрудник входит через свой OAuth, и все действия агента отмечены его собственным пользователем
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Bitrix24 MCP с двумя контурами доступа (эта карточка) | нет | API-ключ | 0 | |
| MCP-сервер Битрикс24 с аналитикой продаж | нет | не нужна | 0 | на TypeScript, с аналитикой менеджеров |
| MCP-сервер Битрикс24 для Open WebUI | нет | не нужна | 0 | 32 инструмента по HTTP, для Open WebUI |
| MCP-сервер Битрикс24 на Go | нет | не нужна | 0 | один бинарник |
Коротко о README
Отдельного README нет. По коду index.js видно два эндпоинта с разной моделью доступа, комментарии на русском объясняют назначение каждой переменной окружения и оба способа передачи секрета. package.json описывает проект как MCP-сервер, связывающий Claude с Битрикс24 через вебхук с двусторонним доступом.