OpenConnector

OpenConnector 是 OOMOL 的開源專案。OpenConnector 專案官網提供專案介紹與連接器目錄；本文介紹部署方式和執行階段管理。

OpenConnector 是開源的 Connector runtime / gateway。它管理 provider 憑證與 connections，載入 action schemas，執行 provider API 呼叫，並把這些能力暴露給 Agent 和應用程式。

它以可部署軟體的形式提供 runtime 和 gateway。

OpenConnector 做什麼

oo CLI / MCP / SDK / HTTP
          ↓
   OpenConnector runtime
          ↓
憑據、策略、Provider actions、執行記錄

• 管理 API key、OAuth2、自訂憑證和無需認證的 connections。
• 提供統一的 providers、actions 和 schemas。
• 透過 /mcp、HTTP actions API 和 /openapi.json 對外提供能力。
• 透過 Web Console 管理 connections、OAuth configs、runtime tokens、策略與執行紀錄。

誰應該使用

• 必須把憑證與執行紀錄保留在自己的基礎設施。
• 需要控制對外網路、資料庫、日誌和備份。
• 希望透過 MCP 或 HTTP 為內部 Agent 提供 actions。
• 願意自己建立 provider OAuth apps 並維護 callback URLs。

只想快速讓 Agent 使用自己的 Apps 時，優先使用 OOMOL Connector（託管）。需要按 SaaS 終端使用者隔離帳號時，使用 Connector for SaaS。

存取方式

這些入口都連接到同一個 OpenConnector runtime。

你需要維運什麼

• Admin token 與 runtime tokens。
• Credential encryption key 與敏感儲存。
• Provider OAuth apps、API keys 和公開 callback origin。
• Action allowlists、blocklists 和檔案策略。
• 資料庫、備份、網路、監控和升級。

開始部署

按照 OpenConnector 自部署指南執行 runtime，再透過 OpenConnector SDK、MCP 或 HTTP 連接它。OAuth provider 設定從 OAuth app 設定指南開始。