---
title: OOMOL Connector（託管）
description: 讓個人或團隊透過 oo CLI、MCP 或 SDK 使用託管的 App connections。
lang: zh-TW
canonical_url: https://oomol.com/zh-tw/docs/connector/
markdown_url: https://oomol.com/zh-tw/docs/connector.md
---

# 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](/zh-tw/docs/saas/)，不要共用個人 connection。

需要邀請同事和設定成員角色時，閱讀[團隊管理](/zh-tw/docs/team-management/)；需要控制個人 scopes 或團隊連接存取權時，閱讀[權限控制](/zh-tw/docs/access-control/)。

## 三種存取方式

| 入口 | 適合 | 從這裡開始 |
| --- | --- | --- |
| oo CLI | 能使用終端的 Agent | [快速開始](/zh-tw/docs/agents/) |
| MCP | 支援 MCP 的 Agent 或 client | [快速開始](/zh-tw/docs/agents/) |
| `Connector` SDK | 呼叫已連接 Apps 的可信後端 | [使用 SDK 呼叫已連接的 Apps](/zh-tw/docs/connector-client/) |

這些入口共用同一套託管 Connector 帳號與 connection 系統。

## 一次呼叫如何完成

1. 你在 OOMOL 中連接 App，並批准需要的 scopes。
2. OOMOL 在託管邊界中保存和重新整理憑證。
3. Agent 或後端發現 action 及其輸入 schema。
4. 呼叫方選擇 connection，並提交 action 輸入。
5. Connector 呼叫 provider 並傳回操作結果。execute 只傳回操作輸出；需要執行中繼資料時使用 executeRaw。

呼叫方不會讀取 provider 原始 OAuth token。

## 與另外兩個產品的區別

| 需求 | 應該使用 |
| --- | --- |
| 自己或團隊直接使用已連接 Apps | OOMOL Connector（目前產品） |
| SaaS 中按終端使用者隔離 connections | [Connector for SaaS](/zh-tw/docs/saas/) |
| 在自己的基礎設施執行開源 runtime | [OpenConnector](/zh-tw/docs/openconnector/) |

## 開始使用

按照[快速開始](/zh-tw/docs/agents/)完成首次呼叫。需要從後端呼叫已連接的 Apps 時，再閱讀[後端呼叫指南](/zh-tw/docs/connector-client/)和 [TypeScript SDK 參考](/zh-tw/docs/connector-sdk/)。

## 安全邊界

個人 API key 只能放在可信後端或密鑰管理系統。不要放入瀏覽器 bundle、公開倉庫或提示詞，也不要讓互不相關的終端使用者共用一個 key。