MCP-сервер Битрикс24 с реальными вызовами
MCP Server for Bitrix24
MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Выполняет реальные вызовы CRM, задач, документов и бизнес-процессов, а не только читает документацию
- Деструктивные действия без включенного BX24_CONFIRM_DESTRUCTIVE не требуют подтверждения
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-for-bitrix24Определит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio bitrix24 -- npx -y mcp-b24Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"bitrix24","type":"stdio","command":"npx","args":["-y","mcp-b24"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"bitrix24": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add bitrix24 -- npx -y mcp-b24Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.bitrix24]
command = "npx"
args = ["-y", "mcp-b24"]Если файл уже есть, допишите блок в конец.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"bitrix24": {
"type": "local",
"command": [
"npx",
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"mcp-b24"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BX24_WEBHOOK_URLсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Создай входящий вебхук в разделе Ресурсы для разработчиков портала Битрикс24, поставь npx -y mcp-b24 и передай переменную BX24_WEBHOOK_URL в конфигурации MCP-клиента, либо настрой OAuth-приложение с BX24_DOMAIN, BX24_CLIENT_ID, BX24_CLIENT_SECRET и BX24_REFRESH_TOKEN.
Другие способы из описания автора
npx -y mcp-b24Запуск без глобальной установки, нужен Node.js 18 или новее.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает REST API Битрикс24 версий 1.0 и 3.0 в 43 инструмента с примерно 870 действиями: CRM, задачи, чаты, диск, календарь, HR, смарт-процессы, почта, телефония, бизнес-процессы, события, открытые линии, чат-боты, генератор документов, счета, валюта, веб-формы, трекинг и склад. README прямо противопоставляет себя официальному MCP Битрикс24, который только отдает документацию: этот сервер выполняет настоящие вызовы на портале. Поддерживает вход через входящий вебхук или OAuth-приложение с автообновлением токена, автопагинацию списков с ограничением строк, ограничение частоты запросов под тариф портала, а деструктивные операции можно защитить обязательным флагом confirm.
Для кого. Для команд на Битрикс24, которым нужен агент, реально меняющий данные в CRM и задачах, а не просто читающий документацию по API.
Подходит, если
- Нужны реальные вызовы REST API Битрикс24, а не справка по методам
- Нужна защита от случайных деструктивных операций флагом BX24_CONFIRM_DESTRUCTIVE
- Нужна автопагинация больших списков и ограничение частоты запросов под тариф портала
Не подходит, если
- Нужен только справочник методов API без выполнения вызовов: для этого есть официальный MCP Битрикс24
- Нет входящего вебхука или OAuth-приложения и не готовы их настраивать
Пример запроса к агенту
Создай в Битрикс24 задачу на проверку счета и назначь ее ответственному по сделкеОграничения
Нужен активный портал Битрикс24, облачный или коробочный, и один из двух способов входа: входящий вебхук или полное OAuth-приложение с доменом, client_id, client_secret и refresh_token. Лимит частоты запросов по умолчанию 2 в секунду для обычных тарифов и до 5 для Enterprise, это ограничение самого Битрикс24, а не сервера. Без явного включения BX24_CONFIRM_DESTRUCTIVE деструктивные действия выполняются без обязательного дополнительного подтверждения.
Как отключить. Удалите сервер из конфигурации MCP-клиента и отзовите входящий вебхук или OAuth-приложение в настройках портала Битрикс24.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BX24_WEBHOOK_URL секрет | URL входящего вебхука портала, альтернатива OAuth. |
| BX24_CLIENT_ID секрет | Client ID OAuth-приложения, нужен вместе с DOMAIN, SECRET и REFRESH_TOKEN. |
| BX24_CONFIRM_DESTRUCTIVE | При true требует явный флаг confirm перед деструктивными действиями. |
Проверка безопасности
- Выполняет реальные вызовы CRM, задач, документов и бизнес-процессов, а не только читает документацию
- Деструктивные действия без включенного BX24_CONFIRM_DESTRUCTIVE не требуют подтверждения
Коротко о README
README на английском с версией на русском в i18n описывает сервер как обертку REST API Битрикс24 версий 1.0 и 3.0, дает таблицу совместимости API, установку через npm или npx, полную таблицу переменных окружения для вебхука и OAuth, лимиты частоты запросов по тарифам, автопагинацию и подтверждение деструктивных действий, ссылку на npm-пакет mcp-b24 и разделы инструментов, сценариев использования и разработки.
Частые вопросы
Чем это отличается от официального MCP Битрикс24?
Официальный сервер только отдает документацию по методам API, этот выполняет настоящие вызовы на портале.
Можно ли обезопасить деструктивные операции?
Да, переменная BX24_CONFIRM_DESTRUCTIVE=true требует явный флаг confirm перед такими действиями.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма