MCP-сервер внутри Битрикс24
mcp-bitrix24 (parfeon/mcp-bitrix24)
Composer-пакет, который поднимает MCP-сервер внутри самого портала Битрикс24 с полным доступом к CRM, задачам и группам
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может необратимо удалять CRM-сущности, задачи, группы и пользовательские поля
- Работает изнутри портала с правами заданного admin_user_id, а не с ограниченными правами вебхука
Установка
Ручная установка
composer require parfeon/mcp-bitrix24Ставится прямо в коробочный портал Битрикс24, далее нужно настроить extra.mcp-bitrix24 в composer.json.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет ставится через Composer прямо в установку коробочного Битрикс24 и запускается как долгоживущий PHP CLI процесс, который общается с MCP-клиентом по stdio. В отличие от серверов на входящем вебхуке, он работает изнутри портала под указанным admin_user_id и загружает нужные модули (crm, tasks, socialnetwork, опционально iblock) прямо из composer.json. Инструменты покрывают CRM (сделки, контакты, любые сущности по entityTypeId, смарт-процессы, пользовательские поля UF_*), задачи, рабочие группы и iblock-элементы, включая создание, изменение и необратимое удаление. Запускать можно нативно, в Docker, через WSL на Windows или удаленно по SSH, любой MCP-клиент со stdio-транспортом подойдет по тому же паттерну.
Для кого. Для разработчиков коробочного Битрикс24, которым нужен более глубокий доступ к CRM и настройке полей, чем дает обычный вебхук.
Подходит, если
- Портал коробочный и сервер можно запускать на той же машине или в том же Docker-окружении
- Нужен доступ к произвольным CRM-сущностям по entityTypeId, а не только к сделкам и контактам
- Нужно администрировать пользовательские поля UF_* и смарт-процессы из агента
Не подходит, если
- Портал облачный (cloud): пакет рассчитан на установку внутри коробочного Битрикс24
- Нужна продуктивная стабильность: автор прямо предупреждает об альфа-статусе и возможных изменениях без анонса
- Нужен просто входящий вебхук без доступа к файлам портала
Пример запроса к агенту
Добавь пользовательское поле «Источник заявки» к сделкам CRM и покажи все смарт-процессы порталаОграничения
Автор прямо помечает проект как альфа-версию, не рекомендованную для продакшена, формат API и конфигурации может измениться без анонса. Требует PHP 8.3+, Composer и доступ к файлам портала из того же окружения, где запущен сервер, PHP CGI/FPM не поддерживается, нужен CLI-процесс. Лицензия Elastic License 2.0 запрещает перепродажу, редистрибуцию и ребрендинг как отдельного продукта.
Как отключить. Удалите пакет composer remove parfeon/mcp-bitrix24 и уберите запись сервера из конфигурации MCP-клиента.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Может необратимо удалять CRM-сущности, задачи, группы и пользовательские поля
- Работает изнутри портала с правами заданного admin_user_id, а не с ограниченными правами вебхука
Коротко о README
README на английском (с русской версией в README_RUS.md) сразу предупреждает об альфа-статусе, описывает работу сервера как долгоживущего PHP CLI процесса на stdio, дает параметры конфигурации composer.json, таблицу из двадцати инструментов по CRM, задачам, группам и iblock с пометкой необратимости удаления, конфигурации для Claude Desktop на Windows, Linux, macOS, Docker и удаленно по SSH и раздел про поддерживаемые среды выполнения. Лицензия Elastic License 2.0 с запретом перепродажи и ребрендинга.
Частые вопросы
Нужен ли входящий вебхук?
Нет, сервер работает изнутри портала под указанным admin_user_id, а не через внешний вебхук.
Что произойдет, если bitrix_root не найден?
Сервер остановится с явной ошибкой и подскажет задать extra.mcp-bitrix24.bitrix_root в composer.json вручную.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма