MCP для чтения Битрикс24 напрямую из базы

bitrix_mcp

Read-only MCP-сервер, который читает сделки, контакты и компании Битрикс24 SELECT-запросами к базе, минуя REST API

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Инструмент bitrix_query выполняет произвольный SELECT, включая обращение к чужим таблицам
  • Дает прямой доступ к структуре и данным продуктивной базы CRM
Все причины и проверки
Российский стек

javohir0913/mcp-sap-bitrix

Установка

Сервисы

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

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, это не стандартный входящий вебхук.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер Битрикс24 на TypeScript с широким набором инструментов CRM плюс отдельная группа для мониторинга активности и эффективности менеджеров

MCP-серверРасширенный доступ
Российский стек

MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию

MCP-серверШирокий доступ3Звезды репозитория
Российский стек

MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала

MCP-серверШирокий доступ1Звезды репозитория
Российский стек

MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки

MCP-серверШирокий доступ65Звезды репозитория

Bitrix24 MCP Server (gunnit)

Bitrix24 MCP Server

Российский стек

MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров

MCP-серверШирокий доступ35Звезды репозитория
Российский стек

MCP-сервер Битрикс24, который держит копию CRM в PostgreSQL или SQLite и отвечает агенту из кеша, а не с каждым запросом к REST

MCP-серверШирокий доступ

Коротко о README

README на узбекском описывает read-only MCP-сервер поверх MySQL-базы sitemanager Битрикс24: установка через venv, подключение в Claude Code и Claude Desktop, таблица из десяти инструментов и правила безопасности (только SELECT, санитизация параметров, проверка имен таблиц регулярным выражением, ключ только из переменной окружения, вся диагностика в stderr). Есть примеры формулировок запроса и раздел с типичными ошибками.

Бейдж для README

Сообщить о проблеме