bitrix-mcp
MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала
- 1 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Создает, меняет и удаляет сделки, задачи, файлы и события в рабочем портале
- Вебхук является предъявительским доступом ко всему порталу
- Запускает бизнес-процессы и отправляет сообщения сотрудникам
Установка
- Работает в
- Сервисы
Ручная установка
uv sync
uv tool install .Выполните в клоне репозитория. Вторая команда добавляет bitrix-mcp в PATH.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает, меняет и удаляет сделки, задачи, файлы и события в рабочем портале
- Вебхук является предъявительским доступом ко всему порталу
- Запускает бизнес-процессы и отправляет сообщения сотрудникам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 99 типизированных инструментов для CRM, задач, скрама, календаря, диска, групп, списков, каталога, бизнес-процессов и телефонии. Универсальные b24_call и b24_batch достают любой метод REST API, а встроенный каталог методов из официальной документации подсказывает агенту нужный метод и параметры. Автор разобрал известные ловушки API: фильтры уходят JSON-телом, ошибки доступа не маскируются под пустой результат, перенос карточки на скрам-доске делается рабочей последовательностью вызовов. События портала принимаются через pull-канал, исходящий вебхук или опрос, их можно пересылать в Telegram. Флаг BITRIX_READ_ONLY блокирует запись.
Для кого. Для команд на Битрикс24 и интеграторов, которым нужен полный доступ агента к порталу, а не только к CRM.
Подходит, если
- Агент должен создавать и обновлять сделки, задачи или события календаря
- Нужно работать со скрам-доской спринта из чата
- Нужно получать события портала и пересылать важные в Telegram
Не подходит, если
- Хватит простого чтения лидов и сделок без записи
- Нельзя выдавать агенту вебхук с широкими правами на портал
Пример запроса к агенту
Покажи доску активного спринта и перенеси задачу 1532 в колонку «Готово»MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
BITRIX_WEBHOOK_URLобязательная, секрет- Входящий вебхук портала вида https://портал/rest/<user_id>/<токен>/
BITRIX_READ_ONLY- 1 блокирует все методы записи
BITRIX_MAX_PAGES- Предел страниц при fetch_all, по умолчанию 40
BITRIX_TELEGRAM_TOKENсекрет- Токен бота для пересылки событий в Telegram
Ограничения
URL вебхука дает доступ ко всему, что разрешено пользователю, от чьего имени он создан. Защита от записи для b24_call и b24_batch определяет запись по глаголу метода и может ошибиться. Выборка с fetch_all ограничена BITRIX_MAX_PAGES, по умолчанию около 2000 записей. Для приема исходящих вебхуков нужен режим HTTP и адрес, доступный порталу. Нужен Python 3.10+ и uv или портативная сборка.
Как отключить. Выполните claude mcp remove bitrix24 или удалите блок bitrix24 из конфигурации клиента, затем отзовите вебхук в профиле Битрикс24.
Частые вопросы
Можно ли запретить агенту запись?
Да, переменная BITRIX_READ_ONLY=1 блокирует методы add, update, delete и подобные, чтение остается доступным.
Что делать без Python на машине?
Соберите портативный архив скриптом build_portable.py: внутри свой Python и установщик, который прописывает сервер в Claude Code, Claude Desktop или Cursor.
Чем bitrix-mcp от john7ross отличается от других MCP для Битрикс24?
Сервер дает агенту 99 типизированных инструментов для CRM, задач, скрама, календаря, диска, групп, списков, каталога, бизнес-процессов и телефонии. Универсальные b24_call и b24_batch вызывают любой метод REST API.
Можно ли запретить агенту запись и что делать без Python?
Выдайте вебхуку Битрикс24 только права на чтение, тогда запись будет невозможна на стороне портала. Сервер ставится командами uv sync и uv tool install ., отдельный Python для uv не нужен, он сам подтянет интерпретатор. Работает в Claude Code, Claude Desktop, Cursor, Windsurf и Cline.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыMCP-сервер Битрикс24 с реальными вызовами
MCP Server for Bitrix24
MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
Read-only MCP-сервер, который читает сделки, контакты и компании Битрикс24 SELECT-запросами к базе, минуя REST API
MCP-сервер Битрикс24: задачи, CRM и списки
Bitrix24 Tasks, CRM & Lists MCP Server
Модульный MCP-сервер Битрикс24 на 46 инструментов: задачи и канбан, CRM-сделки и контакты, универсальные списки, работает в Docker без стороннего кеша
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
Bitrix24 MCP Server (qwito)
Bitrix24 MCP Server
MCP-сервер на TypeScript с более чем 45 инструментами для CRM Битрикс24: контакты, сделки, лиды, компании, задачи и аналитика активности
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| bitrix-mcp (эта запись) | нет | API-ключ | 1 | |
| Bitrix24 MCP Server | нет | API-ключ | 64 | вебхук |
| Bitrix24 MCP Server (gunnit) | нет | API-ключ | 34 | на TypeScript для CRM |
| Bitrix24 MCP для документации REST API | да | не нужна | 7 | документация REST API |
Альтернативы
Инструменты других авторов для тех же задач.
Коротко о README
README на английском и русском описывает универсальный MCP-сервер для Битрикс24 с транспортами stdio и Streamable HTTP. Таблица показывает, какие ошибки прежней обертки исправлены и как. Разобраны установка через uv или портативный архив, настройка вебхука, приоритет авторизации, подключение Claude Code, Claude Desktop и общего .mcp.json, полный каталог инструментов. Отдельно перечислены проверочные скрипты, лимиты выборок и политика безопасности.