MCP-сервер Битрикс24: задачи, CRM и списки
Bitrix24 Tasks, CRM & Lists MCP Server
Модульный MCP-сервер Битрикс24 на 46 инструментов: задачи и канбан, CRM-сделки и контакты, универсальные списки, работает в Docker без стороннего кеша
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Модуль CRM может создавать, изменять и комментировать сделки и контакты после подтверждения confirm=true
- MCP_EXTRA_MODULES выполняет произвольный сторонний код с правами процесса сервера
Установка
В терминале, через 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 токена в секундах
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Скопируй .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 из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма