MCP-сервер Битрикс24 на fast-bitrix24
Bitrix24 MCP Server
Асинхронный MCP-сервер для Битрикс24 с раздельными наборами инструментов для задач, лидов, сделок, контактов, компаний, проектов и календаря
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты создают и обновляют лиды, сделки, контакты и компании
- Полный доступ определяется правами вебхука, отдельного read-only режима нет
Установка
Ручная установка
python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txtКоманды из README после клонирования репозитория.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер построен поверх библиотеки fast-bitrix24 и разносит инструменты по семи модулям: задачи с полным циклом, лиды, сделки, контакты, компании, рабочие группы и события календаря. Все вызовы асинхронные, поля и параметры типизированы, а к каждому модулю есть отдельные unit-тесты и одна сквозная интеграционная проверка на задачах. В репозитории есть workflow с проверкой качества кода и тестами на каждый push.
Для кого. Для разработчиков, которым важны покрытие тестами и типизация в MCP-сервере Битрикс24.
Подходит, если
- Нужен MCP-сервер Битрикс24 с покрытием тестами, а не только рабочим прототипом
- Нужны сразу несколько модулей CRM: лиды, сделки, контакты и компании
- Нужны события календаря и рабочие группы в том же сервере
Не подходит, если
- Нужны чаты, диск или звонки: их в этом сервере нет
- README еще содержит плейсхолдер your-org в команде клонирования, реальный адрес только в самом репозитории
Пример запроса к агенту
Найди сделки на этой неделе без ответственного и создай задачу проверить ихОграничения
Нет чатов, диска и телефонии. Документация README короткая, детали параметров нужно смотреть в исходниках src/bitrix_mcp/tools. В README команда клонирования указывает плейсхолдер your-org вместо реального владельца репозитория.
Как отключить. Удалите запись сервера из конфигурации MCP клиента и остановите процесс python -m bitrix_mcp.server.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BITRIX24_WEBHOOK обязательная, секрет | Адрес входящего вебхука Битрикс24 |
Проверка безопасности
- Инструменты создают и обновляют лиды, сделки, контакты и компании
- Полный доступ определяется правами вебхука, отдельного read-only режима нет
Коротко о README
README перечисляет модули CRM-management, task-management, calendar и projects, дает быстрый старт через venv и pip install, переменную BITRIX24_WEBHOOK и команды запуска сервера и тестов. Подробный список инструментов вынесен в отдельный AGENTS.md с архитектурой и соглашениями разработки.
Частые вопросы
На чем построен клиент Битрикс24?
На библиотеке fast-bitrix24, которая сама следит за лимитами запросов и делает вызовы асинхронными.
Есть ли тесты?
Да, unit-тесты на каждый модуль CRM и задач и один интеграционный тест.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма