Клиент REST Битрикс24 для разработчиков MCP

intelbit-bitrix24-client

Асинхронная Python-библиотека для REST API Битрикс24: батч-вызовы, пагинация и rate-limit, общая база для своих MCP-серверов

MCP-сервер

Средний риск

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

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

  • Дает произвольные вызовы REST API Битрикс24, включая методы записи, если их вызовет код на клиенте
  • Права вызовов равны правам входящего вебхука, переданного в конструктор клиента
Все причины и проверки
Российский стек

svyatoslavmikhailov/intelbit-bitrix24-client

Установка

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

npx skillfoxx add mcp/intelbit-bitrix24-client

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

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

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

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

claude mcp add --transport http intelbit-bitrix24-client 'https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/'

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

{
  "mcpServers": {
    "intelbit-bitrix24-client": {
      "type": "http",
      "url": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

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

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

{
  "mcpServers": {
    "intelbit-bitrix24-client": {
      "url": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

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

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

code --add-mcp '{"name":"intelbit-bitrix24-client","type":"http","url":"https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"}'

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

{
  "servers": {
    "intelbit-bitrix24-client": {
      "type": "http",
      "url": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

codex mcp add intelbit-bitrix24-client --url 'https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/'

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

[mcp_servers.intelbit-bitrix24-client]
url = "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

gemini mcp add -s user -t http intelbit-bitrix24-client 'https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/'

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

{
  "mcpServers": {
    "intelbit-bitrix24-client": {
      "httpUrl": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

{
  "mcpServers": {
    "intelbit-bitrix24-client": {
      "serverUrl": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "intelbit-bitrix24-client": {
      "type": "streamableHttp",
      "url": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

{
  "mcpServers": {
    "intelbit-bitrix24-client": {
      "type": "streamable-http",
      "url": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

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

{
  "mcp": {
    "intelbit-bitrix24-client": {
      "type": "remote",
      "url": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

{
  "context_servers": {
    "intelbit-bitrix24-client": {
      "url": "https://<значение PORTAL>/rest/<значение USER_ID>/<ваш TOKEN>/"
    }
  }
}

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

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

PORTALобязательная
Bitrix24 portal URL
USER_IDобязательная
User ID in webhook URL
TOKENсекрет, обязательная
Token in webhook URL

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

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

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

Добавь intelbit-bitrix24-client в зависимости своего Python-проекта, установи через uv sync и импортируй Bitrix24Client с URL входящего вебхука для вызова методов Битрикс24.

Другие способы из описания автора
uv sync --extra dev

Установка зависимостей проекта через uv, библиотека импортируется как intelbit_bitrix24_client.

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

Что делает

Это не готовый MCP-сервер, а чистый асинхронный клиент REST API Битрикс24 на httpx, из которого его авторы (студия Интелбит) собирают два своих проекта: MCP-сервер Битрикс24 и Река-коннектор. Клиент дает единичные вызовы методов с разбором конверта ответа {result, total, next}, потоковую пагинацию через list_all с поддержкой как старых методов (start/next/total), так и новых catalog.* с оберткой списка по result_key, и батч до 50 команд одним запросом. Авторизация зашита в URL входящего вебхука, соединения не держатся между вызовами, а при ошибке QUERY_LIMIT_EXCEEDED клиент делает экспоненциальный backoff и повтор через rate-limiter. Библиотека не включает Dadata, лидогенерацию или обвязку FastAPI, только сам REST-клиент.

Для кого. Для разработчиков, которые пишут собственный MCP-сервер или интеграцию с Битрикс24 на Python и не хотят заново писать батчи, пагинацию и rate-limit.

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

  • Пишете собственный MCP-сервер или скрипт для Битрикс24 на Python и async
  • Нужна готовая пагинация по старым и новым (catalog.*) методам REST API
  • Нужен устойчивый к лимитам батч-клиент вместо ручных повторов запросов

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

  • Нужен готовый к использованию MCP-сервер с инструментами «из коробки»: это только клиентская библиотека без слоя MCP
  • Нужны лидогенерация, Dadata или веб-обвязка на FastAPI: их в библиотеке нет намеренно

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

Напиши на этом клиенте функцию, которая постранично выгружает все компании CRM с полями ID и TITLE

Ограничения

Это библиотека-фундамент, а не самостоятельный агентский инструмент: нет ни MCP-протокола, ни CLI, ни SKILL.md, только Python-класс клиента для импорта в свой код. Управление зависимостями через uv, установка отдельным пакетом не описана. Код извлечен из внутреннего проекта bitrix24-mcp студии Интелбит, держателем прав и CLA указана сама студия.

Как отключить. Удалите зависимость intelbit-bitrix24-client из своего проекта.

MCP

Транспорт
stdio
Авторизация
API-ключ

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

  • Дает произвольные вызовы REST API Битрикс24, включая методы записи, если их вызовет код на клиенте
  • Права вызовов равны правам входящего вебхука, переданного в конструктор клиента

Коротко о README

README описывает библиотеку как общий async-клиент REST API Битрикс24 для двух внутренних проектов студии Интелбит, дает установку через uv sync, примеры одиночного вызова, потоковой пагинации по старым и новым методам и батч-вызова, поясняет контракт (авторизация в URL вебхука, соединения не держатся, backoff при лимитах) и раздел «Происхождение» о том, что код извлечен из bitrix24-mcp и переиздан под Apache 2.0 правомерно, так как Интелбит держит CLA.

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

Это готовый MCP-сервер?

Нет, это только клиентская библиотека REST API, на которой авторы строят свой MCP-сервер и Река-коннектор отдельно.

Как клиент справляется с лимитами Битрикс24?

При ошибке QUERY_LIMIT_EXCEEDED делает экспоненциальный backoff и повтор через встроенный rate-limiter.

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

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.Звезды репозитория
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.Звезды репозитория
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.Звезды репозитория

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.Звезды репозитория
Foxx AIКлиент REST Битрикс24 для разработчиков MCP

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