Rakazo 集成指南：Composio、MCP、OpenAPI 四大方式为 AI 连接数百款应用

【免费下载链接】rakazoOpen-source Grok Bot alternative. Choose your own model and sandbox.项目地址: https://gitcode.com/gh_mirrors/ra/rakazo

Rakazo 是一款开源的持久化 AI 队友平台（Grok Bot 的开源替代方案），它的核心卖点之一，就是让 AI 机器人真正"动手"干活——通过 Composio、Pipedream Connect、MCP、OpenAPI 四大集成方式，把数百款应用连接进你的 Rakazo，让机器人能查日历、发消息、操作数据库，而你只需要选一款模型、一个沙箱，其余交给它。

📌 为什么 Rakazo 集成能力值得关注？

普通聊天机器人只能"说"，而 Rakazo 的机器人（Bot）可以"做"：

• 持久化身份：每个 Bot 拥有自己的对话、记忆、例行任务和历史记录；
• 多端可用：Web、Electron 桌面端、Expo 移动端（手机 App）三端共享同一套集成配置；
• 应用连接：通过 Composio / Pipedream Connect 连接托管应用目录，或自行安装 Treg、HTTPS MCP、OpenAPI 工具源；
• 懒加载目录：应用工具超过 20 个时自动切换为"搜索-加载-执行"模式，避免撑爆模型的上下文窗口。

官方特性清单见 README.md，更新历史见 CHANGELOG.md。

🔍 四种集成方式怎么选？

1️⃣ Composio 托管集成：一个 API Key 连接数百款应用

Composio 是托管型集成目录，接入后你会在 Rakazo 的集成页面看到一个应用商店式的目录：搜索应用 → 点击添加 → 走 OAuth 授权 → 完成，Bot 即可调用该应用的全部工具。

• 自托管部署时，在服务器的.env中设置COMPOSIO_API_KEY即可启用托管目录（见 docs/self-host-secrets.md 中的变量说明表）；
• 连接流程由 apps/web/src/pages/PluginsOverlay.tsx 实现：发起connections.begin拿到授权链接，打开新窗口完成 OAuth 后轮询connections.complete直至状态变为connected；
• 服务端对接逻辑位于 packages/adapters/src/composio-connector.ts，目录缓存见 packages/adapters/src/composio-catalog-cache.ts。

操作步骤（Web 端）：

1. 打开集成（Integrations）页面，搜索想要的应用（如日历、邮件）；
2. 点击Add，Rakazo 会打开应用授权窗口；
3. 完成授权后回到页面，应用卡片显示Added，工具列表即已加载；
4. 如需撤销，直接在连接条目上吊销，Bot 立即失去该应用的调用权限。

2️⃣ Pipedream Connect：企业级自动化连接器

如果你团队已经在用 Pipedream，Rakazo 支持直接挂载 Pipedream Connect 作为托管目录：在服务器集成设置页选择Pipedream，填入Client ID、Client secret和Project ID即可（配置表单见 apps/web/src/components/integrations/IntegrationSetup.tsx）。

一个实用的自动优化：当 Pipedream 连接的应用工具总数超过 20 个时，Rakazo 会自动启用懒加载目录（pipedream_search_tools/pipedream_load_tool/pipedream_execute_tool），按需取用工具，避免一次把所有工具塞进模型请求。

3️⃣ MCP 服务器：连接任何支持 MCP 的应用

MCP（Model Context Protocol）是 Rakazo 集成体系里最"万能"的一条路——任何提供 MCP 端点的服务都能接进来：

• Direct MCP：在"添加 MCP 服务器"表单中填写服务名称与 HTTPS 端点，传输方式默认streamable_http，支持 Bearer / 请求头认证与 OAuth 授权流程（OAuth 连接逻辑见 apps/web/src/lib/mcp-connect.ts）；
• Treg 预设：表单内置 Treg 工具目录快捷入口，预填地址并选择 Bearer（x-api-key）认证，一步完成安装；
• 私有端点：默认 MCP 仅允许公网 HTTPS；如需连接内网/Docker 网络中的 MCP 服务器，在 API 与 Worker 上设置MCP_ALLOW_PRIVATE_ENDPOINT=true（说明见 docs/self-host.md 第 228 行附近）；
• 服务端实现位于 packages/adapters/src/mcp-connector.ts 与 packages/adapters/src/mcp-transport.ts。

💡 小技巧：连接完成后，可以在 Bot 设置里为每个 Bot 单独审批（approve）要使用哪些 MCP 服务器，实现按角色隔离权限。

4️⃣ OpenAPI 与 GraphQL：把任意 REST 接口变成 AI 工具

没有 MCP 端点？没关系。只要你的服务有OpenAPI (JSON/YAML) 规范，Rakazo 就能把它转换成一组可调用工具：

1. 在集成页面的高级区域选择OpenAPI源类型；
2. 粘贴规范文件的 URL，选择认证方式（无需认证 / Bearer / 自定义请求头）；
3. 点击安装，Rakazo 会把规范中的每个操作解析为工具注册给 Bot。

此外还支持GraphQL端点直接安装（配置与认证逻辑见 packages/adapters/src/graphql-connectors.ts，端到端用例见 apps/web/e2e/graphql-integrations.spec.ts）。所有用户自装的工具源统一保存在 packages/adapters/src/installed-connectors.ts 中，密钥以加密形式存储。

📱 手机端同样支持集成

移动端 Expo 应用提供完整的集成页面 apps/mobile/app/integrations.tsx：支持应用目录浏览与搜索、OAuth 授权连接、已安装工具源（MCP / OpenAPI / GraphQL）管理，与 Web 端共享后端，手机上随时给 Bot "加装备"。

🔒 自托管与安全建议

• 切勿把COMPOSIO_API_KEY、OpenRouter 密钥等写进 git、日志或聊天（docs/self-host.md 第 243 行有明确提示）；
• 集成目录搜索支持管理员自定义目录镜像地址，搜索逻辑与响应体积限制见 apps/api/src/integration-catalog.ts；
• 撤销连接、重命名账号、移除自装源等管理操作均有对应 API，可在 Web / 移动端界面完成。

✅ 总结：一张清单搞定 Rakazo 集成

• 🗂️ 想快速接主流 SaaS →Composio（一个 API Key 起步）；
• 🏢 企业已有自动化平台 →Pipedream Connect；
• 🔌 自研/私有服务 →MCP（记得按需开启私有端点）；
• 📄 有 REST 规范 →OpenAPI / GraphQL；
• 🧠 工具多了别慌，>20 个自动懒加载，省 token。

配好集成之后，你的 Rakazo 机器人就不再只是"会聊天"，而是一个能真正连接你工作流的 AI 队友。

【免费下载链接】rakazoOpen-source Grok Bot alternative. Choose your own model and sandbox.项目地址: https://gitcode.com/gh_mirrors/ra/rakazo