OOMOL Connector(託管)
OOMOL Connector 是面向個人與團隊的託管連接服務。你連接 Gmail、GitHub、Notion、Slack 等 Apps,OOMOL 負責 OAuth、憑證儲存、token 重新整理和 action 執行;Agent 或可信後端只使用獲准的 tools。
為什麼使用 OOMOL Connector
- 連接一次,多處使用:同一個 App connection 可以透過 oo CLI、MCP 和 SDK 呼叫,並在多個支援的 Agent 中重複使用。
- 減少鑑權維運:OOMOL 負責 OAuth 流程、憑證保存和 token 重新整理。
- 保護帳號憑證:Agent、Skill 和業務程式碼只使用獲准的 actions,不接觸原始 OAuth token。
- 精細控制權限:每個 connection 可以單獨設定允許呼叫的 actions,以及哪些 Team 成員可以使用它。
- 支援個人與團隊:個人可以直接連接自己的 Apps,團隊可以共用 connections 並管理成員存取權。
適合什麼場景
- 在 Codex、ChatGPT、Claude Code 或其他 Agent 中使用自己的 Apps。
- 在多個受支援的 Agent 之間重複使用同一批 connections。
- 讓團隊成員在受控的 Team 範圍內使用共用能力。
- 從可信後端呼叫自己連接的帳號。
如果每個產品使用者都要連接自己的帳號,請使用 Connector for SaaS,不要共用個人 connection。
需要邀請同事和設定成員角色時,閱讀團隊管理;需要控制個人 scopes 或團隊連接存取權時,閱讀權限控制。
三種存取方式
| 入口 | 適合 | 從這裡開始 |
|---|---|---|
| oo CLI | 能使用終端的 Agent | 快速開始 |
| MCP | 支援 MCP 的 Agent 或 client | 快速開始 |
Connector SDK | 呼叫已連接 Apps 的可信後端 | 使用 SDK 呼叫已連接的 Apps |
這些入口共用同一套託管 Connector 帳號與 connection 系統。
一次呼叫如何完成
- 你在 OOMOL 中連接 App,並批准需要的 scopes。
- OOMOL 在託管邊界中保存和重新整理憑證。
- Agent 或後端發現 action 及其輸入 schema。
- 呼叫方選擇 connection,並提交 action 輸入。
- Connector 呼叫 provider 並傳回操作結果。execute 只傳回操作輸出;需要執行中繼資料時使用 executeRaw。
呼叫方不會讀取 provider 原始 OAuth token。
與另外兩個產品的區別
| 需求 | 應該使用 |
|---|---|
| 自己或團隊直接使用已連接 Apps | OOMOL Connector(目前產品) |
| SaaS 中按終端使用者隔離 connections | Connector for SaaS |
| 在自己的基礎設施執行開源 runtime | OpenConnector |
開始使用
按照快速開始完成首次呼叫。需要從後端呼叫已連接的 Apps 時,再閱讀後端呼叫指南和 TypeScript SDK 參考。
安全邊界
個人 API key 只能放在可信後端或密鑰管理系統。不要放入瀏覽器 bundle、公開倉庫或提示詞,也不要讓互不相關的終端使用者共用一個 key。
Wanta