MCP-сервер Битрикс24: задачи, CRM и списки

Bitrix24 Tasks, CRM & Lists MCP Server

Модульный MCP-сервер Битрикс24 на 46 инструментов: задачи и канбан, CRM-сделки и контакты, универсальные списки, работает в Docker без стороннего кеша

MCP-сервер

Высокий риск

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

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

  • Модуль CRM может создавать, изменять и комментировать сделки и контакты после подтверждения confirm=true
  • MCP_EXTRA_MODULES выполняет произвольный сторонний код с правами процесса сервера
Все причины и проверки
Российский стек

parallel-solutions/bitrix_mcp_free

Установка

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

npx skillfoxx add mcp/bitrix24-tasks-crm-lists-mcp-server

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

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

Собрано автоматически, проверьте перед установкой.

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

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

claude mcp add --transport stdio --env 'BITRIX_WEBHOOK_BASE=<ваш BITRIX_WEBHOOK_BASE>' bitrix24-mcp -- docker

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

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

code --add-mcp '{"name":"bitrix24-mcp","type":"stdio","command":"docker","args":[],"env":{"BITRIX_WEBHOOK_BASE":"<ваш BITRIX_WEBHOOK_BASE>"}}'

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

{
  "servers": {
    "bitrix24-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

codex mcp add bitrix24-mcp --env 'BITRIX_WEBHOOK_BASE=<ваш BITRIX_WEBHOOK_BASE>' -- docker

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

[mcp_servers.bitrix24-mcp]
command = "docker"
args = []
env = { BITRIX_WEBHOOK_BASE = "<ваш BITRIX_WEBHOOK_BASE>" }

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

gemini mcp add -s user -e 'BITRIX_WEBHOOK_BASE=<ваш BITRIX_WEBHOOK_BASE>' bitrix24-mcp docker

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

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

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

{
  "mcp": {
    "bitrix24-mcp": {
      "type": "local",
      "command": [
        "docker"
      ],
      "environment": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

{
  "context_servers": {
    "bitrix24-mcp": {
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

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

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "docker",
      "args": [],
      "env": {
        "BITRIX_WEBHOOK_BASE": "<ваш BITRIX_WEBHOOK_BASE>"
      }
    }
  }
}

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

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

BITRIX_WEBHOOK_BASEсекрет, обязательная
секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYнеобязательная
имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDнеобязательная
ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPнеобязательная
JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESнеобязательная
список id встроенных модулей через запятую
MCP_EXTRA_MODULESнеобязательная
сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLсекрет, необязательная
URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBнеобязательная
имя базы данных PostgreSQL
POSTGRES_USERнеобязательная
пользователь PostgreSQL
POSTGRES_PASSWORDсекрет, необязательная
пароль пользователя PostgreSQL
MCP_TRANSPORTнеобязательная
тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORTнеобязательная
порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLнеобязательная
внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEсекрет, необязательная
bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHсекрет, необязательная
bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSнеобязательная
время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSнеобязательная
время жизни refresh токена в секундах

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

Понадобится: Docker

Сверено с репозиторием 26 сент. 2026, коммит 49934bc.

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

Скопируй .env.example в .env, задай BITRIX_WEBHOOK_BASE, затем запусти docker compose build и docker compose run --rm -T mcp для запуска по stdio, либо используй готовый .mcp.json проекта для Cursor и Claude Desktop.

Другие способы из описания автора
docker compose build && docker compose run --rm -T mcp

Рекомендуемый способ запуска по stdio, перед этим задайте BITRIX_WEBHOOK_BASE в .env.

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

Что делает

Сервер устроен как ядро плюс три подключаемых модуля: задачи и проекты (26 инструментов на подключение, список, историю, чек-листы, канбан рабочих групп, спринты, учет времени), CRM (18 инструментов на сделки, контакты, пользователей и активности) и универсальные списки (2 инструмента для поиска и скачивания вложений в реестре переписки). Модули можно отключать через переменную MCP_ENABLED_MODULES или подключать свои, включая сторонние npm-пакеты вне репозитория. Каждый пишущий вызов требует явного параметра confirm=true, а универсального REST-инструмента без ограничений нет: каждый инструмент валидирует и ограничивает свой набор полей отдельно. По умолчанию сервер работает по stdio через Docker с одним общим вебхуком без базы данных; опционально поднимается второй HTTP-транспорт с мультиаккаунтным OAuth-логином и PostgreSQL только для таблицы аккаунтов.

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

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

  • Нужны и задачи с канбаном и спринтами, и CRM в одном сервере, без разных серверов на разные сущности
  • Важно, чтобы каждая запись явно требовала confirm=true
  • Нужен мультиаккаунтный удаленный доступ через OAuth для нескольких пользователей claude.ai

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

  • Нужен универсальный REST-инструмент без ограничения полей: в проекте его намеренно нет
  • Нет Docker: базовый запуск через npm возможен, но READMEоориентирован на контейнер

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

Покажи открытые сделки моей воронки и перенеси задачу 318 в колонку Готово на канбане проекта

Ограничения

Мультиаккаунтный HTTP-транспорт хранит OAuth-клиентов и токены в памяти процесса и не переживает рестарт контейнера, хотя сами аккаунты сохраняются в PostgreSQL. Роль аккаунта это описательное поле, само по себе оно ничего не ограничивает. Нужен Docker Engine с Compose v2 для рекомендуемого способа запуска. Интеграционные тесты на реальном портале включаются отдельной переменной и по умолчанию выключены. Проект совсем новый, автор один, звезд нет.

Как отключить. Остановите docker compose и удалите сервер из .mcp.json или конфигурации MCP клиента.

MCP

Транспорт
stdio, http
Авторизация
OAuth
Переменные окружения
Переменные окружения
BITRIX_WEBHOOK_BASE
обязательная, секрет
Секретный адрес входящего вебхука вида https://portal.example.ru/rest/123/token
MCP_ENABLED_MODULES
Список встроенных модулей через запятую: tasks, crm, lists, по умолчанию все
MCP_EXTRA_MODULES
Сторонние npm-пакеты или пути к файлам с собственными модулями, выполняют произвольный код
MCP_TRANSPORT
stdio по умолчанию или http для сервиса mcp-http
DATABASE_URL
секрет
Строка подключения PostgreSQL, нужна только для мультиаккаунтного HTTP-транспорта

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

  • Модуль CRM может создавать, изменять и комментировать сделки и контакты после подтверждения confirm=true
  • MCP_EXTRA_MODULES выполняет произвольный сторонний код с правами процесса сервера

Коротко о README

README на русском подробно описывает архитектуру ядра с подключаемыми модулями, схему без стороннего кеша данных, запуск в Docker по stdio и опциональный HTTP-транспорт с мультиаккаунтным OAuth поверх PostgreSQL, полный список переменных окружения, разбивку 46 инструментов по трем модулям и раздел тестов и качества с typecheck, lint и интеграционными проверками на реальном портале.

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

Нужна ли база данных для обычного запуска?

Нет, PostgreSQL нужен только для мультиаккаунтного HTTP-транспорта, обычный stdio-запуск с одним вебхуком работает без базы вообще.

Можно ли отключить часть инструментов?

Да, через переменную MCP_ENABLED_MODULES можно оставить только нужные модули, например только tasks, или отключить все встроенные и подключить свой через MCP_EXTRA_MODULES.

Официальный

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

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

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

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

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

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

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

MCP-серверВысокий рискРоссийский стекБез VPN
Foxx AIMCP-сервер Битрикс24: задачи, CRM и списки

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