选择 Connector 产品
选择 Connector 产品时,请确认三个条件:连接账号归谁所有、是否需要按终端用户隔离,以及 Connector runtime 由谁运行。 产品确定后,再根据使用场景选择 CLI、MCP 或 SDK。
快速判断
| 你的情况 | 选择 |
|---|---|
| 我或团队要在 Agent 中使用自己的 Apps | OOMOL Connector(托管) |
| 我的可信后端要调用我自己连接的 Apps | OOMOL Connector(托管) 的个人 SDK |
| 我的 SaaS 要让每个终端用户连接自己的账号 | Connector for SaaS |
| 我需要把 runtime、凭据和日志放在自己的基础设施 | OpenConnector |
对比边界
| 维度 | OOMOL Connector(托管) | Connector for SaaS | OpenConnector |
|---|---|---|---|
| 主要用户 | 个人、团队 | SaaS 开发团队 | 个人、内部团队、私有环境 |
| Runtime | OOMOL 运维 | OOMOL 运维 | 你运维 |
| Provider OAuth app | OOMOL 管理 | 按 Project 配置 | 你创建和维护 |
| 常用入口 | oo CLI、MCP、个人 SDK | ProjectConnector、SaaS API | MCP、HTTP、OpenAPI、OpenConnector SDK |
| 凭据示例 | api_… / OOMOL 登录态 | oo_proj_… | oct_… |
OOMOL Connector(托管)
选择它,当 connection 属于你自己或团队,并且希望 OOMOL 处理 OAuth、凭据保存、token 刷新和 action runtime。
进入产品后再选择访问方式:
- Agent 能使用终端:安装
ooCLI。 - MCP client:连接 OOMOL MCP。
- 可信后端:使用个人
Connectorclient。
从快速开始进入 Console 并选择安装方式。
Connector for SaaS
选择它,当你的产品必须识别“哪个终端用户连接了哪个账号”。Project 提供配置和凭据边界,externalUserId 把 connected account 关联到你的业务用户。
Project API key 只能保存在可信后端。不要用个人 connection 模拟终端用户授权。
从 SaaS 接入概览开始。
OpenConnector
选择它,当你必须控制运行位置、数据库、凭据加密、网络、OAuth apps、tokens、action policies、日志和升级。
从 OpenConnector 概览开始。
最后再选访问方式
确定产品后,再根据调用方选择 CLI、MCP、SDK 或 HTTP:
| 调用方 | 通常选择 |
|---|---|
| 能使用终端的 Agent | oo CLI |
| MCP-compatible Agent | MCP |
| TypeScript 后端 | 对应产品的 SDK client |
| 其他服务端语言 | HTTP / OpenAPI |
选择访问方式不会改变账号归属和租户边界。
Wanta