Шаблон MCP-сервера Битрикс24
bx24-template-mcp
Официальный шаблон MCP-сервера для Битрикс24 на Nuxt: готовые инструменты для задач и пользователей, три варианта развертывания
- 6 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Создает, меняет и удаляет данные задач в рабочем портале
- Вебхук дает доступ с правами создавшего его пользователя
- При заданном токене GitHub агент может создавать issue в публичном репозитории
Установка
- Работает в
- Сервисы
Ручная установка
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.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает, меняет и удаляет данные задач в рабочем портале
- Вебхук дает доступ с правами создавшего его пользователя
- При заданном токене GitHub агент может создавать issue в публичном репозитории
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект одновременно рабочий MCP-сервер и основа для собственного. Из коробки агент создает и обновляет задачи, ведет их по статусам, работает с чек-листами, результатами, учетом времени, зависимостями и комментариями, а также ищет пользователей по имени. Сервер ставится как файл расширения Claude Desktop, как локальный HTTP-сервер или как Docker-контейнер с TLS и авторизацией OAuth для каждого пользователя. Внутри официальный SDK b24jssdk, ограничение частоты запросов, маскирование секрета вебхука в логах и тесты.
Для кого. Командам на Битрикс24, которые хотят вести задачи через агента, и разработчикам, которые строят свой MCP-сервер для портала.
Подходит, если
- Нужно ставить и закрывать задачи в Битрикс24 обычными фразами
- Нужна основа для своего MCP-сервера с авторизацией и тестами
- Нужно подключить агента к коробочному Битрикс24 на своем сервере
Не подходит, если
- Нужна работа со сделками и контактами CRM: в текущей версии их нет
- Нужно просто справиться о методах REST API без доступа к порталу
Пример запроса к агенту
Поставь задачу Ивану Петрову подготовить бюджет к пятнице 18:00 с высоким приоритетом и добавь чек-лист из трех пунктовMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
NUXT_BITRIX24_WEBHOOK_URLобязательная, секрет- Адрес входящего вебхука портала с правами user и task
NUXT_MCP_AUTH_TOKENобязательная, секрет- Bearer-токен для доступа клиентов к /mcp
NUXT_BITRIX24_OAUTH_ENABLED- Включает авторизацию OAuth для каждого пользователя вместо общего вебхука
Ограничения
Сейчас покрыты только задачи и поиск пользователей, CRM в планах. Для локального и серверного режимов нужен Node.js 22 и pnpm, для работы нужен входящий вебхук портала с правами user и task. Вебхук действует с правами создавшего его пользователя, поэтому авторы советуют завести служебную учетную запись. До версии 1.0 названия инструментов могут меняться между минорными релизами. Инструмент обратной связи создает issue на GitHub, если задан токен GitHub.
Как отключить. Удалите сервер командой claude mcp remove bx24 или уберите блок bx24 из конфигурации клиента, расширение Claude Desktop удаляется в разделе Extensions. Вебхук отключите в настройках портала.
Частые вопросы
Можно без терминала?
Да, готовый файл .dxt прикладывается к релизам на GitHub. Его ставят в Claude Desktop через Settings, Extensions, Install from file и вставляют адрес вебхука.
Работает с коробочной версией?
Да, поддерживаются облачный и коробочный Битрикс24. Для внутреннего сертификата задайте NODE_EXTRA_CA_CERTS.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыMCP-сервер Битрикс24 с реальными вызовами
MCP Server for Bitrix24
MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию
Скилл шаблона дашборда Битрикс24 на Nuxt
Nuxt Dashboard Template
Официальный стартовый Nuxt-дашборд Битрикс24 на b24ui с мок-данными и скиллом, который ведет разработку по архитектуре шаблона
MCP-сервер Битрикс24: задачи, CRM и списки
Bitrix24 Tasks, CRM & Lists MCP Server
Модульный MCP-сервер Битрикс24 на 46 инструментов: задачи и канбан, CRM-сделки и контакты, универсальные списки, работает в Docker без стороннего кеша
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
Компактный MCP-сервер Битрикс24 на входящем вебхуке: задачи, группы, канбан-стадии и комментарии задач
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
Коротко о README
README предлагает три пути установки для разных людей: расширение Claude Desktop, локальный HTTP-сервер и Docker для команды. Приведена полная таблица инструментов с пакетным режимом для смены статусов и чек-листов. Описаны настройка вебхука, подключение Claude Code, Cursor и Claude Desktop, работа с коробочной версией, хранение секретов и часовые пояса в сроках задач. Отдельно сказано, что сервер не отправляет телеметрию. Лицензия MIT.