選擇 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