bitrix24-mcp
Компактный MCP-сервер для Битрикс24: пользователи, задачи, сообщения и CRM-элементы через один вебхук и запуск uvx
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты создают и удаляют элементы CRM и задачи
- bitrix_call допускает вызов любого метода API, не только безопасного для чтения
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/averagedigital-bitrix-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' bitrix24 -- uvx bitrix24-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "uvx",
"args": [
"bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "uvx",
"args": [
"bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"bitrix24","type":"stdio","command":"uvx","args":["bitrix24-mcp"],"env":{"BITRIX24_WEBHOOK_URL":"<ваш BITRIX24_WEBHOOK_URL>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"bitrix24": {
"type": "stdio",
"command": "uvx",
"args": [
"bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add bitrix24 --env 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' -- uvx bitrix24-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.bitrix24]
command = "uvx"
args = ["bitrix24-mcp"]
env = { BITRIX24_WEBHOOK_URL = "<ваш BITRIX24_WEBHOOK_URL>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' bitrix24 uvx bitrix24-mcpИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "uvx",
"args": [
"bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "uvx",
"args": [
"bitrix24-mcp"
],
"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": "uvx",
"args": [
"bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "uvx",
"args": [
"bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"bitrix24": {
"type": "local",
"command": [
"uvx",
"bitrix24-mcp"
],
"environment": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"bitrix24": {
"command": "uvx",
"args": [
"bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "uvx",
"args": [
"bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь MCP-сервер командой uvx bitrix24-mcp с переменной окружения BITRIX24_WEBHOOK_URL, указывающей на входящий вебхук твоего портала Битрикс24.
Другие способы из описания автора
uvx bitrix24-mcpЗапуск пакета из PyPI без установки, нужна переменная BITRIX24_WEBHOOK_URL.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает REST API Битрикс24 в двенадцать инструментов: произвольный вызов метода, текущий пользователь, список пользователей и отделов, список задач с фильтром по статусу, создание задачи с дедлайном, отправка сообщения в чат и универсальный CRUD для CRM-элементов нового формата (crm.item) по entityTypeId. Пакет опубликован в PyPI как bitrix24-mcp и запускается одной командой uvx без предварительной установки, конфигурация только через переменную окружения с адресом вебхука.
Для кого. Для разработчиков, которым нужен небольшой универсальный клиент Битрикс24 без лишних абстракций поверх REST.
Подходит, если
- Нужен быстрый старт без клонирования репозитория: uvx bitrix24-mcp
- Нужен универсальный доступ к новым CRM-сущностям (crm.item) по типу
- Достаточно прямого вызова bitrix_call для методов, которых нет в готовом наборе
Не подходит, если
- Нужны специализированные инструменты для классических лидов, сделок или контактов: сервер работает только с CRM-элементами нового типа crm.item
- Нужны диск, звонки или бизнес-процессы: их тут нет
Пример запроса к агенту
Создай задачу «Подготовить отчет» с дедлайном через три дня и покажи список активных сотрудниковОграничения
README не приводит полный список инструментов, только установку и запуск. CRM-инструменты работают через crm.item и требуют знать entityTypeId нужной сущности. Нет обработки rate limit и повторов при ошибках Битрикс24.
Как отключить. Удалите блок bitrix24 из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BITRIX24_WEBHOOK_URL обязательная, секрет | Адрес входящего вебхука Битрикс24 |
Проверка безопасности
- Инструменты создают и удаляют элементы CRM и задачи
- bitrix_call допускает вызов любого метода API, не только безопасного для чтения
Коротко о README
Короткий README на русском: требования Python 3.10+, установка через venv и pip install -r requirements.txt, переменная BITRIX24_WEBHOOK_URL, запуск python -m bitrix24_mcp.server и фрагмент конфигурации MCP-клиента с uvx bitrix24-mcp. Список инструментов в README не приводится, но виден в исходниках пакета.
Частые вопросы
Нужно ли клонировать репозиторий?
Нет, пакет опубликован в PyPI и запускается командой uvx bitrix24-mcp.
Как обратиться к методу, для которого нет отдельного инструмента?
Через bitrix_call с именем метода Битрикс24 и параметрами в JSON.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма