连接 AI Agent
连接 AI Agent
Section titled “连接 AI Agent”SuperDev 要在 Agent 能调用 MCP 工具后才真正有用。这是一次性设置：保持桌面端运行，为你的编程 Agent 安装 MCP 条目，然后重新加载 Agent，让它发现工具。
SuperDev 支持 Claude Code、Codex、Cursor。
| Agent | MCP 配置 | Skill 目录 | Session hook |
|---|---|---|---|
| Claude Code | ~/.claude.json | ~/.claude/skills/superdev | ~/.claude/settings.json |
| Codex | ~/.codex/config.toml | ~/.codex/skills/superdev | ~/.codex/hooks.json |
| Cursor | ~/.cursor/mcp.json | ~/.cursor/skills/superdev | ~/.cursor/hooks.json |
skill 和 MCP 条目一样重要。它会告诉 Agent 服务启停、日志、浏览器控制、审批和验证都走 SuperDev，而不是自己起进程或手工 tail 文件。
Codex 信任步骤
Section titled “Codex 信任步骤”Codex 对非托管 command hook 有额外信任步骤。安装后打开 Codex CLI，用 /hooks 审核并信任 hook；否则 MCP 条目虽然存在，但 SessionStart hook 不会被信任。
让 Agent 列出 SuperDev 能力，并跑一次只读调用，例如 get_runtime_snapshot 或 list_services。只读成功后，再让它尝试写操作。
- 工具没有出现：重新加载 AI 工具，确认 MCP 条目写到了它实际使用的 profile。
- 调用超时：确认 SuperDev 桌面端正在运行，本地 agent URL 可达。
- Codex 看似已安装但规则不生效：运行
/hooks并信任 hook。