用途：这套工具面向 Bitrix24 开发，分两条路径。写或改自己代码中的 REST 调用时，用文档 MCP b24-dev-mcp 配合 bitrix24-rest-api；让智能体在平台上构建并托管应用时，用 Alaio Vibecode。基线为 Bitrix24 云端，本地部署经 vibecodeconnector 模块。
文档 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（写调用前查参数、必填字段、响应、错误、示例）、bitrix-event-details（事件处理器 payload）、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，VS Code 用 .vscode/mcp.json。冒烟测试：询问 crm.item.add 参数，回答须包含 entityTypeId 与 fields。规则：新增或修改 REST 调用前先 bitrix-search 再 bitrix-method-details，参数名、大小写、必填字段、过滤语法与 scope 以结果为准；搜不到说明名称不准，重搜不要猜；文档描述云端，某门户是否存在该方法用 method.get 查；切勿向 MCP 发送 webhook URL、token、密钥或客户数据。
Alaio Vibecode：智能体通过其 API 构建 Bitrix24 应用。入口是给智能体一个密钥并 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 转换字段名与过滤器，内部最多分页 5000 条（REST 为 50），批量并重试瞬时错误；另有 Black Hole 服务器（隧道托管、空闲 60 分钟后休眠）、带重投的事件订阅、OpenAI 兼容模型（/v1/models、/v1/embeddings）、搜索（/v1/search）、存储与源版本。限制：每密钥 300 请求/分钟，/v1/search 60/分钟，AI 路由器每密钥 600/分钟、每用户 1500/分钟；429 带回重试时间，实际限额见 X-RateLimit-Limit。费用：需付费 Bitrix24 套餐加 Vibe+ 订阅，服务器、计量模型、搜索与智能体按 Vibe 积分计费（1 Ꝟ = 1 USD），预算耗尽返回 402。安全：密钥只放项目环境变量，泄露则新建并停用旧密钥，团队成员各用各的密钥。选择建议：快速做内部工具、机器人与 AI 功能且不想自建托管选 Vibecode；需要自有基础设施、Marketplace 分发、自定义令牌存储或未接 Vibecode 的机器则选普通 REST 应用。
本地部署：模块 vibecodeconnector，版本 26.200.100，Beta，安装需接受 Beta 条款，依赖启用 REST 的 rest，并使用 im 与 socialservices，每个许可证密钥连接一个安装。在模块设置 → Connect 将机器注册到 Vibecode（vibecode.bitrix24.com；CIS 或未知许可区域用 vibecode.bitrix24.tech）并保存配对密钥。Vibecode 随后以 Authorization: Bearer <JWT>（CheckIncomingJwt）POST 到模块动作，机器须对 Vibecode 可达。API 密钥以用户入站 webhook 签发，应用密钥作为安装在该机器上的个人应用。选项 permission_source：vibecode 绕过门户的 webhook 与应用创建限制，portal 则应用这些限制；RU/BY 许可证还需 Marketplace 订阅（SUBSCRIPTION_REQUIRED）。仅在 Disconnect 后卸载。连接后用户在 Vibecode 添加机器（Connect self-hosted Bitrix24）即可如云端一样使用。
检查清单：每个新增或修改的 REST 调用都经 bitrix-method-details 或方法页核对，而非凭记忆；仓库、提示、截图与 MCP 请求中不含 webhook URL、token 或 Vibecode 密钥；Vibecode 密钥权限最小化，不写入时用 READONLY；生成的应审核权限、改动数据、错误处理与可访问者。其余细节暂未提供。