SkillFoxx

Начните вводить название, задачу или сервис

Мост Claude в Bitrix24 CRM через вебхук

Bitrix24 MCP Bridge

Самодельный мост между кастомным коннектором Claude и Bitrix24 CRM/задачами, написанный из-за нерабочего нативного OAuth-коннектора Б24 в маркетплейсе

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

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

  • Может создавать и обновлять записи CRM и задачи от имени владельца вебхука
  • Секрет доступа зашит в URL: у кого есть ссылка, у того есть доступ к CRM
Все причины и проверки
Российский стек

karpovpartnerscom/bitrix24-mcp-bridge-claudeАвтор:KarpovPartnersCom

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/bitrix24-mcp-bridge

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport http 'Bitrix24 MCP Bridge' 'https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>'

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "Bitrix24 MCP Bridge": {
      "type": "http",
      "url": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "Bitrix24 MCP Bridge": {
      "url": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"Bitrix24 MCP Bridge","type":"http","url":"https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "Bitrix24 MCP Bridge": {
      "type": "http",
      "url": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add 'Bitrix24 MCP Bridge' --url 'https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>'

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers."Bitrix24 MCP Bridge"]
url = "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"

Если файл уже есть, допишите блок в конец.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -t http 'Bitrix24 MCP Bridge' 'https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>'

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "Bitrix24 MCP Bridge": {
      "httpUrl": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "Bitrix24 MCP Bridge": {
      "serverUrl": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "Bitrix24 MCP Bridge": {
      "type": "streamableHttp",
      "url": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "Bitrix24 MCP Bridge": {
      "type": "streamable-http",
      "url": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "Bitrix24 MCP Bridge": {
      "type": "remote",
      "url": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "Bitrix24 MCP Bridge": {
      "url": "https://mcp-bitrix.karpovpartners-it.ru/mcp/<ваш MCP_PATH_SECRET>"
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

MCP_PATH_SECRETсекрет, обязательная
секрет в пути URL для доступа к MCP-коннектору
BITRIX_WEBHOOK_URLсекрет, обязательная
URL входящего вебхука Bitrix24 с правами CRM+Задачи

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Сверено с репозиторием 26 сент. 2026, коммит 825224d.

Текст для агента

Создай входящий вебхук Bitrix24 с правами CRM и задачи, разверни server.mjs и app.js на своем хостинге с зависимостями @modelcontextprotocol/sdk, express, zod и undici, впиши секрет и адрес вебхука в .htaccess, затем добавь кастомный коннектор в Claude по адресу /mcp/<секрет>.

Другие способы из описания автора
npm install

Ставит express, zod, @modelcontextprotocol/sdk и undici в директории сайта на хостинге.

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

Что делает

Небольшой Express-сервер транслирует запросы MCP от Claude в обычный REST API Bitrix24 через входящий вебхук с правами только на CRM и задачи. Дает шесть инструментов: универсальный вызов bitrix24_call с префиксами crm., task., tasks., user.current, profile, и отдельные инструменты для списка, чтения, создания и обновления записей CRM и задач. Сервер сам ограничивает вызываемые методы белым списком префиксов на случай расширения прав вебхука в будущем. Автор пришел к этому решению после того, как штатный коннектор «Б24» в маркетплейсе Bitrix24 оказался сломан: OAuth-эндпоинты отдают голый 404 при включенной подписке.

Для кого. Для тех, у кого не заработал официальный коннектор Bitrix24 в маркетплейсе Claude и нужен рабочий обходной путь через свой вебхук.

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

  • Официальный коннектор Bitrix24 в Claude выдает 404 на OAuth-эндпоинтах, хотя подписка активна
  • Нужен простой мост к CRM и задачам без разбора полного REST API вручную
  • Есть свой хостинг (например, Beget), куда можно развернуть небольшой Node-сервер

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

  • Официальный нативный коннектор Bitrix24 уже работает у вас: он даст больше контроля через OAuth
  • Нет своего хостинга для деплоя моста

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

Покажи мои открытые сделки в CRM и обнови статус сделки 42 на в работе

Ограничения

Это личный проект автора, разворачивался и проверялся на одном конкретном хостинге Beget со старым Node.js 16.20.2, из-за чего в код добавлены полифилы под современные зависимости. Секрет авторизации зашит прямо в путь URL, а не в заголовок, потому что интерфейс кастомных коннекторов Claude не дает поле для произвольных заголовков. Реальный .htaccess с секретами не публикуется, только пример.

Как отключить. Отключите коннектор в настройках Claude и остановите или удалите деплой на сервере, деактивировав вебхук в Bitrix24.

MCP

Транспорт
http
Авторизация
API-ключ
Переменные окружения
BITRIX_WEBHOOK_URL
обязательная, секрет		Входящий вебхук Bitrix24 с правами CRM и задачи
MCP_PATH_SECRET
обязательная, секрет		Секрет в пути URL, заменяет заголовок авторизации, которого нет в кастомных коннекторах Claude

Проверка безопасности

  • Может создавать и обновлять записи CRM и задачи от имени владельца вебхука
  • Секрет доступа зашит в URL: у кого есть ссылка, у того есть доступ к CRM

Коротко о README

README подробно разбирает архитектуру моста, схему аутентификации через секрет в URL, пошаговое развертывание на Beget с журналом отладки (старый Node.js, привязка домена, ESM против CommonJS в Passenger), подключение в Claude и открытый вопрос о починке нативного коннектора Bitrix24.

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

Почему не использовать штатный коннектор Bitrix24?

У автора он не заработал: эндпоинты /authorize и OAuth-discovery отдают 404, это баг на стороне Bitrix24, а не ошибка настройки.

Нужен ли современный Node.js?

Нет, README описывает, как завести сервер даже на Node 16.20.2 через полифилы fetch, crypto и потоков.

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483
Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий рискРоссийский стекБез VPN28
Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий рискРоссийский стекБез VPN
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий рискРоссийский стекБез VPN
Foxx AIМост Claude в Bitrix24 CRM через вебхук

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.