Bitrix24 MCP Server (lstkhN)

Установка

Работает в

• Claude Code
• Cursor
• SourceCraft
• Koda
• Coddy

Сервисы

• Битрикс24

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

composer install --no-dev --prefer-dist --optimize-autoloader

Что делает

Проект ставится на сервер коробочного Битрикс24 как локальный модуль `bitrix24.mcp` в `/local/modules/` и дает агенту доступ только на чтение. Через MCP агент видит лиды, сделки, контакты и компании, активности и записи таймлайна, схему CRM с пользовательскими полями и статусами, а также схему таблиц MySQL из `INFORMATION_SCHEMA`. К проекту относятся еще инструменты разработчика: `code_search` ищет текст или регулярное выражение по файлам, `class_inspector` разбирает PHP-классы через reflection, `components_list` и `event_handlers` показывают компоненты и обработчики событий, `modules_list` перечисляет модули с версиями. `bizproc_reader` читает шаблоны, экземпляры, задачи и историю бизнес-процессов. `sql_query` выполняет только `SELECT` до 200 строк. MCP-ресурсы отдают карту проекта, документацию D7 и стандарты разработки. Есть два транспорта. Stdio через SSH не открывает адрес наружу: клиент запускает `cli/server.php` на сервере. Streamable HTTP работает с Bearer-токеном, сессиями MCP, привязанными к токену, и ограничением по scopes вроде `crm:read`, `tools:list` и `resources:read`. Операций записи в CRM в проекте нет.

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

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

Покажи схему CRM, пользовательские поля сделок и статусы, а потом найди в проекте обработчики событий, связанные с модулем crm.

MCP

Транспорт

stdio, http

Авторизация

API-ключ

Ограничения

Нужны PHP 8.1 или новее, Composer, Bitrix24 Box с D7 и возможность ставить локальные модули. Установка: скопировать репозиторий в `/local/modules/bitrix24.mcp/`, выполнить `composer install --no-dev`, затем поставить модуль в «Установленных решениях». При установке создается случайный Bearer-токен, который не стоит оставлять в Git, тикетах и истории оболочки.

Клиент выполняет запросы с правами PHP и пользователя Bitrix, под которыми работает сервер. Токен подтверждает доступ к адресу, но не заменяет сетевую изоляцию и права ОС. Выдача CRM ограничена 100 записями за вызов, `sql_query` отдает до 200 строк, `file_reader` читает до 1 МиБ.

Скрипт `generate-config.php` печатает секрет в консоль, запускайте его в защищенной среде. Название пакета `bitrix24/mcp` и контактный адрес в composer.json не означают, что проект официальный.

Как отключить. Удалите модуль в «Установленных решениях» или уберите каталог `/local/modules/bitrix24.mcp/`, а точку входа `/local/mcp/index.php` удалите. Токен при этом перестает действовать.

Коротко о README

README объясняет назначение, требования, установку модуля, подключение по SSH stdio и Streamable HTTP, таблицу инструментов с ограничениями, MCP-ресурсы, права и scopes. Проект распространяется по лицензии MIT, пакет Composer `bitrix24/mcp`, идентификатор модуля `bitrix24.mcp`.