内容
# Raf 代理工具包
**Raf** 让您的编码代理满足外部服务需求 — 发送电子邮件、数据库、身份验证、支付、DNS、托管 — 通过将每个需求解析为来自开放目录的验证提供商，连接它（秘密通过浏览器交接，不通过聊天），并调用它。
此仓库是代理工具包的分发：一个 Claude Code 插件（也是 Cursor 插件），捆绑了 Raf MCP 服务器和触发技能。
## 安装 — 一个命令，无论您使用哪个代理
```sh
npx plugins add raf-team/agent-toolkit
```
[开放插件 CLI](https://github.com/vercel-labs/plugins) 自动检测您机器上安装的每个代理 — **Claude Code、Cursor、Codex、Grok Build、Kimi Code、GitHub Copilot CLI 和 VS Code** — 并将 Raf 插件（触发技能、规则和 MCP 服务器）原生安装到每个代理中，并自动更新。之后请重启您的代理会话。
每个代理的注意事项：
- **Claude Code** — 原生替代方案：`claude plugin marketplace add raf-team/agent-toolkit`，然后 `claude plugin install raf@agent-toolkit`。
- **Cursor** — 在首次使用时批准 `raf` 服务器。
- **Codex** — 默认情况下每个工具调用都会提示；对于无人值守的运行，在 `[mcp_servers.raf]` 下设置 `default_tools_approval_mode = "approve"`。Codex 插件无法在当前版本中提供钩子（`plugin_hooks` 功能已删除；2026-07-19 在 codex-cli 0.144.1 上测量），因此始终开启的触发通道是 AGENTS.md 部分 `npx rafads@latest install` 编写的 — 在插件旁边运行它。插件的捆绑钩子在 Codex 恢复插件钩子之前处于惰性状态。
- **VS Code** — 代理插件是预览功能；如果您的组织管理该设置，请启用 `chat.plugins.enabled`。
### 没有插件支持？
`npx rafads@latest install` 直接编写配置文件（Claude Code、Codex、Cursor、Copilot CLI — 这是唯一询问遥测交互的路径）。
或从此仓库安装触发技能：
```sh
npx skills add https://github.com/raf-team/agent-toolkit --skill raf-provider-needs --yes --global
```
…and 在您的代理的 MCP 配置中注册 MCP 服务器：
```json
"raf": {
"command": "npx",
"args": ["-y", "rafads", "mcp"],
"env": { "RAFADS_CATALOG": "https://registry.rafads.com/raf-catalog.json" }
}
```
完整的每个代理的说明：https://registry.rafads.com/agent-setup （代理可读：https://registry.rafads.com/agent-setup.md）
## 您的代理获得什么
- `execute` — 在沙盒中运行 TypeScript，具有对每个连接集成的工具的键入访问权限，以及有效按钮：`await tools.use({ need: "transactional email" })` 返回一个有效的集成、带有一次人类凭证点击的待处理票据或诚实的无匹配回复。回复一个验证的提供商（赞助条目始终被标记）和替代项的数量；使用 `not: ["<id>"]` 或 `compare: true` 进行覆盖以获取完整的排名集。品牌请求（`use({ need: "resend" })`）原样保留。
- `skills` — 操作指南：`execute`（调用约定）和 `resolve`（按钮的详细信息以及逐步手动流程）。
- `resume` — 继续因用户交互而暂停的执行。
服务有两个通道。默认通道是 **免费通道**：仅限有机答案，无付款，无指纹识别。`raf ads on` 选择进入 **赚钱通道**：当其质量超过最佳有机候选者的标准时，一个标记赞助的默认选项可能会提供，并且符合条件的代理活动在本地累积租金（`raf ads status` 显示账本）。没有人看到他们不被付费查看的广告。
遥测功能默认关闭。选择加入（`RAFADS_TELEMETRY=1` 在 MCP 条目上，或回答 `npx rafads@latest install` 的“是”）会发送解析漏斗 — 需求声明、显示默认值、添加集成、连接 — 以及其他内容：没有代码，没有提示，没有凭证。
## 许可证
MIT
