bitrix-mcp
Справочник по API вашей установки 1С-Битрикс для агента: индекс ядра с версиями модулей, чтобы он не путал методы разных версий
- 1 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Индексатор читает исходники ядра вашего сайта, а HTTP-режим публикует индекс по сети: закройте его токеном и обратным прокси
- Сборка запускает PHP-разбор большого каталога и занимает заметное время и место на диске
Установка
- Работает в
- Сервисы
Ручная установка
cd indexer && composer install && cd .. && cd server && npm ci && npm run build && cd ..Выполняйте в корне клона. Затем задайте `BITRIX_CORE_ROOT` и запустите `make build`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Индексатор читает исходники ядра вашего сайта, а HTTP-режим публикует индекс по сети: закройте его токеном и обратным прокси
- Сборка запускает PHP-разбор большого каталога и занимает заметное время и место на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект состоит из PHP-индексатора и MCP-сервера на Node.js. Индексатор разбирает файлы вашего ядра `bitrix/` без исполнения кода и записывает классы, методы с сигнатурами, ORM-сущности, события, компоненты и REST-методы в локальный SQLite-индекс. Ядро и готовый индекс в репозиторий не входят, их вы строите сами. Сервер отвечает агенту по stdio или по HTTP с Bearer-авторизацией, всего 23 инструмента. `bitrix_check_method` точно проверяет, есть ли метод у класса с учетом наследования и трейтов, `bitrix_get_class` отдает методы постранично, `bitrix_get_orm_entity` показывает таблицу, поля и связи, `bitrix_find_usages` находит точки вызова. `bitrix_search_docs` ищет по официальной документации на русском, `bitrix_search_code` ищет по коду по описанию задачи на английском. Каждый ответ содержит блок происхождения: версию сборки, идентификатор снимка индекса и версию модуля-владельца. У Битрикса модули версионируются независимо, и на одной установке `crm` и `rest` могут отличаться на целый мажор, поэтому ответ без версии модуля недостоверен. Прежние снимки индекса сохраняются, и сервер можно переключить на нужный.
Для кого. Разработчикам на 1С-Битрикс, которым агент подсказывает несуществующие методы, потому что смешивает версии API разных редакций и модулей.
Подходит, если
- Агент уверенно советует метод класса, а на вашей версии ядра такого метода нет
- Перед доработкой компонента надо увидеть параметры, события и точки вызова нужной функции
- Нужна схема ORM-сущности модуля: таблица, поля, типы и связи, с пометкой неполных данных
- После обновления ядра требуется пересобрать индекс командой `make update` и сравнить версии модулей
- Нужно искать по официальной документации Битрикса с примечаниями «с версии» и их применимостью к вашим модулям
Не подходит, если
- Нужен доступ к данным работающего сайта: заказам, товарам и пользователям. Сервер читает только исходники ядра
- Доступа к файлам ядра нет: индекс строится из каталога `bitrix/` вашей установки
- На машине нет PHP 8.4, Node.js 22 и Composer: сборка индексатора и сервера их требует
- Нужен полный исходный код функции: сервер осознанно отдает сигнатуру, файл и строку, а тело функции не возвращает
Пример запроса к агенту
Проверь через bitrix-mcp, есть ли у класса `Bitrix\Main\Mail\Event` метод `send`, и покажи, в каком модуле он объявлен и какой версии.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
BITRIX_CORE_ROOTобязательная- Абсолютный путь к каталогу bitrix/ вашей установки, нужен для сборки индекса.
BITRIX_MCP_INDEX- Путь к файлу индекса SQLite.
Ограничения
Нужны PHP 8.4 с расширениями PDO и `pdo_sqlite`, Composer 2, Node.js 22, npm и Make. Индексатор запускают с `short_open_tag=1`, иначе он отказывается стартовать: в ядре много файлов с коротким тегом, и без настройки объявления теряются. Цели `Makefile` передают флаг сами.
Параметры компонентов извлекаются неполно. Файлы `.parameters.php` исполняемые, а выполнять их запрещает принцип «только чтение», поэтому вычисляемые значения получают пометку `default_unresolved`. То же с ORM: замыкания в значениях по умолчанию дают `is_complete: false`.
Поиск по документации понимает русский язык, поиск по коду нужен на английском, потому что PHPDoc ядра английский. Лицензия в репозитории не указана.
Как отключить. Удалите сервер из конфигурации клиента, например `claude mcp remove bitrix`. Индекс лежит в файле `index.sqlite` и снимках рядом с ним, его можно удалить вручную. Файлы ядра инструмент не меняет.
Частые вопросы
Зачем агенту индекс ядра Битрикса?
Модули Битрикса версионируются независимо, и метод, который есть в `rest`, может отсутствовать в `crm` на той же установке. Индекс фиксирует версии и отдает ответ с указанием модуля-владельца, поэтому агент не придумывает несуществующий метод.
Как собрать индекс своей установки?
Задайте `BITRIX_CORE_ROOT` как абсолютный путь к каталогу `bitrix/` и `BITRIX_MCP_INDEX` как путь к будущему файлу, затем выполните `make build`. Команда `make docs` дополнительно импортирует официальную документацию, `make update` обновляет индекс после изменений ядра.
Как подключить bitrix-mcp к клиенту?
Добавьте в конфигурацию MCP-клиента сервер `bitrix` с командой `/path/to/bitrix-mcp/bin/bitrix-mcp`, указав путь к своему клону. Лаунчер сам находит `index.sqlite` и собранный сервер.
Можно ли запустить сервер по HTTP?
Да. После сборки выполните `make server-http` или `bin/bitrix-mcp-http`, доступ защищается Bearer-токеном. Есть и сборка Docker-образа командой `docker build -t bitrix-mcp .` для размещения у себя.
На каком языке задавать запросы поиска?
Документацию ищите по-русски через `bitrix_search_docs`, код по-английски через `bitrix_search_code`. При русском запросе к коду инструмент вернет подсказку вместо пустого ответа.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
1С-Битрикс — все инструментыИндексатор кода Bitrix Framework
Bitrix MCP
Локальный MCP-индексатор проекта на 1С-Битрикс без токена: символы, события, ORM, граф зависимостей и опциональный доступ к БД
Публичный удаленный MCP на GitVerse без ключей: ищет функции, классы и события прямо в исходниках 1С-Битрикс и в документации Bitrix Framework
AI-контур разработки для 1С-Битрикс
bitrix-ai-toolkit
Набор правил, скиллов, линтеров и MCP-профиля для AI-разработки на 1С-Битрикс: Управление сайтом, с единым ядром под Claude Code, Codex и Gemini CLI
MCP-сервер каталога 1С-Битрикс, только чтение
MCP-сервер для 1С-Битрикс (только чтение)
Модуль 1С-Битрикс с 35 read-only инструментами MCP: каталог, заказы, отчеты, файлы кода и SQL с раздельными правами по группам
MCP-модуль Delight для 1С-Битрикс
delight.mcp
Модуль 1С-Битрикс с MCP-сервером: агент видит окружение сайта, ищет функции ядра и может выполнять PHP, shell и SQL на сервере
Модуль для сайта на 1С-Битрикс, который превращает сайт в MCP-сервер: инфоблоки и профиль пользователя по токену
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| bitrix-mcp (эта карточка) | нет | не нужна | 1 | |
| Bitrix24 MCP для документации REST API | да | не нужна | 7 | отдает документацию REST, а не индекс ядра вашей версии |
| Bitrix Agent Skill | нет | 22 | скилл с общими инструкциями, без проверки методов по вашей установке |
Коротко о README
Репозиторий рассчитан на самостоятельное развертывание: индексатор, сервер и средства запуска, но без ядра Битрикса. В README перечислены требования, настройка PHP, команды `make`, подключение по stdio и HTTP, список инструментов, ограничения и объяснение, почему у Битрикса нет единой версии.