mcpField
B
bitrix24-mcp

bitrix24-mcp

Local
github.comBusiness & Marketing0Updated 4w ago
RepositoryVisit website

About bitrix24-mcp

bitrix24-mcp connects Bitrix24 Cloud with Claude Desktop and other MCP clients, exposing tools for CRM, tasks, users, messaging, and calendars. It includes safeguards such as confirmation for destructive actions, rate limits, audit logs, and secure credential storage.

Key features

  1. 01Covers CRM, tasks, users, and calendars
  2. 02Supports messaging and sales conversations
  3. 03Validates inputs and rate-limits calls
  4. 04Requires confirmation for destructive actions
  5. 05Stores credentials in the OS keychain
  6. 06Keeps an audit log of tool calls

Use cases

  1. 01Query and update CRM records through conversation
  2. 02Create tasks and follow up on deals
  3. 03Summarize sales calls and customer conversations
  4. 04Audit and manage AI access to CRM

MCP support

It connects Bitrix24 Cloud to MCP clients and exposes tools for CRM, tasks, users, messaging, and calendars.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "rcs-kz-bitrix24": {
      "command": "npx",
      "args": [
        "-y",
        "@rcs-kz/bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<BITRIX24_WEBHOOK_URL>",
        "RCS_LICENSE_KEY": "<RCS_LICENSE_KEY>"
      }
    }
  }
}
Run commandnpx -y @rcs-kz/bitrix24-mcp
Environment variables to set
BITRIX24_WEBHOOK_URLSecretInbound webhook URL of your Bitrix24 portal (https://<portal>.bitrix24.kz/rest/<user_id>/<token>/). Stored in the OS keychain on first run; this env var is a fallback for CI / containerised / headless deployments.
RCS_LICENSE_KEYSecretCommercial license key issued after the 14-day trial. Stored in the OS keychain on first run; env var fallback only needed for CI / headless deployments.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@rcs-kz/bitrix24-mcp1.0.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

bitrix24-mcp

Production-grade MCP server for Bitrix24 Cloud — 55 tools, safe by default.

Профессиональный MCP-сервер для Bitrix24 — 55 инструментов, безопасно по умолчанию.

Русский · English · Install · Docs · Buy

This repository is the public front of a commercial product. It contains the README you're reading, install guides, changelogs, the published threat model, and our security-disclosure policy. Source code is proprietary and ships as a signed V8-bytecode bundle through the channels listed under Install. See NOTICE.md for the rationale.

🇷🇺 Русский

Что это

bitrix24-mcp — сервер Model Context Protocol, подключающий Claude Desktop к вашему облачному Bitrix24. Один раз устанавливаете, авторизуете через входящий вебхук Bitrix24 (или OAuth-приложение Bitrix24.Market) — Claude получает 55 инструментов по CRM (контакты, компании, сделки, лиды, товары), Задачам, Пользователям, Мессенджеру и Календарю.

Дальше Claude делает то, что умеет лучше всего — рассуждает над неструктурированными запросами вроде «покажи все сделки больше 50 млн ₸ с просроченной датой закрытия в этом квартале, самые крупные три — отправь email менеджерам и поставь задачу на follow-up» — и вызывает REST API Bitrix24 от вашего имени, с вашим подтверждением.

Почему это существует

Типовые «ИИ-интеграции с CRM» оптимизируют под демо. Мы оптимизируем под тот вечер, когда вы показали это CEO и он сказал «отлично, теперь запусти на реальном tenant'е». Именно здесь rate-лимиты, аудит-логи, обработка ошибок записи и гигиена токенов решают, останется продукт в вашем стеке или нет.

Что внутри

55 инструментов — каждый:

  • Типобезопасен — аргументы валидируются через Zod против строгой JSON-схемы до отправки REST-запроса. Некорректный ввод падает локально с понятной ошибкой, а не мусорным ответом API.
  • Confirm-gated по умолчанию — деструктивные инструменты (*_delete, *_update с массовыми селекторами) декларируют destructive: true в манифесте. Claude Desktop показывает диалог подтверждения.
  • Ограничен по частоте — per-tenant, per-user, per-tool. Массовые операции становятся в очередь с backpressure, а не DDoS-ят ваш Bitrix24.
  • Записывается в аудит-лог — каждый вызов — JSON-строка в ~/.bitrix24-mcp/audit.log (timestamp, инструмент, пользователь, rate-limit remaining, длительность, результат). Локально, права -rw-------.

Покрытие: CRM (контакты / компании / сделки / лиды / товары / активности + cross-type поиск), Задачи (create / assign / stage / comment / attach / time-log), Пользователи (list / get / by-department), IM (chat / DM / recent), Календарь (list / CRUD / respond). Полный справочник — docs/TOOLS.md на landing'е после установки.

Безопасность
  • Webhook / OAuth токены — в keychain ОС (macOS Keychain, Windows Credential Manager, Linux libsecret через keytar). Никогда в конфиг-файле, env или логах.
  • Zero telemetry. Не собираем метрики использования, stack traces, call patterns. Отключать нечего — ничего и не собирается.
  • Декларированный egress. Два хоста видны firewall: *.bitrix24.kz / *.bitrix24.ru / *.bitrix24.com (ваш tenant) и license.rcs.kz (валидация лицензии раз в 24 ч, fail-open после 14-дневного grace).
  • Целостность бандла. Продакшен-бандл — V8-bytecode с SHA-256 fingerprint'ом, проверяемым из 5 независимых check-points. Попытка модификации даёт явный fail.
  • Лицензии на ECDSA P-256. Подпись над tenant-scoped bundle hash + expiry. Украденная лицензия не переносится на другой tenant, срок без приватного ключа RCS не продлевается.

Модель угроз и 10-attack harness — docs/threat-model.md (synced с tests/phase4-7/ATTACK-REPORT.md каждый релиз).

Для кого
  • Клиенты Bitrix24 на Claude Pro / Team / Enterprise, которым надоело переключаться между чатом Claude и CRM.
  • Клиенты RCS (1С:франчайзинг Казахстан) — единый поставщик автоматизаций Bitrix24 поверх уже работающих интеграций 1С.
  • IT / Ops команды, которым нужно согласовать AI-CRM интеграцию и получить внятные ответы про хранение токенов, аудит и rate-лимиты.
Чем это НЕ является
  • Не чат-виджет в Bitrix24. Claude живёт в Claude Desktop (или любом MCP-совместимом клиенте).
  • Не no-code автоматизация. Для визуальных workflow — встроенные автоматизации Bitrix24.
  • Не поддерживает on-premise (коробочный) Bitrix24. Только облако. On-prem — в roadmap, без ETA.
  • Не бесплатный продукт. Мы берём деньги, потому что обновляемся, ведём поддержку и реагируем на изменения REST API Bitrix24 в течение недели. Заброшенный бесплатный инструмент хуже, чем никакой.
Контроль отдела продаж, а не только доступ к CRM

Типовые ИИ-интеграции с Bitrix24 видят карточки и сделки — и на этом заканчиваются. Разговоры с клиентами остаются за кадром: звонки в телефонии, переписка в открытых линиях, заметки менеджеров в таймлайне. А ответ на вопрос «почему сделка не закрылась» живёт именно там.

  • Звонки — сколько сделал и принял каждый менеджер, сколько пропустил, длительность, ссылка на запись разговора.
  • Открытые линии — WhatsApp, Telegram, чат на сайте: переписка с клиентом целиком и время первого ответа.
  • Заметки в CRM — что менеджеры писали по проблемным сделкам, а не только что записано в полях.
  • Отчёт руководителю — собрать сводку и отправить её прямо в чат Bitrix24, а не выгружать в файл.
  • Всё это обычными словами, без конструктора отчётов и без разработки.

Для такого доступа нужны права imopenlines и telephony на стороне портала. Коробочные решения их не запрашивают — поэтому и упираются в потолок на первом же реальном сценарии контроля менеджеров.

Цена
ТарифЦенаЧто входит
Пробный периодпо заявкеВсе 55 инструментов · без карты · бесплатного тарифа нет
Оплата помесячно29 900 ₸ / месС НДС, по договору

Подключить: оставить заявку на rcs.kz — пришлём файл .mcpb и ключ на пробный период, после пробного периода — договор и оплата помесячно. Подробно — rcs.kz/product/mcp-bitrix24.

Внутри тарифа — неограниченное число сотрудников портала. Обновления в рамках текущей мажорной версии включены. Поддержка: [email protected], ответ в течение рабочего дня (Алматы, UTC+5).

Требования
  • Claude Desktop 0.8.0+ (или любой MCP-совместимый клиент)
  • macOS 13+, Windows 10+, либо Linux с libsecret
  • Bitrix24 Cloud tenant с правами администратора (для создания входящего вебхука)
  • Node.js 20 LTS или 22 LTS (только для ручной npm-установки, путь для продвинутых)
Установка

Рекомендуется: получить .mcpb-бандл по заявке на rcs.kz и установить в Claude Desktop одним кликом. Пошаговая инструкция — docs/install/claude-desktop.md.

Бандл самодостаточен: один файл, ставить Node.js и зависимости не нужно, один и тот же артефакт работает на macOS, Windows и Linux. Ссылку вебхука и лицензионный ключ Claude Desktop спрашивает формой — править claude_desktop_config.json руками не требуется.

Про npm. В реестре сейчас лежит сборка предыдущего поколения — без инструментов по телефонии и открытым линиям. Публикация 2.1.0 готовится; до неё ставьте .mcpb.

Поддержка и SLA
  • Ответ в течение 1 рабочего дня (Пн–Пт, 09:00–18:00 Asia/Almaty, UTC+5).
  • Патч-релизы в течение 5 рабочих дней после воспроизведения бага.
  • Безопасность: [email protected] + PGP-ключ опубликован в SECURITY.md. Ответ в течение 24 часов, фикс в 7 дней, кредит репортеру (если не просил иное).
Вендор

RCS (ИП КВАНТ, ИИН 871228350772, г. Астана) — партнёр фирмы «1С» в Казахстане с 2009 года, франчайзи 62997-KZ.

🇬🇧 English

What it is

bitrix24-mcp is a Model Context Protocol server that connects Claude Desktop to a Bitrix24 Cloud tenant. Install once, authorise against a Bitrix24 inbound webhook (or Bitrix24.Market OAuth app) — Claude gains 55 tools spanning CRM (contacts, companies, deals, leads, products), Tasks, Users, Instant Messaging, and Calendar.

Claude then does what Claude does best — reasoning over unstructured requests like "Summarise every deal over 50 M KZT that slipped its close date this quarter, email the three biggest to the account owner, and create a follow-up task for each" — and calls the Bitrix24 REST API on your behalf, with your approval.

Why it exists

Generic "connect AI to CRM" tools optimise for demo-ability. We optimise for the evening after the demo, when rate limits, audit trails, failed-write recovery, and auth-token hygiene decide whether the product stays in your stack.

What's in the box

55 tools, all of them:

  • Type-safe — every argument validated with Zod against a strict JSON schema before the REST call leaves the machine.
  • Confirm-gated by default — destructive tools (*_delete, *_update with mass-selectors) declare destructive: true in the manifest. Compliant clients surface a confirmation dialog.
  • Rate-limited — per-tenant, per-user, per-tool. Bulk imports queue with backpressure instead of DDoS-ing your own Bitrix24.
  • Audit-logged — every call writes a JSON line to ~/.bitrix24-mcp/audit.log with timestamp, tool, caller, rate-limit remaining, duration, result. User-readable only.

Coverage: CRM (contacts, companies, deals, leads, products, activities + cross-type search), Tasks (create, assign, move stages, comment, attach files, log time), Users (list, get, by-department), IM (chat, DM, recent), Calendar (list, CRUD, respond). Exhaustive reference: docs/TOOLS.md on the landing page after install.

Security posture
  • Webhook URL / OAuth tokens in the OS keychain (Keychain / Credential Manager / libsecret via keytar). Never in a config file, never in env vars, never echoed in logs.
  • No telemetry. We do not collect usage metrics, crash reports, or tool-call patterns.
  • Declared network egress. Two hosts, both visible to your firewall: *.bitrix24.{kz,ru,com} (your tenant) and license.rcs.kz (24 h license check, fail-open after a 14-day grace period).
  • Bundle integrity. Production bundle ships as V8 bytecode with SHA-256 fingerprint verified at load time from five independent check-sites.
  • ECDSA-signed licenses. P-256 signature over tenant-scoped bundle hash + expiry. Leaked licenses cannot be retargeted to another tenant.

Full threat model and 10-attack harness: docs/threat-model.md.

Who it's for
  • Bitrix24 customers on Claude Pro / Team / Enterprise who want to stop context-switching between the chat window and the CRM.
  • RCS clients (existing 1С franchise portfolio in Kazakhstan) who want a single trusted vendor for Bitrix24 automation on top of their existing 1С integrations.
  • Ops / IT teams who need to approve an AI-CRM integration and will ask pointed questions about token storage, audit, and rate limiting.
What it is not
  • Not a chat widget embedded inside Bitrix24. Claude lives in Claude Desktop (or any MCP-compatible client).
  • Not a no-code automation tool.
  • Not an on-premise Bitrix24 connector. Cloud tenants only.
  • Not a free tool.
Sales-floor oversight, not just CRM access

Most AI integrations for Bitrix24 can see records and deals, and stop there. The conversations stay invisible: telephony calls, open-line chats with clients, the notes reps leave on a timeline. That is where the answer to "why did this deal stall" actually lives.

  • Calls — how many each rep placed and answered, how many were missed, duration, link to the recording.
  • Open lines — WhatsApp, Telegram, site widget: the full client conversation and time-to-first-response.
  • CRM notes — what reps wrote about stalled deals, not just what the fields say.
  • Report to the head of sales — assemble the digest and post it straight into a Bitrix24 chat.
  • All of it in plain language, with no report builder and no development work.

This requires the imopenlines and telephony scopes on the portal side. Off-the-shelf connectors do not request them — which is why they hit a ceiling on the first real manager-performance scenario.

Pricing
TierPriceWhat you get
Trial periodon requestAll 55 tools · no credit card · there is no free plan
Monthly29 900 ₸/moVAT included, under contract

Get started: request access on rcs.kz — we send the .mcpb bundle and a trial key; after the trial period — a contract and monthly billing. Details: rcs.kz/product/mcp-bitrix24.

Links

License

This repository is licensed under CC BY-ND 4.0 (documentation) — see LICENSE. The software itself (the npm package, .mcpb bundle, and all related artifacts) is governed by the Terms of Service; source is proprietary.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.