mcp-bitrix24 (CRest для OpenClaw)

Установка

Работает в

• SourceCraft
• Koda
• Coddy

Сервисы

• Битрикс24

Ручная установка

{"mcpServers":{"bitrix24":{"command":"php","args":["/var/www/html/mcp_server.php"],"env":{"C_REST_WEB_HOOK_URL":"https://your-domain.bitrix24.ru/rest/1/webhook_token/"}}}}

Что делает

Проект на PHP 8.1 и выше сочетает MCP-сервер и приемник вебхуков для связки ИИ-агента OpenClaw с порталом Битрикс24. Он использует официальную библиотеку CRest, которую не меняет. Сервер `mcp_server.php` работает в двух режимах: через STDIO и как HTTP POST с JSON-RPC 2.0. Приемник исходящих вебхуков лежит в `chatWeebhook.php`. Для первого этапа, поддержки клиентов, в сервере пятнадцать строго типизированных инструментов. Чтение CRM идет через `b24_get_leads`, `b24_get_deals`, `b24_get_companies`, `b24_get_contacts` и `b24_get_contracts` для смарт-процесса «Договоры». `b24_get_client_dossier` собирает досье клиента одним пакетным запросом, а `b24_search_crm_by_comm` ищет сущности по телефону или почте. По задачам есть список, карточка с чеклистами, результатами и комментариями. Для чатов предусмотрены `b24_get_chat_history`, `b24_chat_action` с ответом, индикатором набора и переводом на живого оператора и `b24_poll_openlines` для опроса Открытых линий. В CRM агент только читает. Запись идет в чаты и в задачи: `b24_create_task` ставит задачу, `b24_add_task_checklist` добавляет чеклист, а `b24_get_workgroups` помогает выбрать рабочую группу. Задачи ставятся по регламенту компании из шести пунктов. Задел для ПМ-агента отключен флагом `B24_ENABLE_PM_AGENT_TOOLS`.

Для кого. Разработчикам и интеграторам Битрикс24 на PHP, которые строят агента первой линии поддержки на OpenClaw и хотят отдать ему чат и чтение CRM.

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

Собери досье клиента по номеру +7 900 123-45-67, покажи его сделки и открытые задачи и подготовь ответ в Открытой линии.

MCP

Транспорт

stdio, http

Авторизация

API-ключ

Ограничения

Нужны PHP 8.1 или новее и входящий вебхук с правами `crm`, `task`, `tasks_extended`, `im`, `imbot`, `imopenlines`, `user`, `sonet_group` и `disk`. Адрес вебхука задается в `settings.php` или переменной `C_REST_WEB_HOOK_URL`. Приемник исходящих событий проверяет токен приложения `B24_OUTGOING_WEBHOOK_TOKEN`.

Проект написан под конкретную связку с OpenClaw, часть настроек и сообщений в README ориентирована на нее. Развертывание описано для Ubuntu с Nginx и PHP-FPM, опрос Открытых линий вешают на cron. В репозитории нет файла лицензии.

В CRM инструменты первой фазы только читают. Запись в чатах и создание задач выполняются от имени пользователя вебхука, поэтому его права определяют границы действий агента.

Как отключить. Уберите сервер из конфигурации агента, отключите исходящий вебхук в Битрикс24 и удалите входящий. Задание cron для `poll_openlines.php` закомментируйте.

Коротко о README

В README описаны архитектурные правила, структура проекта, права вебхука, настройка `settings.php`, список из пятнадцати инструментов, конфигурация Nginx, подключение к OpenClaw по STDIO и HTTP, опрос Открытых линий и регламент постановки задач с примерами JSON-RPC.