---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
title: OpenConnector
description: 在自己的环境运行开源 Connector runtime，并通过 MCP、HTTP、OpenAPI 或 SDK 使用 provider actions。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/docs/openconnector/
markdown_url: https://oomol.com/zh-cn/docs/openconnector.md
---

# OpenConnector

OpenConnector 是 OOMOL 的开源项目。[OpenConnector 项目官网](https://openconnector.io/zh-cn/)提供项目介绍与连接器目录；本文介绍部署方式和运行时管理。

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-cn/docs/connector/)。需要按 SaaS 终端用户隔离账号时，使用 [Connector for SaaS](/zh-cn/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-cn/docs/openconnector-self-hosting/)运行 runtime，再通过 [OpenConnector SDK](/zh-cn/docs/openconnector-sdk/)、MCP 或 HTTP 连接它。OAuth provider 配置从 [OAuth app 配置指南](/zh-cn/docs/openconnector-oauth-apps/)开始。