接入第一个 AI 客户端

Reeve 通过 MCP（Model Context Protocol）把自己的工具暴露给 AI 客户端。本章用 Claude Code 作演示，其它客户端步骤几乎一样，详见MCP 接入。

前置准备

1. ✅ 已添加至少一台服务器（添加第一台服务器）
2. ✅ 已安装 Claude Code（或本机有其它 MCP 客户端）

操作步骤

Step 1：进入 MCP 接入页

主界面左侧导航 → MCP 接入。

页面上看到：

• 顶部：本地 MCP 端点状态（监听 127.0.0.1:<随机端口>）+ 测试连接按钮
• 中部：一键接入 八大客户端的卡片
• 下部：已签发 Token 列表

Step 2：点 Claude Code 卡片

弹出配置弹窗：

字段	选项	说明
作用域	User / Project	User 写 ~/.claude.json；Project 写 <当前打开目录>/.mcp.json
Token 名	例如 Claude Code on Mac	在 Reeve 里识别用；可见
可见服务器	默认全选	AI 看不到没勾的服务器
IP 白名单 (CIDR)	默认 127.0.0.1/32	仅本机调用；远程客户端可改 192.168.0.0/16 等

User 还是 Project？

• User：所有 Claude Code 对话都能用 Reeve 工具，方便但全局
• Project：只在当前项目目录的 Claude Code 能用，更精细
• 推荐先用 User 跑通流程，熟悉后切到 Project

Step 3：生成并写入配置

点「生成并写入配置」：

Reeve 自动：

1. 生成一次性高熵 Bearer Token（URL-safe base64）
2. Hash 后入数据库（明文不留 Reeve 侧）
3. 写入 Claude Code 配置文件
4. 启动本地 MCP HTTP 端点（如果还没启）

返回成功提示 + 显示写入的配置文件路径。

Step 4：在 Claude Code 验证

打开新的 Claude Code 对话，输入：

你：用 Reeve 列出我有哪些服务器

Claude：[调用 list_servers]
        我看到你配置了 3 台服务器：my-vps、prod-web、test-db

如果 AI 说"找不到 Reeve 工具"，按 MCP 接入 — 故障排查 检查。

八大 AI 客户端速查

每个客户端的接入路径都一样：MCP 接入页 → 找对应卡片 → 一键写配置。

客户端	配置文件	通道	备注
Claude Code	~/.claude.json 或 <project>/.mcp.json	stdio	支持 User / Project 作用域
Codex CLI	~/.codex/config.toml	stdio	TOML 格式
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 等	stdio
Cursor	~/.cursor/mcp.json	stdio
Cline (VSCode)	~/Library/.../cline_mcp_settings.json	stdio	VSCode 插件
Zed	~/.config/zed/settings.json 的 context_servers	stdio
OpenCode	~/.config/opencode/config.json	stdio
claude.ai（网页版）	手动配 Streamable HTTP	HTTP	需 SSH 隧道

详见 MCP 接入。

怎么知道 AI 用了 Reeve

三种途径：

1. 实时审批弹窗

如果服务器策略是 Approval 或 Allowlist：每次 AI 工具调用都弹审批窗，显示工具名 + 参数 + 命令原文，你点放行或拒绝。

2. 审计页

主界面 → 审计 → 看完整调用历史，含工具、服务器、参数、结果、决策、时间戳。

3. AI 桥接对话页

如果你用 Reeve 自带的 AI 对话（设置过 API Profile），所有工具调用流式可见。

关闭某个 AI 客户端的访问

在 MCP 接入页的 Token 列表里，找到对应 Token → 点 删除：

• Token Hash 从库里删除
• 客户端再请求时 Reeve 返回 401
• 客户端配置文件里残留的 Token 失效

如果想临时全局关掉 AI：AI 策略 页 → 总开关 → 设个限时（例如「禁用 30 分钟」）。

下一步

• MCP 接入八大客户端详解
• AI 五档策略 — 怎么细配权限
• 审计日志 — 怎么看 AI 都干了什么
• 项目空间 — 给每个项目独立的 Token