Bitrix24 MCP
MCP-сервер Битрикс24 на входящем вебхуке: сделки, контакты, задачи, сотрудники, диск и чат в 12 инструментах
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает и меняет сделки, контакты и задачи в реальном портале
- Отправляет сообщения сотрудникам от имени пользователя вебхука
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/bitrix24-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' bitrix24 -- npx -y @theyahia/bitrix24-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@theyahia/bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@theyahia/bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"bitrix24","type":"stdio","command":"npx","args":["-y","@theyahia/bitrix24-mcp"],"env":{"BITRIX24_WEBHOOK_URL":"<ваш BITRIX24_WEBHOOK_URL>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"bitrix24": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add bitrix24 --env 'BITRIX24_WEBHOOK_URL=<ваш BITRIX24_WEBHOOK_URL>' -- npx -y @theyahia/bitrix24-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.bitrix24]
command = "npx"
args = ["-y", "@theyahia/bitrix24-mcp"]
env = { BITRIX24_WEBHOOK_URL = "<ваш BITRIX24_WEBHOOK_URL>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@theyahia/bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@theyahia/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": "npx",
"args": [
"-y",
"@theyahia/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": "npx",
"args": [
"-y",
"@theyahia/bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"bitrix24": {
"type": "local",
"command": [
"npx",
"-y",
"@theyahia/bitrix24-mcp"
],
"environment": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@theyahia/bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@theyahia/bitrix24-mcp"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<ваш BITRIX24_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX24_WEBHOOK_URLсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Создай в Битрикс24 входящий вебхук с правами crm, task, user, disk, im, затем добавь сервер командой claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=<url вебхука> -- npx -y @theyahia/bitrix24-mcp.
Другие способы из описания автора
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": ["-y", "@theyahia/bitrix24-mcp"],
"env": {
"BITRIX24_WEBHOOK_URL": "https://your-company.bitrix24.ru/rest/1/your-webhook-key/"
}
}
}
}Конфигурация из README для Claude Desktop.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к Битрикс24 через входящий вебхук и дает агенту 12 инструментов: список и карточку сделки, создание и обновление сделки, список и создание контактов, список задач с фильтрами, создание задачи, завершение задачи, список сотрудников с фильтрами по активности и отделу, загрузку файла на Диск и отправку сообщения сотруднику или в группу. OAuth-приложение не требуется, программирование на стороне Битрикс24 тоже. Часть серии MCP-серверов WWmcp того же автора.
Для кого. Для менеджеров по продажам и разработчиков, которым нужен быстрый доступ к CRM Битрикс24 из чата с агентом без настройки OAuth.
Подходит, если
- Нужно быстро создать сделку, контакт или задачу из диалога с агентом
- Нужно посмотреть открытые сделки или задачи сотрудника без входа в Битрикс24
- Нужно отправить сообщение сотруднику или в группу прямо из агента
Не подходит, если
- Нужны лиды, компании, воронки или бизнес-процессы: инструментов для них нет
- Нужна мультипортальная работа с OAuth и ротацией токенов вместо одного вебхука
Пример запроса к агенту
Покажи все открытые сделки в Битрикс24 и поставь задачу сотруднику 5 подготовить презентацию к завтрашнему днюОграничения
Покрывает только сделки, контакты, задачи, сотрудников, диск и сообщения, без лидов, компаний и бизнес-процессов. Вебхук хранит секретный ключ прямо в URL и дает права, заданные при его создании. Автор проекта распространяет тот же код в монорепозитории theyahia/wwmcp, дублей в каталоге нет.
Как отключить. Удалите сервер из конфигурации MCP-клиента, например claude mcp remove bitrix24 в Claude Code, и отзовите вебхук в настройках портала.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BITRIX24_WEBHOOK_URL обязательная, секрет | Полный URL входящего вебхука Битрикс24 вместе с ключом авторизации |
Проверка безопасности
- Создает и меняет сделки, контакты и задачи в реальном портале
- Отправляет сообщения сотрудникам от имени пользователя вебхука
Коротко о README
README на русском объясняет настройку через входящий вебхук с правами crm, task, user, disk, im, дает конфигурацию для Claude Desktop и команду для Claude Code, таблицу всех 12 инструментов и демо-промпты на русском языке. Указана единственная обязательная переменная окружения BITRIX24_WEBHOOK_URL. Лицензия MIT, проект входит в серию WWmcp.
Частые вопросы
Нужен ли OAuth?
Нет, сервер работает через входящий вебхук с нужными правами, без OAuth-приложения.
Сколько инструментов доступно?
12: сделки, контакты, задачи, сотрудники, файлы на Диске и сообщения.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма