MCP для чтения Битрикс24 напрямую из базы
bitrix_mcp
Read-only MCP-сервер, который читает сделки, контакты и компании Битрикс24 SELECT-запросами к базе, минуя REST API
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инструмент bitrix_query выполняет произвольный SELECT, включая обращение к чужим таблицам
- Дает прямой доступ к структуре и данным продуктивной базы CRM
Установка
- Работает в
- Сервисы
Ручная установка
pip install -r requirements.txtВыполняется внутри папки bitrix_mcp после создания venv.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент bitrix_query выполняет произвольный SELECT, включая обращение к чужим таблицам
- Дает прямой доступ к структуре и данным продуктивной базы CRM
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Вместо обычных REST-методов Битрикс24 сервер шлет проверенные SELECT-запросы к его MySQL-базе через собственный query API и ключ BITRIX_API_KEY. Дает десять инструментов: проверка соединения, список и карточка сделки, поиск по заголовку, список контактов и компаний, статистика сделок по стадиям, список таблиц и структура конкретной таблицы, а также свободный bitrix_query для произвольного SELECT. Каждый параметр очищается от кавычек, точек с запятой и комментариев, а любые операторы записи (INSERT, UPDATE, DELETE, DROP и другие) отклоняются на уровне валидатора. В том же репозитории лежит отдельный аналогичный MCP-сервер для SAP, не связанный с российским стеком.
Для кого. Для разработчиков, которым нужен быстрый read-only доступ к CRM Битрикс24 в обход лимитов и ограничений REST API.
Подходит, если
- Нужна выборка или отчет по сделкам, которую неудобно собирать через REST-методы
- Нужно посмотреть структуру нестандартных таблиц и полей CRM
- Важно гарантированно исключить любую запись со стороны агента
Не подходит, если
- Нет прямого доступа к MySQL-базе портала или собственному query API поверх нее
- Нужно создавать или менять записи в Битрикс24: сервер только читает
- У вас нет отдельного ключа для проверенного query API, только обычный вебхук
Пример запроса к агенту
Покажи сделки на стадии NEW и посчитай статистику по всем стадиямMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
BITRIX_API_KEYобязательная, секрет- Ключ доступа к собственному query API портала Битрикс24
Ограничения
README на узбекском языке. Сервер не работает через стандартный вебхук Битрикс24: нужен собственный query API с ключом BITRIX_API_KEY, который у большинства порталов не настроен. Каждый запрос возвращает не больше 500 строк. Ограничение только на уровне приложения: физического read-only пользователя БД не описано.
Как отключить. Удалите сервер bitrix_mcp из конфигурации MCP клиента и отзовите BITRIX_API_KEY на стороне вашего query API.
Частые вопросы
Может ли сервер изменить данные в Битрикс24?
Нет, валидатор пропускает только SELECT, все операторы записи отклоняются до отправки запроса.
Нужен ли обычный вебхук Битрикс24?
Нет, нужен доступ к отдельному query API портала и ключ BITRIX_API_KEY, это не стандартный входящий вебхук.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыMCP-сервер Битрикс24 с аналитикой продаж
Bitrix24 MCP Server
MCP-сервер Битрикс24 на TypeScript с широким набором инструментов CRM плюс отдельная группа для мониторинга активности и эффективности менеджеров
MCP-сервер Битрикс24 с реальными вызовами
MCP Server for Bitrix24
MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию
MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
Bitrix24 MCP с локальным кешем CRM
bitrix24mcp
MCP-сервер Битрикс24, который держит копию CRM в PostgreSQL или SQLite и отвечает агенту из кеша, а не с каждым запросом к REST
Коротко о README
README на узбекском описывает read-only MCP-сервер поверх MySQL-базы sitemanager Битрикс24: установка через venv, подключение в Claude Code и Claude Desktop, таблица из десяти инструментов и правила безопасности (только SELECT, санитизация параметров, проверка имен таблиц регулярным выражением, ключ только из переменной окружения, вся диагностика в stderr). Есть примеры формулировок запроса и раздел с типичными ошибками.