Клиент REST Битрикс24 для разработчиков MCP
intelbit-bitrix24-client
Асинхронная Python-библиотека для REST API Битрикс24: батч-вызовы, пагинация и rate-limit, общая база для своих MCP-серверов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Дает произвольные вызовы REST API Битрикс24, включая методы записи, если их вызовет код на клиенте
- Права вызовов равны правам входящего вебхука, переданного в конструктор клиента
Установка
В терминале, через 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/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
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
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
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь 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, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything