mcp-bitrix24
MCP-сервер для задач, рабочих групп и пользователей Битрикс24 по входящему вебхуку, с чистой архитектурой на TypeScript
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает, закрывает и переоткрывает задачи в рабочем портале Битрикс24
- Вебхук дает права, заданные при его создании, стоит выдать отдельный вебхук только под нужные методы
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-bitrix24Определит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' bitrix24 -- npx -y mcp-bitrix24Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"bitrix24","type":"stdio","command":"npx","args":["-y","mcp-bitrix24"],"env":{"BITRIX24_WEBHOOK_URL":"<ваш BITRIX24_WEBHOOK_URL>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"bitrix24": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add bitrix24 --env 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' -- npx -y mcp-bitrix24Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.bitrix24]
command = "npx"
args = ["-y", "mcp-bitrix24"]
env = { BITRIX24_WEBHOOK_URL = "<ваш BITRIX24_WEBHOOK_URL>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"bitrix24": {
"type": "local",
"command": [
"npx",
"-y",
"mcp-bitrix24"
],
"environment": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-bitrix24"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполни npx -y mcp-bitrix24 с переменной окружения BITRIX24_WEBHOOK_URL, указывающей на входящий вебхук вашего портала Битрикс24, и добавь сервер bitrix24 в конфигурацию mcp_servers агента.
Другие способы из описания автора
npx mcp-bitrix24Требует переменную окружения BITRIX24_WEBHOOK_URL с адресом входящего вебхука портала.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к порталу Битрикс24 через входящий вебхук и дает агенту работать с задачами: создавать, обновлять, закрывать, переоткрывать и получать список задач, а также смотреть историю изменений задачи. Отдельно поддерживаются рабочие группы: создание и список, и пользователи: список, текущий пользователь и доступные поля. Для создания задач с произвольными полями есть инструмент get_task_fields, который проверяет ключи fields на соответствие реальным полям Битрикс24. Сервер работает только по stdio, входные данные инструментов валидируются через zod, а сам код разделен на слои mcp, adapters, domain и infrastructure.
Для кого. Для команд на Битрикс24, которым нужен узкий и предсказуемый набор инструментов для задач и рабочих групп без лишних сущностей CRM.
Подходит, если
- Нужно создавать и закрывать задачи Битрикс24 из диалога с агентом
- Нужна история изменений конкретной задачи
- Нужен только модуль задач и групп, без сделок, лидов и контактов
Не подходит, если
- Нужна работа со сделками, лидами, контактами или CRM-сущностями: сервер их не поддерживает
- Нужен HTTP-транспорт вместо stdio
- Нет входящего вебхука Битрикс24 с нужными правами на задачи и группы
Пример запроса к агенту
Создай задачу «Подготовить отчет» на группу «Маркетинг» и покажи список открытых задач этой группыОграничения
Покрывает только задачи, рабочие группы и пользователей, CRM-сущности не поддерживаются. Работает только по stdio, HTTP-транспорта нет. Список задач получает по 50 записей за раз от Битрикс24, limit применяется уже после этого локальным срезом.
Как отключить. Удалите блок mcp_servers.bitrix24 из конфигурации клиента и отзовите вебхук в настройках Битрикс24.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BITRIX24_WEBHOOK_URL обязательная, секрет | Адрес входящего вебхука Битрикс24 с правами на задачи, группы и пользователей |
Проверка безопасности
- Создает, закрывает и переоткрывает задачи в рабочем портале Битрикс24
- Вебхук дает права, заданные при его создании, стоит выдать отдельный вебхук только под нужные методы
Коротко о README
README на английском описывает сервер как реализацию MCP/JSON-RPC по STDIO для задач, рабочих групп и пользователей Битрикс24. Дана таблица всех инструментов с входными и выходными параметрами, пример конфигурации для Codex с переменной BITRIX24_WEBHOOK_URL и описание архитектуры по слоям mcp, adapters, domain, infrastructure. Отдельно отмечено, что валидация идет через zod и транспорт только STDIO.
Частые вопросы
Можно ли работать со сделками через этот сервер?
Нет, README ограничивает набор задачами, рабочими группами и пользователями.
Как проверить, что поле в fields существует?
Вызвать get_task_fields, инструмент create_task сверяет переданные ключи fields с этим списком.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма