文档

MCP 客户端安装矩阵与 skill 路径

把 REA 注册进编程智能体——并确认调查 skill 写在客户端真正会加载的目录。

一行 setup

npx rea-agents@latest setup

审阅计划、批准变更，然后重启或重连客户端。文档有时在全局安装后写 rea setup——两种形态都存在；需要可复现时请钉版本。

客户端矩阵（示意）

上游 setup 常见目标包括 Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Qwen Code、Grok Build、Windsurf 等 stdio MCP 客户端。具体支持随版本变化——用下表定向，再以 doctor --client … 确认。

客户端家族	典型路径	检查
CLI 智能体	`npx rea-agents@latest setup` → 选择客户端	`doctor --client …`
IDE MCP	setup 或手写 `mcp` stdio	重连 MCP；列出工具
桌面聊天宿主	按该宿主的 setup 计划	写入 skill/MCP 后重启应用

Skill 路径坑

setup 可能把调查 skill 写到软件包认为规范的目录（例如 ~/.agents/skills），而某客户端只从自己的树加载（例如 Claude Code 读 ~/.claude/skills）。症状：MCP 工具在，但智能体从不采用 REA 工作流说明。

setup 后确认 skill 文件落点。
若客户端忽略该路径，复制／符号链接到客户端 skills 目录——或升级到已对齐发现逻辑的版本后再跑 setup。
第三方 skill 安装器可能只装指令、不注册 MCP。仍需 setup 或手写 JSON 注册 MCP。

npx -y rea-agents@latest doctor --client claude_code --json
npx -y rea-agents@latest doctor --skill --json

手动 MCP 形态

{
  "mcpServers": {
    "rea": {
      "command": "npx",
      "args": ["-y", "rea-agents@latest", "mcp"]
    }
  }
}