MCP-сервер Bitrix24: задачи и списки
Bitrix24 MCP Server
MCP-сервер для Bitrix24 с 12 консолидированными инструментами: задачи, чек-листы, время, пользователи, отделы, рабочие группы и универсальные списки
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может создавать, обновлять и завершать задачи, а также архивировать их массово
- Вебхук дает доступ к пользователям, отделам и спискам под правами создавшего его сотрудника
Установка
Ручная установка
git clone https://github.com/SvenTern/mcp_bitrix.git && cd mcp_bitrix && npm install && npm run buildСборка из исходников, готового пакета в npm нет.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер поднимается как STDIO-процесс или HTTP-сервис в Docker и говорит с порталом Bitrix24 через входящий вебхук. Вместо 71 отдельного метода REST API он группирует их в 12 инструментов: задачи (19 действий, включая статусы и делегирование), чек-листы, комментарии, учет времени, пользователи, отделы, рабочие группы и универсальные списки с элементами, полями и разделами. Есть health-check и эндпоинт информации о сервере для проверки, что все поднялось. Подключение к Claude Desktop и другим MCP-клиентам идет либо локально через STDIO, либо удаленно через npx mcp-remote.
Для кого. Для команд на Bitrix24, которым нужен агент, управляющий задачами, канбаном и оргструктурой портала.
Подходит, если
- Нужно создавать и обновлять задачи, чек-листы и комментарии из чата с агентом
- Нужен доступ к универсальным спискам Bitrix24 (elements, fields, sections)
- Нужен отдельный контур деплоя через Docker с nginx перед сервером
Не подходит, если
- Нужна работа с CRM-сделками и лидами: сервер их не покрывает
- Нужен готовый облачный сервис без своего вебхука и деплоя
Пример запроса к агенту
Покажи мои задачи в работе по проекту 9 и заверши все, что старше двух недельОграничения
Сервер покрывает задачи, чек-листы, пользователей, отделы, рабочие группы и списки, но не CRM. Вебхук дает полный доступ к перечисленным разделам под правами создавшего его пользователя. Готового npm-пакета нет, ставится только из исходников со сборкой TypeScript. Тестового покрытия для консолидированных инструментов в README не описано.
Как отключить. Остановите Docker-контейнер (docker-compose down) или удалите сервер из конфигурации MCP-клиента, затем деактивируйте вебхук в настройках Bitrix24.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BITRIX24_WEBHOOK_URL обязательная, секрет | URL входящего вебхука Bitrix24 с правами на задачи, пользователей, отделы, рабочие группы и списки |
| BITRIX24_TIMEOUT | Таймаут запроса к Bitrix24 в миллисекундах, по умолчанию 30000 |
Проверка безопасности
- Может создавать, обновлять и завершать задачи, а также архивировать их массово
- Вебхук дает доступ к пользователям, отделам и спискам под правами создавшего его сотрудника
Коротко о README
README описывает архитектуру с 12 консолидированными инструментами вместо 71 отдельного метода, таблицу их действий, протокол MCP 2025-11-25 со Streamable HTTP, требования (Node 20+, Python 3.11+, Docker), шаги установки, права вебхука по разделам и примеры конфигурации для Claude Desktop в локальном и удаленном режиме.
Частые вопросы
Можно работать с CRM-сделками?
Нет, инструменты покрывают задачи, списки, пользователей и рабочие группы, но не лиды и сделки CRM.
Обязателен ли Docker?
Нет, есть режим STDIO для локального запуска через node, Docker нужен только для HTTP-варианта с nginx.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма