mcpField
B
bitrix24-mcp

bitrix24-mcp

本地服务
github.com商业与营销04 周前更新
代码仓库访问官网

关于 bitrix24-mcp

bitrix24-mcp 是连接 Bitrix24 Cloud 与 Claude Desktop 等 MCP 客户端的服务器，提供覆盖 CRM、任务、用户、即时消息和日历的工具。它包含破坏性操作确认、调用限流、审计日志和凭据安全存储机制。

主要功能

  1. 01覆盖 CRM、任务、用户及日历
  2. 02支持即时消息与销售沟通记录
  3. 03调用前验证参数并限制频率
  4. 04破坏性操作默认要求确认
  5. 05将凭据存入操作系统密钥链
  6. 06记录工具调用审计日志

适用场景

  1. 01通过对话查询并更新 CRM 记录
  2. 02创建任务并跟进交易
  3. 03汇总销售通话与客户沟通
  4. 04审计并管理 AI 对 CRM 的访问

MCP 相关

连接 Bitrix24 Cloud 与 MCP 客户端，提供 CRM、任务、用户、即时消息和日历工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "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>"
      }
    }
  }
}
启动命令npx -y @rcs-kz/bitrix24-mcp
需要配置的环境变量
BITRIX24_WEBHOOK_URL密钥Inbound 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_KEY密钥Commercial 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.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@rcs-kz/bitrix24-mcp1.0.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

bitrix24-mcp

面向 Bitrix24 Cloud 的生产级 MCP 服务——55 个工具，默认安全。

面向 Bitrix24 的专业 MCP 服务——55 个工具，默认安全。

俄语 · 英语 · 安装 · 文档 · 购买

此仓库是商业产品的公开入口。 其中包含你正在阅读的 README、安装指南、更新日志、已发布的威胁模型以及我们的安全漏洞披露政策。源代码为专有代码，并通过 安装 中列出的渠道以签名 V8 字节码包的形式发布。有关原因，请参阅 NOTICE.md。

🇷🇺 俄语

这是什么

bitrix24-mcp 是一款 Model Context Protocol 服务，可将 Claude Desktop 连接到你的云端 Bitrix24。只需安装一次，通过 Bitrix24 入站 Webhook（或 Bitrix24.Market OAuth 应用）完成授权，Claude 就能使用 CRM（联系人、公司、交易、潜在客户、商品）、任务、用户、即时通讯和日历的 55 个工具。

接下来，Claude 会发挥它最擅长的能力——推理那些非结构化请求，例如“显示本季度所有金额超过 5,000 万 ₸ 且逾期未结的交易，将金额最高的三笔交易通过电子邮件发送给经理，并创建一项跟进任务”——然后在征得你确认后，以你的名义调用 Bitrix24 REST API。

为什么会有这个项目

典型的“CRM AI 集成”都针对演示场景进行优化。我们优化的是这样的时刻：你向 CEO 演示了它，他说“很好，现在在真实 tenant 上运行吧”。到了这一步，速率限制、审计日志、写入错误处理和令牌管理规范，才决定产品能否留在你的技术栈中。

包含的内容

55 个工具——每个工具都：

  • 类型安全——通过 Zod 按严格的 JSON 架构验证参数，然后才发送 REST 请求。无效输入会在本地返回清晰的错误，而不是 API 的乱码响应。
  • 默认要求确认——破坏性工具（*_delete、使用批量选择器的 *_update）会在清单中声明 destructive: true。Claude Desktop 会显示确认对话框。
  • 受速率限制——按 tenant、用户和工具分别限制。批量操作会进入队列并施加反压，而不会对你的 Bitrix24 发起 DDoS 攻击。
  • 记录到审计日志——每次调用都会在 ~/.bitrix24-mcp/audit.log 中写入一行 JSON（时间戳、工具、用户、剩余速率限制额度、耗时、结果）。日志仅保存在本地，权限为 -rw-------。

覆盖范围： CRM（联系人 / 公司 / 交易 / 潜在客户 / 商品 / 活动 + 跨类型搜索）、任务（创建 / 分配 / 阶段 / 评论 / 附加 / 时间记录）、用户（列表 / 获取 / 按部门查询）、即时通讯（聊天 / 私信 / 最近记录）、日历（列表 / CRUD / 响应）。完整参考文档请在安装后访问 landing 页中的 docs/TOOLS.md。

安全性
  • Webhook / OAuth 令牌保存在操作系统钥匙串中（macOS Keychain、Windows Credential Manager、Linux 上通过 keytar 使用 libsecret）。绝不会存入配置文件、环境变量或日志。
  • 零遥测。 不收集使用指标、stack trace 或调用模式。无需关闭——因为根本不会收集。
  • 明确声明的出站连接。 防火墙可见两个主机：*.bitrix24.kz / *.bitrix24.ru / *.bitrix24.com（你的 tenant）和 license.rcs.kz（每 24 小时验证一次许可证；14 天宽限期后故障开放）。
  • 软件包完整性。 生产软件包采用 V8 字节码，并带有 SHA-256 指纹，可通过 5 个独立检查点进行验证。任何修改尝试都会明确失败。
  • 采用 ECDSA P-256 许可证。 对 tenant 范围内的软件包哈希值和到期时间进行签名。被盗许可证无法转移到其他 tenant；没有 RCS 私钥也无法延长有效期。

威胁模型和 10 攻击 harness 见 docs/threat-model.md（每次发布都会与 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

它是什么

bitrix24-mcp 是一个模型上下文协议服务，可将 Claude Desktop 连接到 Bitrix24 Cloud 租户。只需安装一次，并通过 Bitrix24 入站 webhook（或 Bitrix24.Market OAuth 应用）完成授权，Claude 即可获得 55 个工具，涵盖 CRM（联系人、公司、交易、潜在客户、产品）、任务、用户、即时消息和日历。

接下来，Claude 会发挥所长，对非结构化请求进行推理，例如 “总结本季度所有成交日期已过、金额超过 50 M KZT 的交易，将其中金额最高的三笔发邮件给客户负责人，并为每笔交易创建一项后续任务”，然后在获得你的批准后，代表你调用 Bitrix24 REST API。

为什么要开发它

通用的“将 AI 接入 CRM”工具注重演示效果。我们关注的是演示结束后的实际使用：届时，速率限制、审计跟踪、写入失败后的恢复，以及身份验证令牌的卫生管理，才决定产品能否留在你的技术栈中。

包含哪些内容

全部 55 个工具均具备以下特性：

  • 类型安全 — 每个参数都会根据严格的 JSON schema，使用 Zod 进行验证，之后 REST 调用才会离开本机。
  • 默认要求确认 — 破坏性工具（*_delete、带有批量选择器的 *_update）会在清单中声明 destructive: true。合规的客户端会显示确认对话框。
  • 受速率限制 — 按租户、用户和工具分别限流。批量导入会通过背压排队，而不是对你自己的 Bitrix24 发起 DDoS 攻击。
  • 记录审计日志 — 每次调用都会将一行 JSON 写入 ~/.bitrix24-mcp/audit.log，记录时间戳、工具、调用方、剩余速率限制、耗时和结果。仅用户可读。

覆盖范围： CRM（联系人、公司、交易、潜在客户、产品、活动及跨类型搜索）、任务（创建、分配、移动阶段、评论、附加文件、记录工时）、用户（列表、获取、按部门查询）、IM（聊天、私信、最近记录）、日历（列表、CRUD、响应）。完整参考文档：安装后访问落地页中的 docs/TOOLS.md。

安全状况
  • Webhook URL / OAuth 令牌存储在操作系统的密钥链中（通过 keytar 使用 Keychain / Credential Manager / libsecret）。绝不存入配置文件或环境变量，也绝不写入日志。
  • 无遥测。 我们不会收集使用指标、崩溃报告或工具调用模式。
  • 明确声明网络出口。 仅访问两个主机，均可由防火墙查看：*.bitrix24.{kz,ru,com}（你的租户）和 license.rcs.kz（每 24 小时检查一次许可证，宽限期为 14 天，之后检查失败时允许继续运行）。
  • 软件包完整性。 生产软件包以 V8 字节码形式发布，加载时会通过五个独立检查站验证 SHA-256 指纹。
  • ECDSA 签名许可证。 使用 P-256 签名，签署租户范围内的软件包哈希及到期时间。泄露的许可证无法重新指向其他租户。

完整威胁模型和 10 种攻击测试工具：docs/threat-model.md。

适用对象
  • 使用 Claude Pro / Team / Enterprise 的 Bitrix24 客户，希望不再需要在聊天窗口和 CRM 之间来回切换。
  • RCS 客户（其现有的哈萨克斯坦 1С 特许经营业务组合），希望在现有 1С 集成基础上，通过单一可信供应商实现 Bitrix24 自动化。
  • 需要审批 AI-CRM 集成的运营 / IT 团队，他们会就令牌存储、审计和速率限制提出具体问题。
它 不是什么
  • 不是嵌入在 Bitrix24 内的聊天小组件。Claude 在 Claude Desktop（或任何兼容 MCP 的客户端）中运行。
  • 不是无代码自动化工具。
  • 不是本地部署的 Bitrix24 连接器。仅支持云租户。
  • 不是免费工具。
销售现场监督，而不仅仅是 CRM 访问权限

大多数 Bitrix24 AI 集成只能查看记录和商机，到此为止。对话仍然不可见：电话、与客户的开放线路聊天、销售代表在时间轴上留下的备注。“这个商机为什么停滞了”的答案，实际上就藏在这些地方。

  • 通话 — 每位销售代表拨打和接听了多少通电话、漏接了多少通、通话时长，以及录音链接。
  • 开放线路 — WhatsApp、Telegram、网站小组件：完整的客户对话和首次响应时间。
  • CRM 备注 — 销售代表对停滞商机写下的内容，而不只是字段中的信息。
  • 向销售负责人汇报 — 汇总简报并直接发送到 Bitrix24 聊天中。
  • 所有操作都可用日常语言完成，无需报表生成器，也无需开发工作。

这需要在门户端启用 imopenlines 和 telephony 权限范围。现成连接器不会请求这些权限，这就是它们在第一个真正的管理绩效场景中遇到瓶颈的原因。

定价
套餐价格包含内容
试用期按需咨询全部 55 个工具 · 无需信用卡 · 不提供免费套餐
月付29 900 ₸/mo含增值税，签订合同

开始使用： 在 rcs.kz 申请访问权限 — 我们会发送 .mcpb 软件包和试用密钥；试用期结束后，将签订合同并按月计费。详情：rcs.kz/product/mcp-bitrix24。

链接

许可证

本仓库依据 CC BY-ND 4.0（文档）授权 — 详见 LICENSE。软件本身（npm 软件包、.mcpb 软件包及所有相关制品）受服务条款约束；源代码为专有。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。