Шаблон MCP-сервера Битрикс24
bx24-template-mcp
Официальный шаблон MCP-сервера для Битрикс24 на Nuxt: готовые инструменты для задач и пользователей, три варианта развертывания
Установка
git clone https://github.com/bitrix24/templates-mcp.git
cd templates-mcp
cp .env.example .env
pnpm install
pnpm build
pnpm startПеред запуском впишите в .env NUXT_BITRIX24_WEBHOOK_URL и NUXT_MCP_AUTH_TOKEN. Сервер слушает http://localhost:3000/mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект одновременно рабочий MCP-сервер и основа для собственного. Из коробки агент создает и обновляет задачи, ведет их по статусам, работает с чек-листами, результатами, учетом времени, зависимостями и комментариями, а также ищет пользователей по имени. Сервер ставится как файл расширения Claude Desktop, как локальный HTTP-сервер или как Docker-контейнер с TLS и авторизацией OAuth для каждого пользователя. Внутри официальный SDK b24jssdk, ограничение частоты запросов, маскирование секрета вебхука в логах и тесты.
Для кого. Командам на Битрикс24, которые хотят вести задачи через агента, и разработчикам, которые строят свой MCP-сервер для портала.
Подходит, если
- Нужно ставить и закрывать задачи в Битрикс24 обычными фразами
- Нужна основа для своего MCP-сервера с авторизацией и тестами
- Нужно подключить агента к коробочному Битрикс24 на своем сервере
Не подходит, если
- Нужна работа со сделками и контактами CRM: в текущей версии их нет
- Нужно просто справиться о методах REST API без доступа к порталу
Пример запроса к агенту
Поставь задачу Ивану Петрову подготовить бюджет к пятнице 18:00 с высоким приоритетом и добавь чек-лист из трех пунктовОграничения
Сейчас покрыты только задачи и поиск пользователей, CRM в планах. Для локального и серверного режимов нужен Node.js 22 и pnpm, для работы нужен входящий вебхук портала с правами user и task. Вебхук действует с правами создавшего его пользователя, поэтому авторы советуют завести служебную учетную запись. До версии 1.0 названия инструментов могут меняться между минорными релизами. Инструмент обратной связи создает issue на GitHub, если задан токен GitHub.
Как отключить. Удалите сервер командой claude mcp remove bx24 или уберите блок bx24 из конфигурации клиента, расширение Claude Desktop удаляется в разделе Extensions. Вебхук отключите в настройках портала.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| NUXT_BITRIX24_WEBHOOK_URL обязательная, секрет | Адрес входящего вебхука портала с правами user и task |
| NUXT_MCP_AUTH_TOKEN обязательная, секрет | Bearer-токен для доступа клиентов к /mcp |
| NUXT_BITRIX24_OAUTH_ENABLED | Включает авторизацию OAuth для каждого пользователя вместо общего вебхука |
Проверка безопасности
- Создает, меняет и удаляет данные задач в рабочем портале
- Вебхук дает доступ с правами создавшего его пользователя
- При заданном токене GitHub агент может создавать issue в публичном репозитории
Коротко о README
README предлагает три пути установки для разных людей: расширение Claude Desktop, локальный HTTP-сервер и Docker для команды. Приведена полная таблица инструментов с пакетным режимом для смены статусов и чек-листов. Описаны настройка вебхука, подключение Claude Code, Cursor и Claude Desktop, работа с коробочной версией, хранение секретов и часовые пояса в сроках задач. Отдельно сказано, что сервер не отправляет телеметрию. Лицензия MIT.
Частые вопросы
Можно без терминала?
Да, готовый файл .dxt прикладывается к релизам на GitHub. Его ставят в Claude Desktop через Settings, Extensions, Install from file и вставляют адрес вебхука.
Работает с коробочной версией?
Да, поддерживаются облачный и коробочный Битрикс24. Для внутреннего сертификата задайте NODE_EXTRA_CA_CERTS.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании