bitrix-mcp
MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала
Установка
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 в колонку «Готово»Ограничения
URL вебхука дает доступ ко всему, что разрешено пользователю, от чьего имени он создан. Защита от записи для b24_call и b24_batch определяет запись по глаголу метода и может ошибиться. Выборка с fetch_all ограничена BITRIX_MAX_PAGES, по умолчанию около 2000 записей. Для приема исходящих вебхуков нужен режим HTTP и адрес, доступный порталу. Нужен Python 3.10+ и uv или портативная сборка.
Как отключить. Выполните claude mcp remove bitrix24 или удалите блок bitrix24 из конфигурации клиента, затем отзовите вебхук в профиле Битрикс24.
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 |
Проверка безопасности
- Создает, меняет и удаляет сделки, задачи, файлы и события в рабочем портале
- Вебхук является предъявительским доступом ко всему порталу
- Запускает бизнес-процессы и отправляет сообщения сотрудникам
Коротко о README
README на английском и русском описывает универсальный MCP-сервер для Битрикс24 с транспортами stdio и Streamable HTTP. Таблица показывает, какие ошибки прежней обертки исправлены и как. Разобраны установка через uv или портативный архив, настройка вебхука, приоритет авторизации, подключение Claude Code, Claude Desktop и общего .mcp.json, полный каталог инструментов. Отдельно перечислены проверочные скрипты, лимиты выборок и политика безопасности.
Частые вопросы
Можно ли запретить агенту запись?
Да, переменная BITRIX_READ_ONLY=1 блокирует методы add, update, delete и подобные, чтение остается доступным.
Что делать без Python на машине?
Соберите портативный архив скриптом build_portable.py: внутри свой Python и установщик, который прописывает сервер в Claude Code, Claude Desktop или Cursor.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
E-Commerce Skills
E-Commerce Skills by Nexscope
Большой набор текстовых скиллов для продавцов Amazon, Shopify, eBay, Etsy, TikTok Shop и Walmart: цены, листинги, реклама, рост
153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки