MCP-адаптер для 1С-Битрикс
Модуль dimkox.mcp для 1С-Битрикс: сайт отдает агенту инфоблоки и заказы по MCP в границах прав пользователя, запись выключена
- 1 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Модуль дает агенту доступ к рабочему сайту: каталогу, а при включении и к заказам и пользователям с персональными данными
- После включения записи агент создает и правит элементы инфоблоков на живом сайте
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-adapter-dlya-1s-bitriksОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Модуль дает агенту доступ к рабочему сайту: каталогу, а при включении и к заказам и пользователям с персональными данными
- После включения записи агент создает и правит элементы инфоблоков на живом сайте
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Модуль `dimkox.mcp` ставится на сайт 1С-Битрикс как обычное решение из раздела «Установленные решения» Marketplace и превращает функции сайта в «возможности» (abilities). Адаптер отдает их агенту как инструменты, ресурсы и промпты MCP. Идея заимствована у WordPress MCP Adapter, код написан с нуля под Битрикс. Из коробки включены чтение: `main-current-user`, `iblock-list-iblocks`, `iblock-list-sections`, `iblock-search-elements` и `iblock-get-element`, а также ресурс `bitrix://site/info` с доменами и версией ядра. Выключены и включаются администратором: создание и правка элементов инфоблока, поиск пользователей, заказы интернет-магазина и промпт `iblock-describe-element`, который просит написать продающее описание по данным элемента. Агент работает от имени конкретного пользователя по токену вида `bxmcp_...`. Чтение идет с проверкой прав `CHECK_PERMISSIONS`, запись проверяется правами инфоблока. Подключение возможно по HTTP на адрес `/bitrix/tools/dimkox.mcp/index.php` или локально по stdio через `cli/stdio.php`. Другие модули могут добавлять собственные возможности.
Для кого. Разработчикам и администраторам сайтов на 1С-Битрикс, которые хотят дать агенту доступ к каталогу и заказам с тем же разграничением прав, что у сотрудников.
Подходит, если
- Контент-менеджер просит найти в инфоблоке товары по названию и показать их свойства
- По данным элемента каталога надо подготовить продающее описание, а черновик сохранить неактивным для проверки
- Менеджеру магазина нужно посмотреть заказы в статусах, которые ему разрешено видеть
- Агент запущен на сервере сайта, и подключать его к удаленному адресу не хочется, поэтому нужен stdio
- У собственного модуля есть функции, которые стоит отдать агенту через единый реестр возможностей
Не подходит, если
- Сайт работает в облаке Битрикс24: модуль ставится на коробочную 1С-Битрикс с доступом к `/local/modules/`
- Требуется PHP ниже 8.1: модуль использует D7 ORM и современный PHP
- Нужна запись в файловые свойства, инфоблоки с документооборотом или бизнес-процессами: агенту это запрещено
- Вам нужна справка по API ядра, а не доступ к данным сайта: для этого есть индексаторы ядра вроде `bitrix-mcp`
Пример запроса к агенту
Найди в инфоблоке каталога товары со словом «чайник» и покажи свойства первого, ничего не изменяя.MCP
- Транспорт
- http, stdio
- Авторизация
- ключ необязателен
Переменные окружения
BITRIX_MCP_TOKENсекрет- Токен вида bxmcp_..., нужен для локального запуска по stdio.
Ограничения
Нужны PHP 8.1 или новее и модуль `main` с D7 ORM. Модули `iblock` и `sale` не обязательны, но их возможности появляются только при установке модулей. Папку `dimkox.mcp` копируют в `/local/modules/`, затем модуль ставят через административный интерфейс.
Агент меняет только свойства типов строка, число, список и привязки к элементу или разделу. Файловые свойства запрещены, коды свойств из настроек, например закупочная цена, агенту не видны. Для записи нужны отметка возможности и общий переключатель «Разрешить изменять данные».
Токен показывается один раз, в базе остается его SHA-256 хеш. Выдавайте токен отдельному пользователю с минимальными правами, а не администратору.
Как отключить. Отключите MCP-сервер на вкладке «Настройки» модуля, отзовите токены на вкладке «Токены» или удалите модуль из «Установленных решений».
Частые вопросы
Как подключить 1С-Битрикс к Claude Code по MCP?
Установите модуль `dimkox.mcp`, включите сервер, выдайте токен и выполните `claude mcp add --transport http bitrix https://ваш-сайт.ru/bitrix/tools/dimkox.mcp/index.php --header "Authorization: Bearer bxmcp_ВАШ_ТОКЕН"`. Для Cursor пропишите URL и заголовок в `.cursor/mcp.json`.
Что агент увидит сразу после установки?
Ничего. Сервер выключен, а видны только возможности, которые администратор отметил на вкладке «Возможности». Чтение инфоблоков включено по умолчанию, запись, пользователи и заказы выключены.
Может ли агент увидеть неопубликованные товары?
Только если у пользователя токена есть право «просмотр в админке» и выше, как в самом Битриксе. Неактивные и еще не опубликованные элементы иначе скрыты.
Как запустить адаптер локально без открытого адреса?
Используйте stdio: команда `php /var/www/site/local/modules/dimkox.mcp/cli/stdio.php --root=/var/www/site` с переменной `BITRIX_MCP_TOKEN` в окружении. Так работает, например, Claude Desktop на том же сервере.
Как защищен токен и запросы?
В базе хранится хеш токена, токен ограничивают сроком и отзывают в любой момент. Авторизация идет заголовком Bearer без cookies, поэтому CSRF невозможен. Заголовок Origin браузерных клиентов проверяется по доменам из настроек сайтов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
1С-Битрикс — все инструментыМодуль для сайта на 1С-Битрикс, который превращает сайт в MCP-сервер: инфоблоки и профиль пользователя по токену
MCP-модуль для 1С-Битрикс: Управление сайтом
wise108.bsm
Модуль для 1С-Битрикс: Управление сайтом, который поднимает MCP прямо на сервере CMS для работы с инфоблоками из Cursor и Claude Desktop
MCP-сервер каталога 1С-Битрикс, только чтение
MCP-сервер для 1С-Битрикс (только чтение)
Модуль 1С-Битрикс с 35 read-only инструментами MCP: каталог, заказы, отчеты, файлы кода и SQL с раздельными правами по группам
MCP-модуль Delight для 1С-Битрикс
delight.mcp
Модуль 1С-Битрикс с MCP-сервером: агент видит окружение сайта, ищет функции ядра и может выполнять PHP, shell и SQL на сервере
Модуль 1С-Битрикс, который поднимает MCP-сервер внутри проекта: инфоблоки, HL-блоки, роуты, агенты и консольные команды для AI-разработки
Справочник по API вашей установки 1С-Битрикс для агента: индекс ядра с версиями модулей, чтобы он не путал методы разных версий
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP-адаптер для 1С-Битрикс (эта карточка) | нет | ключ необязателен | 1 | |
| Bitrix24 MCP для документации REST API | да | не нужна | 7 | справка по методам REST, а не доступ к данным сайта |
| Bitrix Agent Skill | нет | 22 | скилл с инструкциями по Битриксу, без подключения к живому сайту |
Коротко о README
В README разобраны установка в `/local/modules/`, подключение Claude Code, Cursor и локального stdio, перечень возможностей с отметкой включенных по умолчанию, меры безопасности и добавление собственных возможностей. Лицензия MIT, требуется PHP 8.1.