bitrix24-ai-tools

Bitrix24 AI 工具

基线：Bitrix24 云版；本地部署版通过 vibecodeconnector · 已验证：b24restdocs 2026-09-30，vibecodeconnector 26.200.100（main 26.800.0）

目标	用途
在自己的代码中编写或修改 REST 调用	MCP b24-dev-mcp + bitrix24-rest-api
让 Agent 在平台上构建并托管应用	Alaio Vibecode
适用于 Agent 的起步项目	b24gosdk llms.txt；github.com/bitrix24/b24-ai-starter（Nuxt 3 + PHP/Python/Node、OAuth、Docker）

REST 文档本身未提供 llms.txt 文档。Vibecode（平台）≠ Vibe（起始页，landing.repowidget.*）≠ Vibe+（云套餐系列）。

文档 MCP b24-dev-mcp

https://mcp-dev.bitrix24.com/mcp：Streamable HTTP（无 /sse），无需身份验证。它仅提供文档：不提供门户数据，也不调用方法。客户端必须接受 application/json 和 text/event-stream（否则返回 406）。

工具	何时调用
bitrix-search	首先调用；返回准确名称。doc_type：method、event、other、app_development_docs；limit
bitrix-method-details	编写调用前调用：参数、必填字段、响应、错误、示例（可通过 field、filter 缩小范围）
bitrix-event-details	编写事件处理程序时调用：负载
bitrix-article-details	查询概念：身份验证、限制、批处理、分页
bitrix-app-development-doc-details	查询应用安装、嵌入位置、应用类型

设置：

claude mcp add --transport http b24-dev-mcp https://mcp-dev.bitrix24.com/mcp
codex mcp add b24-dev-mcp --url https://mcp-dev.bitrix24.com/mcp

Cursor .cursor/mcp.json：{"mcpServers": {"b24-dev-mcp": {"url": "https://mcp-dev.bitrix24.com/mcp", "timeout": 30000}}}。VS Code .vscode/mcp.json：{"servers": {"b24-dev-mcp": {"url": "https://mcp-dev.bitrix24.com/mcp", "type": "http"}}}。冒烟测试：询问 crm.item.add 的参数；答案必须列出 entityTypeId 和 fields。

规则：

1. 添加或修改 REST 调用前：先调用 bitrix-search，再对准确名称调用 bitrix-method-details。参数名称及大小写、必填字段、筛选语法和范围均以结果为准，不要凭记忆。
2. not found 表示名称不准确：重新搜索，绝不要猜测。
3. 文档描述的是云版。某个方法是否存在于指定的本地部署版：在该门户上调用 method.get。
4. 绝不要向 MCP 发送 webhook URL、令牌、密钥或客户数据。

Alaio Vibecode

一个通过 Vibecode 自有 API 构建 Bitrix24 应用的平台。入口：向 Agent 提供密钥并调用 GET https://vibecode.bitrix24.com/v1/me，该接口会返回对象、密钥权限和说明。

密钥（仅显示一次）：

• vibe_api_…：个人密钥，像 webhook 一样以单个用户的身份操作；不能嵌入 UI。
• vibe_app_…：带 OAuth 的应用，用户以自己的权限操作；嵌入位置和事件投递必需。
• vibe_live_…：仅用于管理（密钥、门户），无法访问数据。
• 模式 READWRITE（默认）或 READONLY（写入会返回 403 WRITE_BLOCKED_READONLY_KEY）。

与 REST 相比，该 API 会转换字段名称和筛选条件，在内部最多分页获取 5 000 个项目（REST：50），并进行批处理和瞬时错误重试。其他功能：Black Hole 服务（通过隧道托管，闲置 60 分钟后休眠）、支持重新投递的事件订阅、兼容 OpenAI 的模型（/v1/models、/v1/embeddings）、搜索（/v1/search）、存储、源代码版本。

限制：每个密钥每分钟 300 个请求；/v1/search 每分钟 60 次；AI 路由器每个密钥每分钟 600 次、每个用户每分钟 1 500 次。429 响应会附带重试时间；实际限制见 X-RateLimit-Limit。

费用：付费 Bitrix24 套餐加 Vibe+ 订阅。服务、按量计费的模型、搜索和 Agent 均以 Vibe 点数计费（1 Ꝟ = 1 USD）；预算耗尽会返回 402。

安全：仅将密钥保存在项目的环境变量中。密钥泄露时：创建新密钥并停用旧密钥。团队成员应使用各自的密钥，绝不要共用密钥。

若要快速构建内部工具、机器人和 AI 功能，且不使用自有托管服务，请选择 Vibecode。若需要自有基础设施、Marketplace 分发、自定义令牌存储，或使用未连接 Vibecode 的本地部署版，请选择普通 REST 应用（bitrix24-rest-api）。

本地部署：模块 vibecodeconnector

• 版本 26.200.100，Beta 版：安装程序要求接受 Beta 条款。需要启用 REST 的 rest；使用 im 和 socialservices。每个许可证密钥只能连接一个安装实例。
• 模块设置 → 连接会将该实例注册到 Vibecode（vibecode.bitrix24.com；对于 CIS 或许可证区域未知的情况，使用 vibecode.bitrix24.tech），并保存配对密钥。
• 随后，Vibecode 会向模块的操作接口发送 POST 请求，并附带 Authorization: Bearer <JWT>（CheckIncomingJwt）。Vibecode 必须能够访问该实例。API 密钥作为用户的入站 webhook 签发；应用密钥则来自安装在该实例上的个人应用。
• 选项 permission_source：vibecode 会绕过门户对 webhook 和应用创建的限制；portal 则会应用这些限制。RU/BY 许可证还需要 Marketplace 订阅（SUBSCRIPTION_REQUIRED）。
• 仅在断开连接后卸载。连接后，用户在 Vibecode 中添加该实例（“连接自托管 Bitrix24”），即可像使用云端一样操作。

检查清单

• 已使用 bitrix-method-details（或方法页面）检查每个新增或更改的 REST 调用，而非凭记忆编写。
• 仓库、提示词、截图或 MCP 请求中均不含 webhook URL、令牌或 Vibecode 密钥。
• Vibecode 密钥权限最小化；应用不需要写入时使用 READONLY。
• 已审核生成的应用：权限、会修改的数据、错误处理方式，以及可打开应用的人员。