---
title: OpenConnector
description: 在自己的環境執行開源 Connector runtime，並透過 MCP、HTTP、OpenAPI 或 SDK 使用 provider actions。
lang: zh-TW
canonical_url: https://oomol.com/zh-tw/docs/openconnector/
markdown_url: https://oomol.com/zh-tw/docs/openconnector.md
---

# OpenConnector

OpenConnector 是 OOMOL 的開源專案。[OpenConnector 專案官網](https://openconnector.io/zh-tw/)提供專案介紹與連接器目錄；本文介紹部署方式和執行階段管理。

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

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

## OpenConnector 做什麼

```text
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（託管）](/zh-tw/docs/connector/)。需要按 SaaS 終端使用者隔離帳號時，使用 [Connector for SaaS](/zh-tw/docs/saas/)。

## 存取方式

| 入口 | 用途 |
| --- | --- |
| MCP | 給支援 MCP 的 Agent 暴露探索與執行工具 |
| HTTP / OpenAPI | 從任意伺服器端語言呼叫 actions |
| `OpenConnector` SDK client | 從 TypeScript 呼叫 runtime |
| oo CLI | 讓終端 Agent 指向這個 runtime |
| Web Console | 管理設定、connections、tokens 和執行紀錄 |

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

## 你需要維運什麼

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

## 開始部署

按照 [OpenConnector 自部署指南](/zh-tw/docs/openconnector-self-hosting/)執行 runtime，再透過 [OpenConnector SDK](/zh-tw/docs/openconnector-sdk/)、MCP 或 HTTP 連接它。OAuth provider 設定從 [OAuth app 設定指南](/zh-tw/docs/openconnector-oauth-apps/)開始。