bitrix24-mcp

bitrix24-mcp

RCS-kzNOASSERTION
bitrix24-mcp — сервер Model Context Protocol, который подключает ИИ-ассистента к облачному Bitrix24. Вы устанавливаете его на своём компьютере, авторизуете через входящий вебхук Bitrix24 или OAuth-приложение, и Claude получает доступ к 45 инструментам для работы с CRM, задачами, мессенджером, календарём и диском. Сервер создан для разработчиков и команд, которые хотят автоматизировать рутину в Bitrix24 через ИИ. Claude выполняет сложные запросы вроде «найди все сделки старше месяца со статусом «Переговоры» и поставь задачу менеджеру на прозвон» — и делает это через REST API от вашего имени. В отличие от типовых демо-интеграций, bitrix24-mcp ориентирован на реальную эксплуатацию: он обрабатывает rate-лимиты, пишет аудит-лог, проверяет типы аргументов и не даёт выполнить опасную операцию без подтверждения пользователя.
Cloud-devopsBitrix
Открыть на GitHubОфициальный сайт

Установка

npx -y @rcs-kz/bitrix24-mcp

Характеристики

Общее

  • СтатусСообщество
  • РазработчикRCS-kz
  • ЛицензияNOASSERTION

Технологии

  • Транспорт
    stdio

Описание

Возможности

  • Управление сущностями CRM: контакты, компании, сделки, лиды, товары — создание, обновление, поиск, удаление
  • Работа с задачами: полное управление жизненным циклом — создание, назначение, смена статуса, добавление комментариев, прикрепление файлов, учёт времени
  • Пользователи и отделы: получение информации о пользователе, список сотрудников по отделам
  • Мессенджер Bitrix24: отправка личных сообщений, работа с чатами, просмотр последних диалогов
  • Календарь: создание и редактирование событий, просмотр занятости, ответ на приглашения
  • Поиск по всем сущностям: кросс-типовой поиск контактов, компаний, сделок, лидов
  • Безопасное выполнение: каждый инструмент проверяет аргументы через Zod-схему до отправки запроса. Деструктивные операции (удаление, массовое обновление) требуют подтверждения пользователя
  • Защита от перегрузок: встроенный rate limiter на уровне клиента, лимиты per-tenant, per-user, per-tool. Массовые операции выстраиваются в очередь
  • Аудит всех действий: каждый вызов REST API записывается в локальный файл ~/.bitrix24-mcp/audit.log с временной меткой, именем инструмента, пользователем, статусом и длительностью
  • Типобезопасность: невалидные аргументы отсекаются на стороне сервера с понятным сообщением об ошибке, не нагружая API

Как подключить

Установите сервер глобально через npx:

npx -y @rcs-kz/bitrix24-mcp

Добавьте конфигурацию в ваш MCP-клиент (пример для Claude Desktop):

{ "mcpServers": { "bitrix24": { "command": "npx", "args": ["-y", "@rcs-kz/bitrix24-mcp"], "env": { "BITRIX24_WEBHOOK": "https://your-domain.bitrix24.ru/rest/1/your-webhook-code/", "BITRIX24_USER_ID": "1" } } } }

Перезапустите Claude Desktop. После запуска следуйте инструкциям в терминале для завершения авторизации.

Подробная документация по настройке доступна после установки на сайте разработчика.

Примеры запросов

  • «Покажи все открытые сделки в работе с суммой больше 500 000 рублей, отсортируй по убыванию суммы и выведи названия клиентов и ответственных менеджеров»
  • «Создай задачу для менеджера Иванова: «Перезвонить клиенту из сделки «Рога и Копыта» и уточнить сроки поставки», прикрепи ссылку на сделку»
  • «Найди контакты в Москве, у которых день рождения на этой неделе, и отправь каждому поздравительное сообщение в личный чат Bitrix24»
  • «Сформируй отчёт по задачам моего отдела за последние 7 дней: сколько закрыто, сколько просрочено, какая средняя длительность выполнения. Результат сохрани в файл и отправь мне сообщением»

Технические детали

  • Язык реализации: TypeScript, Node.js
  • Транспорт: stdio (подходит для любых MCP-клиентов, поддерживающих этот протокол)
  • Лицензия: проприетарная, коммерческий продукт
  • Разработчик: RCS-kz
  • Требования: Node.js 18+, доступ к REST API Bitrix24 (входящий вебхук или OAuth-приложение)
  • Совместимость: Claude Desktop, Cursor и другие MCP-клиенты с поддержкой stdio

Поделиться