开发与工程 oauthmcpopenapisaas-connectorscloudflare-workerstypescriptdocker

OpenConnector

将用户已授权的 SaaS 账户安全接入 AI 工作流。

FollowAgents 评估 · FARS-2.0
待评估
查看完整评分方法 →

这个 Agent 能做什么,适合哪些场景?

OpenConnector 是一个面向 AI 应用的开源连接器网关,用于连接用户已授权的 SaaS 账户与可执行操作。它提供包含 1,000 多个服务商和 10,000 多个预构建 Action 的目录,并支持 API Key、OAuth2、自定义凭据和免认证服务。应用或代理可通过 Connector SDK、oo CLI、MCP、HTTP API 或生成的 OpenAPI 文档发现和调用 Action。网关在运行时处理连接别名、作用域、运行时令牌、Action 允许/阻止策略、临时文件传递与脱敏运行日志,避免将服务商密钥直接交给代理进程。它可本地以 Docker 或 Node.js 运行,也可部署到 Fly.io、Cloudflare Workers/D1/R2,或使用 OOMOL 托管运行时。

客户端先浏览服务商目录,读取 Action 的请求/响应 schema、所需 scopes 与执行器信息;随后选择连接别名并通过网关执行。自托管实例可用 PUT /api/connections/github 写入 GitHub 凭据,再以 POST /v1/actions/github.get_current_user 调用 Action;免认证验证可调用 POST /v1/actions/hackernews.get_top_stories。MCP 客户端可连接 http://localhost:3000/mcp,HTTP 客户端可调用 /v1/actions/*,并从 /openapi.json 获取接口描述。Web Console 用于浏览连接器、配置凭据、创建 runtime token、检查 schema、调试 Action 和查看近期运行记录。

  1. 正在构建企业助手的开发团队,需要让助手在用户授权后操作 GitHub、Gmail、Notion、Slack 或 Airtable,而不把凭据注入助手进程。
  2. 为现有 AI 产品增加工具调用的工程师,需要通过 HTTP 或 OpenAPI 调用统一的 SaaS Action 接口。
  3. 使用 MCP 主机的本地开发者,需要从 http://localhost:3000/mcp 向主机暴露已连接应用的 Action。
  4. 希望在自身 Cloudflare 账户运行连接器服务的团队,需要使用 Workers、D1、R2 和静态控制台部署运行时。
  5. 需要排查授权、作用域或 Action 调用问题的运维人员,需要在 Web Console 中查看 Action schema、调试调用和脱敏运行日志。

这个 Agent 有哪些优点和局限?

优点
  • 同一套服务商 ID、Action ID、schema 和契约可用于开源自托管与 OOMOL SaaS 部署。
  • 同时提供 SDK、`oo connector`、MCP、HTTP 和 OpenAPI,便于嵌入不同类型的代理或应用。
  • 运行时明确提供连接身份、作用域、令牌、Action 策略和脱敏日志等可检查控制面。
  • 部署选择覆盖本地 Docker/Node.js、Fly.io、Cloudflare Workers,以及 OOMOL 托管运行时。
局限
  • 自托管 OAuth 服务商需要自行注册、配置和管理 OAuth 客户端凭据。
  • Cloudflare 部署依赖 Workers、D1、R2 和 Static Assets 等 Cloudflare 资源。
  • 本地或 Fly.io 路径使用 SQLite 持久化,生产部署需要自行处理相应的存储与运行环境。
  • README 宣称目录覆盖 1,000 多个服务商和 10,000 多个 Action,但未在所给材料中列出每个服务商或 Action 的支持范围。

如何安装或部署这个 Agent?

本地自托管可直接运行:

docker compose up

该命令拉取 ghcr.io/oomol-lab/open-connector:latest。若要从源码构建:

docker compose -f docker-compose.yml -f docker-compose.build.yml up --build

运行后控制台位于 http://localhost:3000,API 文档位于 http://localhost:3000/docs。开发源码需要 Node.js 22 或更高版本,并执行 npm installnpm run dev。OAuth 服务商需要自行在相应服务商处注册并配置 OAuth 客户端凭据;GitHub 示例可使用个人访问令牌。

如何使用这个 Agent?

先验证运行时:

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

配置 GitHub 后调用当前用户:

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":{}}'

也可使用 Connector SDK、oo connector、MCP 端点或 /v1/actions/* HTTP 接口;通过 /openapi.json 检查生成的 OpenAPI 描述。

这个 Agent 与同类方案有什么区别?

项目将自己定位为 Pipedream 和 Composio 的替代方案。其资料强调自托管运行时、可检查的 Action 契约,以及在自托管与 OOMOL 托管环境之间复用同一服务商和 Action 标识;未提供与这些产品的功能矩阵或迁移工具说明。

常见问题

代理会直接拿到服务商密钥吗?
设计说明中,服务商密钥保留在运行时边界内;代理获取运行所需的元数据、安全账户标签和执行结果。
自托管时是否能直接使用 OAuth?
可以运行 OAuth 流程,但需要为相应 OAuth 服务商自行注册并配置客户端凭据。
可以怎样调用连接器?
可通过 Connector SDK、`oo connector` CLI、MCP 的 http://localhost:3000/mcp、HTTP `/v1/actions/*`,或生成的 `/openapi.json` 使用。
调用失败后如何排查?
Web Console 提供 Action schema 检查、Action 调试、近期运行记录、失败信息与运行时使用概览;运行日志会进行脱敏。

相关 Agents