MCP-сервер Битрикс24 на Cloudflare Workers

Bitrix24 MCP Server - Cloudflare Workers

Легкий сервер для компаний Битрикс24 на Cloudflare Workers с Hono: список, поиск, карточка, создание, изменение и удаление компаний через REST API

MCP-серверРоссийский стек

ibrahim-dvp/bitrix-mcp-cloudlfareАвтор:Ibrahim-dvp

Установка

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

npx skillfoxx add mcp/bitrix24-mcp-server-cloudflare-workers

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

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

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

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

claude mcp add --transport http bitrix24-mcp-cloudflare 'https://<значение BITRIX_WORKER_HOST>' --header 'Authorization: Bearer <ваш BITRIX_TOKEN>'

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

{
  "mcpServers": {
    "bitrix24-mcp-cloudflare": {
      "type": "http",
      "url": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

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

{
  "mcpServers": {
    "bitrix24-mcp-cloudflare": {
      "url": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

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

code --add-mcp '{"name":"bitrix24-mcp-cloudflare","type":"http","url":"https://<значение BITRIX_WORKER_HOST>","headers":{"Authorization":"Bearer <ваш BITRIX_TOKEN>"}}'

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

{
  "servers": {
    "bitrix24-mcp-cloudflare": {
      "type": "http",
      "url": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

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

[mcp_servers.bitrix24-mcp-cloudflare]
url = "https://<значение BITRIX_WORKER_HOST>"
http_headers = { Authorization = "Bearer <ваш BITRIX_TOKEN>" }

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

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

{
  "mcpServers": {
    "bitrix24-mcp-cloudflare": {
      "httpUrl": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

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

{
  "mcpServers": {
    "bitrix24-mcp-cloudflare": {
      "serverUrl": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "bitrix24-mcp-cloudflare": {
      "type": "streamableHttp",
      "url": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

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

{
  "mcpServers": {
    "bitrix24-mcp-cloudflare": {
      "type": "streamable-http",
      "url": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

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

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

{
  "mcp": {
    "bitrix24-mcp-cloudflare": {
      "type": "remote",
      "url": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

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

{
  "context_servers": {
    "bitrix24-mcp-cloudflare": {
      "url": "https://<значение BITRIX_WORKER_HOST>",
      "headers": {
        "Authorization": "Bearer <ваш BITRIX_TOKEN>"
      }
    }
  }
}

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

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

BITRIX_BASE_URLсекрет, обязательная: Base URL of Bitrix24 REST API
BITRIX_TOKENсекрет, обязательная: Bitrix24 webhook token
BITRIX_WORKER_HOSTобязательная: Host URL of deployed Cloudflare Worker

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

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

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

Разверни воркер командой wrangler deploy после задания секретов BITRIX_BASE_URL и BITRIX_TOKEN через wrangler secret put, затем вызывай его REST-эндпоинты вида POST /mcp/tools/bitrix_company_search с телом запроса, а не подключай его как стандартный MCP-сервер.

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

npm install && wrangler secret put BITRIX_BASE_URL && wrangler secret put BITRIX_TOKEN && npm run deploy

Развертывание в Cloudflare Workers: BITRIX_BASE_URL это адрес вебхука без токена, BITRIX_TOKEN его секретная часть.

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

Что делает

Проект разворачивается как воркер Cloudflare на фреймворке Hono и дает шесть операций с компаниями Битрикс24: список с пагинацией, карточка по id, поиск по названию, создание, изменение и удаление. Каждый запрос уходит на входящий вебхук портала. Сервер называет себя MCP, но реализует не протокол MCP JSON-RPC, а собственный REST API с эндпоинтами вида /mcp/tools и /mcp/tools/:toolName, который нужно вызывать напрямую или описывать агенту инструкцией. Пример конфигурации для Claude Desktop в README указывает на путь /mcp, которого в коде нет, так что прямое подключение как к стандартному MCP-серверу не сработает.

Для кого. Для тех, кто хочет бессерверный REST-эндпоинт для управления компаниями Битрикс24 на бесплатном тарифе Cloudflare Workers и готов подключать его вручную, а не как стандартный MCP-сервер.

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

Нужен бессерверный REST-эндпоинт для CRUD-операций с компаниями Битрикс24
Устраивает работа через собственный REST-формат, а не через стандартный MCP-протокол

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

Нужно прямое подключение как к стандартному MCP-серверу через JSON-RPC: протокол не реализован
Нужна работа с контактами, лидами или сделками: сервер поддерживает только компании

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

Найди компанию Acme в Битрикс24 через REST-эндпоинт воркера и обнови ей телефон

Ограничения

Несмотря на название, сервер не говорит на протоколе MCP JSON-RPC, а предоставляет собственный REST API с похожими на MCP названиями путей. Конфигурация для Claude Desktop из README ссылается на несуществующий путь /mcp и работать не будет. Поддерживаются только компании, без контактов, лидов и сделок. Авторизация запросов к самому воркеру не описана, доступ к нему нужно ограничивать на уровне Cloudflare. Автор один, звезд нет.

Как отключить. Удалите воркер из аккаунта Cloudflare командой wrangler delete или через панель Cloudflare.

MCP

Транспорт: http
Авторизация: не нужна

Переменные окружения
Переменные окружения
BITRIX_BASE_URL обязательная, секрет	Базовый URL входящего вебхука без токена, например https://портал.bitrix24.com/rest/12345
BITRIX_TOKEN обязательная, секрет	Секретный токен вебхука из его адреса

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

Инструменты создания, изменения и удаления компаний вызываются без подтверждения
Токен вебхука хранится как секрет Cloudflare Workers и дает права его создателя

Коротко о README

README подробно описывает развертывание на Cloudflare Workers: установку Wrangler, локальный запуск, задание секретов BITRIX_BASE_URL и BITRIX_TOKEN, таблицу из шести инструментов для компаний и примеры curl-запросов к каждому. Отдельно описана интеграция с Open WebUI и Claude Desktop, хотя путь для Claude Desktop в примере не совпадает с реализованными эндпоинтами.

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

Подключится ли сервер как обычный MCP в Claude Desktop?

Пример из README на это указывает, но в коде нет эндпоинта /mcp и обработчика JSON-RPC, так что прямое подключение по этой инструкции не заработает.

Какие сущности Битрикс24 поддерживаются?

Только компании: список, карточка, поиск, создание, изменение, удаление.

Salesforce DX MCP Server

Официальный

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

MCP-серверВысокий риск483

Скиллы Яндекс.Кит для управления магазином

kit-skills

Официальный

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

ПлагинВысокий рискРоссийский стекБез VPN28

YouGile MCP от Indalo

YouGile MCP

Выбор редакции

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

MCP-серверВысокий рискРоссийский стекБез VPN

MCP-сервер портала Битрикс24

Официальный

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

MCP-серверВысокий рискРоссийский стекБез VPN

Установка

Что делает

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

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

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

Ограничения

MCP

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

Коротко о README

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

Похожие

Salesforce DX MCP Server

Скиллы Яндекс.Кит для управления магазином

YouGile MCP от Indalo

MCP-сервер портала Битрикс24