SkillFoxx
Telegram

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

Bitrix24 MCP Bridge

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

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

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

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

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

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

Установка

Сервисы

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

npx skillfoxx add mcp/bitrix24-mcp-bridge

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

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

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

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

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

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

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

Что делает

Небольшой 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 на в работе

MCP

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

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

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

Ограничения

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

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

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

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

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

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

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

Обсуждение

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

Битрикс24 — все инструменты

Bitrix24 MCP от Bit2Beat

Bitrix24 MCP Server

Российский стек

MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами

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

MCP-мост к Битрикс24 без вебхука и админских прав: браузерное расширение переиспользует уже открытую сессию портала

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

MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки

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

Битрикс24 для агента через входящий вебхук: сделки, лиды, контакты, задачи и отчеты по воронке с рейтингом менеджеров и зависшими сделками

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

MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию

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

Коротко о README

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

Бейдж для README

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