MCP-сервер Bitrix24 с расшифровкой звонков

Bitrix24 MCP Server

MCP-сервер Битрикс24 с 35 инструментами: задачи, CRM, база знаний и локальная расшифровка записей звонков

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Создает и меняет задачи, сделки и заметки в реальном портале
  • Скачивает записи звонков с персональными данными клиентов для локальной обработки
Все причины и проверки
Российский стек

paskal/bitrix24-mcp-server

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/paskal-bitrix24-mcp-server

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' bitrix24 -- npx tsx src/index.ts

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": [
        "tsx",
        "src/index.ts"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": [
        "tsx",
        "src/index.ts"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"bitrix24","type":"stdio","command":"npx","args":["tsx","src/index.ts"],"env":{"BITRIX24_WEBHOOK_URL":"<ваш BITRIX24_WEBHOOK_URL>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "bitrix24": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "tsx",
        "src/index.ts"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add bitrix24 --env 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' -- npx tsx src/index.ts

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.bitrix24]
command = "npx"
args = ["tsx", "src/index.ts"]
env = { BITRIX24_WEBHOOK_URL = "<ваш BITRIX24_WEBHOOK_URL>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' bitrix24 npx tsx src/index.ts

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": [
        "tsx",
        "src/index.ts"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": [
        "tsx",
        "src/index.ts"
      ],
      "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": [
        "tsx",
        "src/index.ts"
      ],
      "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": [
        "tsx",
        "src/index.ts"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "bitrix24": {
      "type": "local",
      "command": [
        "npx",
        "tsx",
        "src/index.ts"
      ],
      "environment": {
        "BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "bitrix24": {
      "command": "npx",
      "args": [
        "tsx",
        "src/index.ts"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": [
        "tsx",
        "src/index.ts"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

BITRIX24_WEBHOOK_URLсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 0b84ebc.

Текст для агента

Склонируй paskal/bitrix24-mcp-server, выполни npm install, создай входящий вебхук Битрикс24 с нужными правами и подключи сервер в .mcp.json командой npx tsx src/index.ts с переменной BITRIX24_WEBHOOK_URL.

Другие способы из описания автора
git clone <this-repo> && cd bitrix24-mcp-server && npm install

Клонирование и установка зависимостей, дальше сервер запускается через npx tsx src/index.ts.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключается к Битрикс24 через входящий вебхук и открывает агенту инструменты по задачам (список, карточка, создание, обновление, статусы, комментарии с BBCode и упоминаниями, чек-листы, канбан-стадии), CRM (сделки, контакты, лиды, таймлайн активностей, статистика звонков Voximplant) и пользователям с рабочими группами. Отдельный блок из пяти инструментов скачивает запись звонка и расшифровывает ее локально, без облака: быстрый уровень на GigaAM v2, читаемый уровень на Whisper large-v3 и максимальный уровень, объединяющий GigaAM, Whisper и диаризацию pyannote с распознаванием говорящих. Есть заметки на таймлайне с защитой от случайной перезаписи (create не затирает существующую заметку без явного replace или append). Опционально подключается база знаний стороннего приложения «База знаний и тестирование» с чтением, записью статей и запросом к ее GPT-помощнику, если задан токен.

Для кого. Для команд продаж и поддержки на Битрикс24, которым нужны не только задачи и CRM, но и расшифровка записей звонков без утечки аудио в облако.

Подходит, если

  • Нужна расшифровка записей звонков локально, без отправки аудио во внешний сервис
  • Нужен полный набор инструментов задач и CRM с чек-листами и канбан-стадиями
  • Нужна интеграция с базой знаний портала и защита заметок таймлайна от перезаписи

Не подходит, если

  • Нужен только простой доступ к сделкам и задачам без установки Python-окружений для расшифровки
  • Нет ресурсов на локальный запуск моделей Whisper или GigaAM (несколько гигабайт весов)
  • Нужна работа с бизнес-процессами: инструментов для bizproc нет

Пример запроса к агенту

Расшифруй запись последнего звонка по сделке 4821 и сохрани краткую заметку в таймлайн сделки

Ограничения

Расшифровка звонков требует отдельных Python-окружений с torch, а максимальный уровень еще и токен HuggingFace с принятыми условиями моделей pyannote. Инструменты базы знаний работают только со сторонним платным приложением «База знаний и тестирование». Нативные функции Битрикс24 CoPilot для расшифровки звонков через REST API недоступны в принципе, поэтому сервер скачивает и расшифровывает запись сам.

Как отключить. Удалите запись сервера bitrix24 из .mcp.json клиента и остановите процесс сервера, отзовите вебхук в портале при необходимости.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
BITRIX24_WEBHOOK_URL
обязательная, секрет
Полный URL входящего вебхука Битрикс24
BITRIX24_WEBHOOK_OP_REF
секрет
Ссылка на секрет в 1Password вместо прямого URL вебхука
KB_API_TOKEN
секрет
Токен приложения базы знаний для инструментов kb_*
HF_TOKEN
секрет
Токен HuggingFace для гейтированных моделей диаризации в максимальном уровне расшифровки

Проверка безопасности

  • Создает и меняет задачи, сделки и заметки в реальном портале
  • Скачивает записи звонков с персональными данными клиентов для локальной обработки

Коротко о README

README перечисляет 35 инструментов по группам (задачи, комментарии, чек-листы, канбан, CRM, расшифровка звонков, пользователи и рабочие группы, база знаний), объясняет создание входящего вебхука с нужными правами, два способа передать секрет (переменная окружения или ссылка на 1Password), три уровня локальной расшифровки звонков с требованиями к окружению и переменным, два варианта подключения к Claude Code через .mcp.json и раздел разработки с тестами и инспектором MCP. Лицензия MIT.

Частые вопросы

Может ли сервер читать расшифровки звонков из самого Битрикс24?

Нет, расшифровка звонков в интерфейсе Битрикс24 не отдается через REST API ни одним из методов, поэтому сервер скачивает запись и расшифровывает ее сам, локально.

Что нужно для максимального качества расшифровки?

Тяжелое Python-окружение с GigaAM, faster-whisper и pyannote.audio, ffmpeg в PATH и токен HuggingFace с принятыми условиями гейтированных моделей pyannote.

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483Звезды репозитория
Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий рискРоссийский стекБез VPN28Звезды репозитория
Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий рискРоссийский стекБез VPN
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий рискРоссийский стекБез VPN
Foxx AIMCP-сервер Bitrix24 с расшифровкой звонков

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.