Open-Source Connector Gateway

一次连接，处处可用

OpenConnector 是 AI Agent 的开源连接器网关：用户的应用账号只授权一次，之后所有 Agent 都能调用 1,000+ 服务商的 10,000+ 个预构建 Action——而密钥始终留在网关里，Agent 永远碰不到。

1000+ Providers 10000+ Actions MCP-ready OpenAPI 3.1 Apache-2.0 Node.js 22+

01 / WHAT

AI 世界的配线架

The Idea

Agent 不再为每个服务单独对接认证

没有网关时，接一个服务就要处理一次 API Key / OAuth / token 刷新，密钥还要交给 Agent 进程，安全与维护成本都爆炸。OpenConnector 把「凭据管理、权限控制、Action 目录、运行审计」收进一个可自托管的网关——Agent 只面对一个插口，外部服务从网关统一接出。

Three Promises

🔑

密钥不落地

Agent 只拿到连接别名与执行结果，密码和 token 永远在网关边界内

📋

Action 可检查

每个动作都有请求/响应 schema、所需权限与执行器源码，调用前看得清

🛡️

策略与审计

运行时 token、allow/block 名单、脱敏运行日志——权限最小化由网关强制执行

02 / HOW

工作方式

Agent 发现 Action、检查 schema 与权限、选择连接、执行调用——全程经过网关。提供者密钥留在运行时边界之后。

Client

AI Agent / App

──▶

Gateway

OpenConnector

──▶

Boundary

凭据与 OAuth

──▶

Providers

1000+ SaaS

🔐 凭据管理
API Key / OAuth2 / 自定义

📚 提供商目录
1,000+ 服务

⚙️ Action 执行器
开源可检查

🧾 策略与日志
Token / 名单 / 审计

// SDK · oo CLI · MCP · HTTP — 四种方式接入同一个网关

03 / ACCESS

四种接入方式

connector-sdk

Connector SDK

TypeScript 轻量客户端，应用代码里直连自托管或 OOMOL 托管的运行时。

oo-cli

oo CLI

本地 Agent 中继：搜索、检查、执行 Action，一条命令搞定认证与调用。

mcp

MCP 端点

localhost:3000/mcp，把全部 Action 暴露给 MCP 生态的 Agent 宿主。

http / openapi

HTTP / OpenAPI

直调 /v1/actions/*，自动生成 /openapi.json 文档。

04 / DEPLOY

部署路径

从零运维到零部署，四条路共用同一套 provider id、Action id 与 schema——随时可以迁移。

本地自托管OSS

Docker / Node 运行时 + SQLite 存储，MCP、HTTP、OpenAPI、Web 控制台全套。

要完全掌控的开发者

Fly.ioHOSTED

托管 Docker 运行时，SQLite 持久卷、TLS、健康检查开箱即用。

想要托管运行时的团队

CloudflareHOSTED

Workers 运行时 + D1 状态 + R2 中转文件 + Static Assets 控制台。

轻量托管、免运维服务器

OOMOL 托管SAAS

免部署、免配 OAuth App，用户立刻授权，月赠 Connect 额度。

想开箱即用的团队

⚠️ 自托管时 OAuth 需要自行向各平台注册应用；跳过这步就用 OOMOL 托管版。

05 / START

快速开始

# 1. 起一个本地运行时（拉取 ghcr.io/oomol-lab/open-connector）
$ docker compose up

# 2. 控制台与 API 文档
$ open http://localhost:3000     # Web 控制台
$ open http://localhost:3000/docs # 生成的 API 参考

# 3. 免认证 Action 冒烟测试
$ curl -s -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
    -H 'content-type: application/json' -d '{"input":{}}'

# 连接 GitHub（PAT 方式）→ 调用 Action
$ curl -s -X PUT http://localhost:3000/api/connections/github \
    -H 'content-type: application/json' \
    -d '{"authType":"api_key","values":{"apiKey":"github_pat_..."}}'

$ curl -s -X POST http://localhost:3000/v1/actions/github.get_current_user \
    -H 'content-type: application/json' -d '{"input":{}}'

06 / USE

典型场景

SCENARIO 01

企业内部 AI 助手

员工授权一次自己的 Slack、CRM、表格账号，Agent 即可「查上周销售数据发到群里」。换电脑、改密码都不影响；离职在控制台一键吊销。

SCENARIO 02

SaaS 产品嵌入 AI 功能

产品要支持用户授权 Notion / Gmail / Drive 让 Agent 干活？接入 SDK 即可，OAuth 注册、token 刷新、scope 管理全是网关的事。

SCENARIO 03

个人自动化

「GitHub issue 被 @ → 查代码 → 自动回复」「新邮件 → 摘要 → 存 Notion」。一次授权，CLI / MCP / HTTP 全工具链复用。

SCENARIO 04

给 Agent 套权限笼子

只允许 gmail.search 禁止 gmail.delete？allow/block 策略由网关强制执行，不靠 Agent 自觉，出事有审计日志。