OpenConnector新手教程3步执行第一个Action零凭据快速连接1000 SaaS【免费下载链接】open-connectorOpen-source auth gateway connecting 1000 SaaS providers to AI agents through SDK, CLI, MCP, HTTP, and OpenAPI.项目地址: https://gitcode.com/gh_mirrors/op/open-connectorOpenConnector是一个开源的认证网关Auth Gateway它把1000 SaaS 服务商和10000 预构建 Action以标准接口暴露给你的 AI Agent。本文将带你走完 OpenConnector 快速上手的完整流程3 步执行第一个 Action无需任何凭据几分钟内验证你的运行时。OpenConnector 是什么为什么你需要它想象一下你的 AI Agent 想帮你发一封 Gmail 邮件、创建一个 Notion 页面、查询 GitHub 仓库——但它不该直接拿到你的邮箱密码或 API Token。OpenConnector 就在 Agent 与 SaaS 服务之间加了一道安全的网关凭据隔离账号、Token、OAuth 密钥全部保存在运行时边界之后Agent 拿不到任何凭据只能看到安全的账号标签和执行结果。即用的 Action 目录GitHub、Gmail、Slack、Notion、BigQuery、Airtable……1000 服务商开箱即用每个 Action 都有可检查的输入/输出 Schema。多协议接入同一批 Action 可以通过 SDK、CLI、MCP、HTTP / OpenAPI 四种方式使用一次连接、处处调用。它也是 Pipedream / Composio 的开源替代品支持本地 Docker、Node.js、Cloudflare、Fly.io 等多种部署方式详见 docs/quickstart.md。准备工作一键启动本地运行时启动 OpenConnector 只需要Node.js 22或Docker二选一。方式一从源码启动推荐体验如果本地已有项目代码直接运行npm install npm run dev如果想克隆仓库地址是https://gitcode.com/gh_mirrors/op/open-connector。方式二Docker Compose 一键启动项目根目录已内置 docker-compose.yml一条命令拉起预构建镜像docker compose up启动后你会得到两个入口地址用途http://localhost:3000Web 控制台浏览服务商、配置凭据、调试 Actionhttp://localhost:3000/docs自动生成的 API 参考文档 本地运行时的状态默认保存在./data/connect.sqlite无需手动建库。第 1 步执行第一个 Action零凭据Hacker News不需要任何凭据是验证运行时的最快方式。在终端执行curl -s -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \ -H content-type: application/json \ -d {input:{}}返回统一格式的 JSON 响应success/message/data看到success: true就说明运行时完全正常。项目里还提供了完整的 TypeScript 示例 examples/local-http/hackernews.ts运行node examples/local-http/hackernews.ts即可看到同样的效果。第 2 步发现你需要的 ActionOpenConnector 内置 10000 个 Action用三个接口就能摸清家底详见 docs/runtime-api.md# 列出所有提供 Action 的服务 curl -s http://localhost:3000/v1/actions # 查看某个服务的全部 Action 契约 curl -s http://localhost:3000/v1/actions?servicehackernews # 获取某个 Action 的 Agent 可读指南Markdown curl -s http://localhost:3000/api/actions/hackernews.get_top_stories/agent.md每个 Action 都有可检查的契约请求/响应 Schema、所需权限范围一目了然Agent 在调用前就能读懂参数要求。第 3 步接入真实服务API Key 一分钟搞定验证成功后接一个真实服务也只需两条命令。以 GitHub 为例它支持 Personal Access Token最简单# 1. 存储凭据api_key 类型 curl -s -X PUT http://localhost:3000/api/connections/github \ -H content-type: application/json \ -d {authType:api_key,values:{apiKey:github_pat_...}} # 2. 执行需要凭据的 Action curl -s -X POST http://localhost:3000/v1/actions/github.get_current_user \ -H content-type: application/json \ -d {input:{}}如果服务商使用 OAuth2如 GmailWeb 控制台里有完整的图形化流程填写 OAuth 应用信息 → 复制回调地址 → 浏览器授权完成整个过程无需写代码。更多凭据与 OAuth 配置细节见 docs/credentials.md。进阶4 种方式调用同一个 Action连接建立后同一批 Action 可以被不同生态无缝调用方式入口适合场景MCPhttp://localhost:3000/mcp接入支持 MCP 的 AI Agent 宿主Connector SDKoomol-lab/connectorTypeScript在应用代码中直接执行 Actionoo CLIoo connector run ...本地 Agent / 脚本 / CI 环境HTTP / OpenAPI/v1/actions/*、/openapi.json自定义客户端、API 导入工具MCP 端点暴露了一组发现工具list_apps、search_actions、execute_action等你的 AI 客户端连上即可自动发现全部能力。完整的端点与鉴权说明见 docs/runtime-api.mdSDK 与 CLI 用法见 docs/sdk-cli.md。常见问题Q本地运行时需要配置数据库吗不需要。默认使用 SQLite状态文件在./data/connect.sqlite。需要 PostgreSQL 时通过OOMOL_CONNECT_DATABASE_URL显式配置并先执行迁移。Q安全吗我的凭据会不会泄露给 Agent不会。所有凭据、Scope、执行日志都留在运行时边界内Agent 只拿到执行结果和安全账号标签。生产环境建议设置OOMOL_CONNECT_ENCRYPTION_KEY加密存储凭据以及OOMOL_CONNECT_ADMIN_TOKEN保护管理接口详见 docs/configuration.md。Q想部署到云端怎么办支持 CloudflareWorkers D1 R2、Fly.io、Kubernetesdeploy/helm/open-connector/以及 OOMOL 托管运行时同一套 Provider 与 Action 契约跨部署方式通用。恭喜到这里你已经完成了OpenConnector 快速上手的全流程启动运行时 → 执行第一个 Action → 接入真实服务。接下来可以打开 Web 控制台http://localhost:3000浏览 1000 服务商目录找到你工作流中最需要的那个服务让 AI Agent 真正长出手吧 【免费下载链接】open-connectorOpen-source auth gateway connecting 1000 SaaS providers to AI agents through SDK, CLI, MCP, HTTP, and OpenAPI.项目地址: https://gitcode.com/gh_mirrors/op/open-connector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考