MCP-сервер Битрикс24 для Open WebUI
Bitrix24 MCP Server
MCP-сервер Битрикс24 на 32 инструмента для компаний, контактов, лидов, сделок и счетов по HTTP c JSON-RPC, разворачивается на Railway
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты удаления компаний, контактов, лидов, сделок и счетов вызываются без подтверждения
- Выставление счетов напрямую влияет на финансовые документы клиента
Установка
Ручная установка
npm install && npm run build && npm startПеред запуском задайте BITRIX_BASE_URL и BITRIX_TOKEN в .env.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер реализует MCP по HTTP с собственным обработчиком JSON-RPC на путях вида /mcp/v1/initialize, /mcp/v1/tools/list и /mcp/v1/tools/call, а не через готовый транспорт SDK. Покрыты пять сущностей CRM по одинаковой схеме из шести операций каждая: список, карточка по id, поиск, создание, изменение, удаление, плюс отдельный инструмент для счетов на добавление товарных позиций и общий инструмент получения схемы полей сущности. В коде зашиты жестко заданные ID пользовательских полей итальянской налоговой системы, вроде НДС-номера и кода PEC, это специфика оригинального заказчика, при работе с российским порталом эти поля просто останутся неиспользуемыми.
Для кого. Для тех, кто использует Open WebUI как MCP-клиента и хочет полный CRUD по компаниям, контактам, лидам, сделкам и счетам Битрикс24.
Подходит, если
- Нужен MCP-сервер с HTTP-транспортом для Open WebUI, а не только для Claude
- Нужен полный набор CRUD-операций по пяти сущностям CRM сразу
- Устраивает разворачивание на Railway
Не подходит, если
- Нужны задачи, проекты или бизнес-процессы: сервер работает только с CRM-сущностями
- Мешают жестко заданные поля итальянской налоговой системы в примерах кода счетов
- Нужно подтверждение перед удалением записи: в коде его нет
Пример запроса к агенту
Найди компанию Acme в Битрикс24 и выставь ей счет на услугу за 1000 евроОграничения
Удаление компаний, контактов, лидов, сделок и счетов выполняется без подтверждения. Пользовательские поля счетов жестко привязаны к итальянской налоговой системе и требуют правки под другую страну. Переменная ALLOWED_ORIGINS по умолчанию открыта на все источники. Автор один, звезд нет, лицензия MIT.
Как отключить. Остановите или удалите развертывание на Railway и уберите сервер из настроек Open WebUI.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| BITRIX_BASE_URL обязательная, секрет | Базовый адрес вебхука без токена, например https://домен.bitrix24.com/rest/USER_ID |
| BITRIX_TOKEN обязательная, секрет | Секретный токен вебхука |
| ALLOWED_ORIGINS | Список разрешенных источников CORS, по умолчанию звездочка, то есть все источники |
Проверка безопасности
- Инструменты удаления компаний, контактов, лидов, сделок и счетов вызываются без подтверждения
- Выставление счетов напрямую влияет на финансовые документы клиента
Коротко о README
README описывает production-ready сервер для Open WebUI с транспортом HTTP и SSE, перечисляет 32 инструмента по шести сущностям таблицами, дает инструкции по установке, сборке и запуску, пример интеграции в Open WebUI, шаги развертывания на Railway через GitHub или CLI и таблицу переменных окружения. Отдельный раздел про пользовательские поля итальянской налоговой системы.
Частые вопросы
Есть ли подтверждение перед удалением записи?
Нет, инструменты bitrix_*_delete выполняются сразу по вызову, без промежуточного подтверждения.
Подойдут ли жестко заданные поля счетов для российского портала?
Нет, они привязаны к итальянской налоговой системе, для другой страны их нужно переопределить в src/tools/invoice.ts.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма