
Coral
为 agent 提供执行轨道。
Coral 是一个开源、自托管的网关,位于你的 agent 与它们所操作的系统之间。agent 通过编写简短的 TypeScript 程序来调用工具,并把奏效的程序保存为自定义工具以便复用。Coral 会在注入凭据并转发调用之前,按你的策略检查每一次调用。
快速开始 · 下载 · 演示视频
在这个示例中,一个 agent 首次把未经审核的 PR 发布到 Slack。该 agent 搜索 GitHub 和 Slack 工具,并编写调用它们的代码。它不被允许未经批准就发布到 Slack,因此由用户批准这次发布。随后 agent 把它的代码保存为自定义工具。第二天,agent 通过调用这个自定义工具来执行同一任务。

控制 agent 能做什么,而不只是能触达什么。大多数 MCP 网关只决定 agent 能看到哪些工具。这是全有或全无的:如果 agent 能调用 update_record,它就能以该工具允许的任何方式更新任何记录。自定义工具是代码,因此它可以承载 Allow 和 Block 无法承载的规则:closeStaleTicket 只改动一个字段,且只作用于 30 天无活动的工单。你可以像对待其他工具一样,对自定义工具设置 Allow、Ask 或 Block,而 Coral 仍会按你的策略检查它内部的每一次 provider 调用。
减少 agent 的重复工作。agent 每项任务都从头开始。它们重读工具 schema、重试失败的调用,并为昨天已经做对的步骤花费 token 重写代码。借助 Coral,agent 把奏效的代码保存为自定义工具,一步即可再次调用,工作区所有者还可以与整个团队共享。
Coral 被 450 多家公司的数千名开发者使用,用于在客户支持、SecOps、商业智能、SRE 等场景中实现更安全、更高效的 agent 工作。
开始使用
- 安装 Coral。供个人使用:从下载页面下载桌面应用。它支持 macOS(Apple silicon)、Windows(x64)和 Linux(x86_64)。供团队使用:用 Docker Compose 或 Kubernetes 运行共享服务器。你需要一个 OIDC 身份提供方、一个用于 TLS 的反向代理,以及 SQLite 或 Postgres。
安装 Coral。
- 供个人使用:从下载页面下载桌面应用。它支持 macOS(Apple silicon)、Windows(x64)和 Linux(x86_64)。
- 供团队使用:用 Docker Compose 或 Kubernetes 运行共享服务器。你需要一个 OIDC 身份提供方、一个用于 TLS 的反向代理,以及 SQLite 或 Postgres。
- 添加一个 provider。provider 是你的 agent 可以使用的一项服务,例如 GitHub 或 Linear。从目录中挑选一个,或自带你的 OpenAPI 文档或 MCP 服务器。默认情况下,读取数据的工具会立即运行,其他一切都需要你的批准。参见添加 provider。
- 连接你的 agent。从 Coral UI 复制你所在工作区的 MCP URL,并添加到你的 MCP 客户端:claude mcp add --scope user --transport http coral <your-mcp-url> # Claude Code codex mcp add coral --url <your-mcp-url> # Codex 对于 Cursor、VS Code、OpenCode 及其他客户端,参见连接 MCP 客户端。
连接你的 agent。从 Coral UI 复制你所在工作区的 MCP URL,并添加到你的 MCP 客户端:
claude mcp add --scope user --transport http coral <your-mcp-url> # Claude Code
codex mcp add coral --url <your-mcp-url> # Codex
文章标题:Show HN: Coral – 开源网关,让 agent 自己编写工具
正文: 关于 Cursor、VS Code、OpenCode 及其他客户端,请参阅 Connect an MCP client。
- 提问。让 agent 使用该 provider 做一些事情,例如“我有哪些未关闭的 pull request?”
Why Coral
我们是在构建 AI SRE 时开始做 Coral 的。为了调查一次事故,agent 必须在一大片遥测数据和内外系统之间未记录的关系中理清线索。它需要广泛的权限和大量 token,而且下次还要从零开始。
我们构建 Coral,是为了让 agent 记住路线。一旦某个任务成功,agent 就会把奏效的步骤保存为自定义工具。下次,它会在与 Datadog、Slack 等 provider 工具相同的搜索中找到这个工具。它从 SRE 起步,如今各团队在整个组织内使用 Coral 完成 agent 工作:
- SRE。agent 调查告警。自定义工具让它只回滚你指定的服务。
- 客户支持。agent 处理退款,并在你定义的场景中转交给人工。
- 商业智能。自定义工具汇总仓库、CRM 和计费数据,只把指标传给 agent。
- SecOps。agent 使用自定义工具在获批的分组内隔离设备。
你将获得:
- 精确控制。为每个 provider 工具和每个自定义工具设置 Allow、Ask 或 Block。审批会显示确切的调用及其参数,因此 Security 批准的是单次退款查询,而不是整个 payments API。请参阅 Roles & Permissions。
- 共享工具,而非共享 token。你可以将每个 provider 设为使用调用者自己的账户,这样队友就能共享工具而无需共享 API token。请阅读 Slackbot 如何使用这一点。
- 更便宜的模型,同样的准确度。借助自定义工具,较小的模型能表现得像较大的模型。对许多任务来说,这意味着以 Haiku 5.5 的成本获得 Opus 5.5 的准确度。
- 更快、更精简的 agent。在 GitHub、Linear 和 Slack 上使用 Opus 5.5 的 34 个任务中,自定义工具将 token 减少 37%、成本降低 31%、时间缩短 29%。查看每个任务。
- 领先于其他 MCP 网关。在 100 个企业任务的盲测中,使用 Coral 的 agent 比其他 MCP 网关更准确、更便宜。查看基准测试。
- 你拥有的训练数据。每次运行都会留下目标、所用工具和结果的结构化轨迹,非常适合用于对你自己的模型进行后训练。
从开发者的笔记本电脑到企业云,Coral 都能适配你的技术栈:
- 在你的基础设施上运行。Coral 用 Rust 编写,可作为桌面应用运行在你的笔记本电脑上,或作为共享服务器运行在你自己的云中,数据零外泄。
- 开源。Coral 采用 Apache License 2.0 许可,对用户、agent 或用量没有限制。本 README 中 Coral Enterprise 之外的所有内容都在开源版中。
- 任意 agent,任意系统。它适用于任何支持 MCP 的 AI 应用或 agent。你可以连接任何有 MCP server 或 OpenAPI 文档的东西,包括 5,000 多个数据库和 SaaS 工具。
How Coral works
agent 编写程序。Coral 构建在 code mode 之上,并增加了自定义工具、策略控制和管理身份。要使用工具,agent 会编写一段简短的 TypeScript 程序。一个程序可以调用多个工具、过滤结果,并且只返回任务所需的内容。通过模型上下文的原始数据更少。
Coral 让它们在轨道上运行。每个程序都在一个全新的 V8 isolate 中运行,没有网络访问、没有凭证、没有导入。Coral 会根据你的工作区策略检查每次工具调用,然后添加凭证并将调用转发给 provider。策略还可以要求由人工批准该调用。每次运行都归属于发起它的人或 agent。
graph LR
Agent["Your agent"] -->|"exec: run a program"| MCP["Coral MCP server"]
You["You"] -->|"providers, policy, approvals"| UI["Coral UI"]
subgraph Coral["Coral(你的笔记本电脑或服务器)"] MCP --> Run["程序在 V8 isolate 中运行"] Run <--> FN["自定义工具(私有和共享)"] UI --> Gate["策略检查与凭据"] Run --> Gate Gate -.->|"审批请求"| UI end
Gate --> GH["GitHub"] Gate --> SL["Slack"] Gate --> Own["你的 OpenAPI 或 MCP 服务"]
agent 通过 exec 工具发送 Coral 程序。程序调用 coral.search 来查找 agent 可用的工具,并读取它们的 TypeScript 签名。然后 agent 发送一个执行实际工作的程序。下面这个程序找出没有审查者的开放 pull request,并把它们发布到 Slack:
const { data: pulls } = await coral.providers.github.pulls.list({ owner: "withcoral", repo: "coral", state: "open", });
const unreviewed = pulls.filter((pull) => pull.requested_reviewers.length === 0);
await coral.providers.slack.chat.postMessage({ channel: "#engineering", text: unreviewed.map((pull) => #${pull.number} ${pull.title}).join("\n"), });
return unreviewed.map((pull) => pull.number);
如果发布到 Slack 需要审批,运行会在此处暂停,直到你批准为止。只有 pull request 编号会返回给 agent,而不是完整的 GitHub 响应。运行发生在 Coral 服务器上,而不是你的 agent 中,因此即使 agent 断开连接,运行也会继续。
行之有效的东西会成为自定义工具。当程序成功时,agent 会将其保存为私有工具,下次通过 coral.private.<name>({ ... }) 一步调用。agent 在与 provider 工具相同的搜索中找到自定义工具,并复用或编辑它们,而不是从头开始。工作区所有者可以将私有工具发布为 coral.shared 下的共享工具,这样工作区中的每个人都可以调用它。
要了解 provider、账户、策略和工作区,请阅读 Concepts。
面向团队和企业
为团队运行 Coral?参见 Run a shared server。
Coral Enterprise 即将在自有许可证下推出。它增加了组织级治理和支持:SSO with SAML、SCIM provisioning、高级 RBAC、不可变审计日志和支持 SLA。参见 Coral Enterprise 或 book a demo。
开发
要从 checkout 运行 Coral,请遵循开发指南。要贡献,请阅读 CONTRIBUTING.md。发布说明列出了每个版本中的变更。
社区
在我们的 Slack 社区或 GitHub issues 上提问、分享想法并展示你构建的内容。
安全
不要在公开 issue 或 pull request 中报告安全问题。参见 SECURITY.md。
Coral 通过 ISO/IEC 27001:2022 认证。每个程序都在自己的 V8 isolate 中运行,Coral 记录每一次审批。
许可证
Coral 在 Apache License 2.0 下授权。参见 LICENSE。
ee/ 目录包含 Enterprise Edition 代码,遵循其自有许可证 ee/LICENSE。在仓库根目录直接执行 cargo build 只会构建 Apache License 2.0 下的代码。NOTICE 说明了哪些文件适用哪个许可证。
从 Coral 0.x 升级
Coral v1 以 TypeScript 程序取代 SQL 接口。它从全新状态开始,不会转换 0.x 存储的内容。如果 Coral 发现 0.x 状态,会在启动时告知你。参见 Upgrade from Coral 0.x。