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

intelbit-bitrix24-client

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

  • 0 ★ репозитория
  • Последний коммит
  • Apache-2.0
MCP-сервер

Расширенный доступ

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

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

svyatoslavmikhailov/intelbit-bitrix24-client

Установка

Работает в
Сервисы

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

npx skillfoxx add mcp/intelbit-bitrix24-client

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

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

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

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

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

Что делает

Это не готовый 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

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

Ограничения

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

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

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

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

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

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

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

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию

MCP-серверШирокий доступ3Звезды репозитория
Российский стек

MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала

MCP-серверШирокий доступ1Звезды репозитория
Российский стек

PHP-шлюз и MCP-сервер Битрикс24 на библиотеке CRest: чтение CRM и задач, ответы в чатах и Открытых линиях для агента OpenClaw

MCP-серверШирокий доступ
Официальный

Официальный удаленный MCP-сервер Битрикс24: агент ищет методы, параметры и события REST API в актуальной документации

MCP-серверРасширенный доступ7Звезды репозитория
Российский стек

Общий MCP-сервер Битрикс24 для всей компании: каждый сотрудник входит через свой OAuth, и все действия агента отмечены его собственным пользователем

MCP-серверРасширенный доступ

Коротко о README

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

Бейдж для README

Сообщить о проблеме