Bitrix24 MCP Bridge
MCP-мост к Битрикс24 без вебхука и админских прав: браузерное расширение переиспользует уже открытую сессию портала
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Действует от имени залогиненного пользователя через его живую сессию
- Часть инструментов и универсальный bitrix_call выполняют мутирующие операции
- Расширение грузится в режиме разработчика и получает доступ к вкладке портала
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/darwim-bitrix24-mcp-bridgeОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio bitrix24-bridge -- npx -y bitrix24-mcp-bridgeИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"bitrix24-bridge": {
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"bitrix24-bridge": {
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Выполните в терминале
code --add-mcp '{"name":"bitrix24-bridge","type":"stdio","command":"npx","args":["-y","bitrix24-mcp-bridge"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"bitrix24-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add bitrix24-bridge -- npx -y bitrix24-mcp-bridgeИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.bitrix24-bridge]
command = "npx"
args = ["-y", "bitrix24-mcp-bridge"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"bitrix24-bridge": {
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"bitrix24-bridge": {
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"bitrix24-bridge": {
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"bitrix24-bridge": {
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"bitrix24-bridge": {
"type": "local",
"command": [
"npx",
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"bitrix24-bridge": {
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"bitrix24-bridge": {
"command": "npx",
"args": [
"-y",
"bitrix24-mcp-bridge"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Выполни npx -y bitrix24-mcp-bridge setup, чтобы настроить портал и создать расширение, затем загрузи ~/.bitrix24-mcp-bridge/extension/ как распакованное расширение в chrome://extensions с включенным Developer mode, держи вкладку портала открытой и зарегистрируй сервер командой claude mcp add bitrix24-bridge -s user -- npx -y bitrix24-mcp-bridge.
Другие способы из описания автора
npx -y bitrix24-mcp-bridge setupПервый запуск создает токен, config.json и расширение в ~/.bitrix24-mcp-bridge/. После этого загрузите расширение в chrome://extensions вручную.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Вместо официального REST-вебхука мост читает живую сессию пользователя через браузерное расширение: агент по stdio обращается к локальному демону через unix-сокет, демон идет в расширение по WebSocket на 127.0.0.1 с проверкой токена и Origin, а расширение делает запросы к открытой вкладке портала со свежим sessid и cookie. Так агент получает доступ к задачам, проектам и чатам в объеме прав обычного пользователя без создания вебхука и без прав администратора портала. Настройка через npx bitrix24-mcp-bridge setup генерирует общий токен и конфиг, а дальше нужны два ручных шага: загрузить расширение в chrome://extensions и держать открытой залогиненную вкладку портала.
Для кого. Для сотрудников Битрикс24 без прав администратора, которым нужен MCP без создания вебхука на портале.
Подходит, если
- У вас нет прав администратора для создания вебхука или локального приложения
- Достаточно доступа в объеме своей учетной записи, а не общего сервисного токена
- Нужна поддержка нескольких порталов одновременно
Не подходит, если
- Нужен стабильный сервис без открытой вкладки браузера и работающего демона
- Компания запрещает расширения браузера в режиме разработчика
- Нужен официальный REST-вебхук с предсказуемым доступом уровня приложения
Пример запроса к агенту
Покажи мои задачи в Битрикс24 и карточку задачи по спринту и стори-поинтамОграничения
Работает, пока в браузере открыта залогиненная вкладка портала и запущен демон, это не постоянно работающий сервис. Расширение грузится в режиме разработчика вручную, автообновление файлов есть, но перезагрузка расширения в chrome://extensions все равно нужна руками. Bun нужен только мейнтейнерам, конечному пользователю нет. Доступ ограничен правами обычного пользователя портала, а не сервисного вебхука.
Как отключить. Удалите сервер из клиента MCP командой claude mcp remove bitrix24-bridge, остановите демон (pkill -f -- --daemon) и уберите расширение в chrome://extensions.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Проверка безопасности
- Действует от имени залогиненного пользователя через его живую сессию
- Часть инструментов и универсальный bitrix_call выполняют мутирующие операции
- Расширение грузится в режиме разработчика и получает доступ к вкладке портала
Коротко о README
README на русском подробно объясняет архитектуру моста: stdio, unix-сокет, WebSocket с токеном и Origin, живая сессия вкладки. Показаны быстрый старт через npx setup, меню повторной настройки портала, автообновление каталога методов и файлов расширения с одним оставшимся ручным шагом, поддержка нескольких порталов и таблица типизированных инструментов для задач, проектов и чатов с пометкой мутирующих операций.
Частые вопросы
Нужен ли вебхук или права администратора?
Нет, мост работает через живую сессию браузера в объеме прав обычного пользователя портала.
Что если портал не отвечает?
bitrix_status покажет статус подключения; чаще всего нужно переоткрыть вкладку портала или обновить расширение в chrome://extensions.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub