智能体的执行轨道。
Coral 是一个开源、自托管的网关,位于你的智能体与其所操作的系统之间。智能体通过编写简短的 TypeScript 程序来调用工具,并将运行成功的程序保存为自定义工具以便复用。Coral 在添加凭证并转发调用之前,会依据你的策略检查每一次调用。
在这个示例中,智能体首次将未经审核的 PR 发布到 Slack。智能体搜索 GitHub 和 Slack 工具,并编写调用它们的代码。它不被允许在未经批准的情况下发布到 Slack,因此由用户批准该发布。随后智能体将其代码保存为自定义工具。第二天,智能体通过调用该自定义工具来执行同样的任务。
控制智能体能做什么,而不仅仅是能触及什么。大多数 MCP 网关只决定智能体能看到哪些工具。这是全有或全无的:如果智能体能调用update_record,它就能以该工具允许的任何方式更新任何记录。自定义工具是代码,因此它可以承载 Allow 和 Block 无法承载的规则:closeStaleTicket只更改一个字段,且仅限 30 天无活动的工单。你可以像对待其他工具一样,在自定义工具上设置 Allow、Ask 或 Block,Coral 仍会依据你的策略检查其中的每一次提供商调用。
减少智能体的重复工作。智能体每项任务都从零开始。它们重新读取工具 schema、重试失败的调用,并花费 token 重写昨天已经做对的步骤的代码。借助 Coral,智能体将运行成功的代码保存为自定义工具,一步即可再次调用,工作区所有者还可以将其分享给整个团队。
Coral 被 450 多家公司的数千名开发者使用,用于在客户支持、SecOps、商业智能、SRE 等领域实现更安全、更高效的智能体工作。
开始使用
-
安装 Coral。
- 供个人使用:从以下地址下载桌面应用:下载页面。它可在 macOS(Apple silicon)、Windows(x64)和 Linux(x86_64)上运行。
- 供团队使用: 使用 Docker Compose 或 Kubernetes 运行共享服务器。你需要一个 OIDC 身份提供商、一个用于 TLS 的反向代理,以及 SQLite 或 Postgres。
-
添加一个提供商。一个 provider 就是你的智能体可以使用的一项服务,例如 GitHub 或 Linear。从目录中挑选一个,或者自带你的 OpenAPI 文档或 MCP 服务器。默认情况下,读取数据的工具会立即运行, 其他所有工具都需要你的批准。参见添加一个 provider。
-
连接你的智能体。从 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 客户端。
-
提一个问题。向你的智能体提一个会用到该 provider 的问题,例如 “我有哪些未关闭的 pull request?”
为什么选择 Coral
我们在构建一个 AI SRE 时创立了 Coral。为了调查一次事故, 智能体必须在海量遥测数据以及内部与外部系统之间未记录的关系中 理清头绪。它需要宽泛的权限和大量 token,而且下次还得从零开始。
我们构建 Coral,是为了让智能体记住路线。一旦某个任务成功, 智能体就会把奏效的步骤保存为自定义工具。下次,它会在与 Datadog 和 Slack 等 provider 工具相同的搜索中找到该工具。它始于 SRE,如今各团队在 整个组织中使用 Coral 完成智能体工作:
- SRE。智能体调查告警。自定义工具让它只回滚 你指定的服务。
- 客户支持。智能体处理退款,并在你定义的 情况下升级给人工。
- 商业智能。自定义工具聚合仓库、CRM 和计费 数据,并且只把指标传给智能体。
- 安全运营。智能体使用自定义工具在已批准的 分组内隔离设备。
你将获得:
- 精确控制。为每个 provider 工具和每个 自定义工具设置允许、询问或阻止。审批会显示确切的调用及其参数,因此安全团队 批准的是单次退款查询,而不是整个支付 API。参见角色与权限。
- 共享工具,而非共享 token。你可以将每个 provider 设置为使用 调用者自己的账户,这样队友就能共享工具而无需共享 API token。阅读Slackbot 如何使用这一点。
- 更便宜的模型,同样的准确度。借助自定义工具,更小的模型 能表现得像更大的模型。对许多任务而言,这意味着以 Haiku 5.5 的成本获得 Opus 5.5 的准确度。
- 更快、更精简的智能体。在 GitHub、Linear 和 Slack 上的 34 项任务中,使用 Opus 5.5 时,自定义工具将 token 减少了 37%,成本降低了 31%,时间缩短了 29%。参见每一项任务。
- 领先于其他 MCP 网关。在 100 项企业任务的盲测中,智能体使用 Coral 比使用其他 MCP 网关更准确、成本更低。参见基准测试。
- 你拥有的训练数据。每次运行都会留下结构化的追踪记录,包含目标、使用的工具和结果,非常适合用于对你自己的模型进行后训练。
从一名开发者的笔记本电脑到企业云,Coral 都能适配你的技术栈:
- 运行在你自己的基础设施上。Coral 用 Rust 编写,可作为桌面应用运行在你的笔记本电脑上,或作为共享服务器运行在你自己的云中,数据零外泄。
- 开源。Coral 采用 Apache License 2.0 许可,对用户数、智能体数量或用量均无限制。本 README 中除Coral Enterprise之外的所有内容均属于开源版本。
- 任何智能体,任何系统。它可与任何支持 MCP 的 AI 应用或智能体配合使用。你可以通过 MCP 服务器或 OpenAPI 文档连接任何东西,包括 5,000 多个数据库和 SaaS 工具。
Coral 的工作原理
智能体编写程序。Coral 基于代码模式构建,并增加了自定义工具、策略控制和管理身份。要使用工具,智能体需编写一段简短的 TypeScript 程序。一个程序可以调用多个工具、过滤结果,并只返回任务所需的内容。更少的原始数据经过模型的上下文。
Coral 让它们在轨道上运行。每个程序都在全新的 V8 隔离环境中运行,没有网络访问、没有凭证、没有导入。Coral 会根据你的工作区策略检查每一次工具调用,然后添加凭证并将调用转发给提供商。策略还可以要求由人工批准该调用。每次运行都归属于发起它的个人或智能体。
graph LR
Agent["Your agent"] -->|"exec: run a program"| MCP["Coral MCP server"]
You["You"] -->|"providers, policy, approvals"| UI["Coral UI"]
subgraph Coral["Coral (your laptop or server)"]
MCP --> Run["Program runs in a V8 isolate"]
Run <--> FN["Custom tools (private and shared)"]
UI --> Gate["Policy check and credentials"]
Run --> Gate
Gate -.->|"approval request"| UI
end
Gate --> GH["GitHub"]
Gate --> SL["Slack"]
Gate --> Own["Your OpenAPI or MCP service"]
智能体通过exec工具将程序发送给 Coral。程序调用coral.search来查找智能体可用的工具并读取其 TypeScript 签名。然后智能体发送一个执行工作的程序。下面这个程序会找出没有审查者的开放拉取请求,并将它们发布到 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 编号会返回给智能体,而不是完整的 GitHub 响应。运行发生在 Coral 服务器上,而不是在你的智能体中,因此即使智能体断开连接,运行也会继续。
成功的程序会成为自定义工具。当程序成功时,智能体会将其保存为私有工具,并在下次一步调用它,形式为coral.private.<name>({ ... })。智能体在与 provider 工具相同的搜索中找到自定义工具,并复用或编辑它们,而不是从头开始。工作区所有者可以将私有工具发布为共享工具,位于coral.shared下,这样工作区中的每个人都可以调用它。
要了解 provider、账户、策略和工作区,请阅读概念。
面向团队和企业
为团队运行 Coral?请参阅运行共享服务器。
Coral Enterprise 即将在自有许可证下推出。它增加了组织级治理和支持:SAML 单点登录、SCIM 配置、高级 RBAC、不可变审计日志和支持 SLA。请参阅Coral Enterprise或预约演示。
开发
要从代码检出运行 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 状态,会在启动时告知你。请参阅从 Coral 0.x 升级。

