SkillFoxx
Telegram

BitrixMCP: детерминированный сервер Битрикс24

BitrixMCP

MCP-сервер для Битрикс24 на Python без LLM внутри: статический каталог методов, политика доступа read или write и OAuth пользователя для записи

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

Широкий доступ

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

  • В режиме read,write и при отключенном dry_run может создавать и обновлять сделки, задачи и дела
  • OAuth-режим хранит расшифровываемые токены доступа сотрудников на сервере
Все причины и проверки
Российский стек

aaparin/bitrixmcpАвтор:aaparin

Похожий инструмент с большим сообществом: bitrix-mcp, 1 ★ репозитория

Установка

Работает в
Сервисы

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

uv sync && uv run python main.py

Перед запуском скопируйте .env.example в .env и задайте BITRIX_WEBHOOK_URL.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • В режиме read,write и при отключенном dry_run может создавать и обновлять сделки, задачи и дела
  • OAuth-режим хранит расшифровываемые токены доступа сотрудников на сервере

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает клиентской модели инструменты поиска и описания методов Битрикс24 по встроенному статическому каталогу, а не по обращению к сети, плюс отдельный bitrix_call как запасной вызов любого разрешенного метода. Чтение CRM, задач, дел, сотрудников и телефонии идет через входящий вебхук. Запись возможна двумя способами: через вебхук с политикой доступа BITRIX_ALLOWED_ACCESS, или через персональный OAuth пользователя, когда сервер развернут как общий сервис для нескольких людей, например в LibreChat. В OAuth-режиме вебхук для записи блокируется, а изменения разрешены только владельцу записи, если явно не указан администратор. Каждая curated-запись по умолчанию идет с dry_run включенным.

Для кого. Для команд, которым нужен общий MCP-сервер Битрикс24 на несколько сотрудников с раздельным доступом на чтение и запись и явным подтверждением изменений.

Подходит, если

  • Нужен MCP-сервер для команды, а не для одного человека, с OAuth-идентификацией каждого пользователя
  • Важно ограничить агента только чтением через BITRIX_ALLOWED_ACCESS
  • Нужен статический каталог методов Битрикс24 вместо обращений к сети за описанием API

Не подходит, если

  • Нужен простой личный сервер без OAuth-приложения и шифрования токенов
  • Нет возможности зарегистрировать локальное приложение Битрикс24 для OAuth-режима записи

Пример запроса к агенту

Покажи мои открытые сделки в Битрикс24 и какие методы CRM вообще доступны через этот вебхук

MCP

Транспорт
stdio, http
Авторизация
API-ключ

Переменные окружения

BITRIX_WEBHOOK_URL обязательная, секрет
Адрес входящего вебхука портала Битрикс24
BITRIX_ALLOWED_ACCESS
Политика доступа: read, или read,write, или read,write,destructive
MCP_BEARER_TOKEN секрет
Общий bearer-токен для публичных развертываний, обязателен при включенном OAuth
BITRIX_OAUTH_CLIENT_ID секрет
Client ID локального приложения Битрикс24 для per-user OAuth
BITRIX_OAUTH_CLIENT_SECRET секрет
Client secret локального приложения Битрикс24 для per-user OAuth
BITRIX_TOKEN_ENCRYPTION_KEY секрет
Ключ Fernet для шифрования токенов OAuth в SQLite

Ограничения

Проект молодой, звезд нет, README прямо перечисляет недавние breaking changes в инструментах. Полная настройка OAuth-режима требует регистрации локального приложения в Битрикс24, ключа шифрования Fernet и учета особого заголовка X-Bitrix-User-Email от клиента. Каталог методов собирается из внешнего репозитория b24-rest-docs, актуальность каталога зависит от него. Лицензия в репозитории не указана.

Как отключить. Остановите docker compose или процесс python main.py и удалите сервер из настроек MCP клиента.

Частые вопросы

Может ли сервер сразу что-то поменять в CRM?

Curated-инструменты записи по умолчанию работают с dry_run=true, а доступ на запись в принципе управляется переменной BITRIX_ALLOWED_ACCESS.

Обязателен ли OAuth?

Нет, обычный режим работает на одном входящем вебхуке. OAuth нужен только для записи от имени конкретных сотрудников в общем развертывании.

Обсуждение

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

Битрикс24 — все инструменты
Российский стек

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

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

Bitrix24 MCP Server (qwito)

Bitrix24 MCP Server

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

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

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

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

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

Bitrix24 MCP Server (gunnit)

Bitrix24 MCP Server

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

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

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

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

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

Коротко о README

README описывает детерминированный сервер без внутреннего LLM: клиентская модель сама находит методы через bitrix_search_methods и bitrix_describe_method или вызывает bitrix_call. Отдельно расписаны curated-инструменты для CRM, задач, дел, сотрудников и телефонии, политика доступа через BITRIX_ALLOWED_ACCESS, схема per-user OAuth с шифрованием токенов Fernet и список недавних breaking changes относительно прошлой версии.

Бейдж для README

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