Bitrix24 MCP с чат-ботом
Bitrix24 MCP Server
MCP-сервер Битрикс24 на PyPI с готовым слоем чат-бота: ИИ-агент отвечает в чатах портала как сотрудник
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Отвечает сотрудникам в общих чатах портала от имени зарегистрированного бота
- Создает и меняет сделки, лиды и задачи в реальном портале
Установка
Ручная установка
pip install bitrix24-mcpПосле установки задайте BITRIX_WEBHOOK_URL и запустите bitrix24-mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает стандартные инструменты CRM (поиск и карточка контактов, сделок с фильтрами и сменой стадии, лидов, создание сделок и лидов) и задач (поиск, создание, карточка по ID), а также ресурсы по URI вроде contact://123 и deals://active. Главная особенность это готовый слой ChatBotService для чат-ботов Битрикс24 (imbot): разработчику достаточно написать один метод handle_message, который вызывает свою LLM и возвращает ответ, а сервер сам регистрирует бота в портале, принимает входящие сообщения через HTTP-обработчик вебхуков и дублирует ответы в таймлайн сделки. После регистрации агент появляется в общих чатах портала как обычный сотрудник и отвечает менеджерам напрямую.
Для кого. Для команд, которые хотят посадить ИИ-агента прямо в рабочие чаты Битрикс24, а не только дать ему доступ к данным CRM.
Подходит, если
- Нужен ИИ-агент, который отвечает сотрудникам прямо в чатах Битрикс24
- Нужна базовая работа с CRM (контакты, сделки, лиды) и задачами через MCP
- Нужно, чтобы ответы бота автоматически дублировались в таймлайн сделки
Не подходит, если
- Не готовы поднимать публичный HTTPS-адрес для приема вебхуков чат-бота
- Нужны только данные CRM без встраивания агента в чаты сотрудников
Пример запроса к агенту
Зарегистрируй бота-агента в чатах Битрикс24 и настрой дублирование его ответов в таймлайн сделки 123Ограничения
Для функции чат-бота нужен публичный HTTPS URL (ngrok, cloudflared или свой хостинг) для приема событий Битрикс24, без него доступны только обычные MCP-инструменты. Логику самого ИИ-агента (вызов LLM) нужно написать самостоятельно, сервер дает только обвязку регистрации и доставки сообщений.
Как отключить. Удалите пакет pip uninstall bitrix24-mcp, отзовите вебхук в портале и отключите бота из чатов через раздел MCP-подключений или ChatBotService.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BITRIX_WEBHOOK_URL обязательная, секрет | Полный URL входящего вебхука Битрикс24 с правами crm, imbot, user |
| BOT_EVENT_HANDLER_URL | Публичный HTTPS-адрес для приема событий чат-бота |
Проверка безопасности
- Отвечает сотрудникам в общих чатах портала от имени зарегистрированного бота
- Создает и меняет сделки, лиды и задачи в реальном портале
Коротко о README
README описывает установку через pip, настройку входящего вебхука с правами crm, imbot, user, запуск сервера на stdio, пример кода регистрации собственного ИИ-агента в ChatBotService, таблицы инструментов по CRM, чат-боту и задачам, ресурсы по URI, конфигурации для Claude Desktop, Hermes Agent и Cursor, архитектурную схему и полный пример чат-бота с HTTP-обработчиком вебхуков. Лицензия MIT.
Частые вопросы
Нужно ли писать свою LLM-интеграцию?
Да, сервер дает только обвязку (регистрация бота, прием сообщений, ответ), а вызов конкретной модели пишется в одном методе handle_message.
Можно ли использовать без чат-бота, только для CRM?
Да, обычные инструменты CRM и задач работают через stdio сразу после настройки вебхука, публичный URL нужен только для чат-бота.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма