接入 Cursor 及其他编辑器

除了 Claude Desktop,AgileMedic 的一键接入还支持 Cursor、Cline、Codex、Zed、OpenCode 等多种 AI 客户端。接入后,这些编辑器里的 AI 就能直接读你这台电脑的系统状态、帮你诊断。

先读概览

"反向 MCP"是什么、consent 授权如何保护你,见 反向 MCP Server 概览。接入方式与 Claude Desktop 大同小异,本页侧重各编辑器的差异。

前置

• Windows 10/11 x64,已安装 AgileMedic。
• 对应编辑器已安装,且版本支持 MCP。
• 知道 sidecar agilemedic-mcp.exe 的绝对路径(与 agile-medic.exe 同目录)。

一键接入(推荐)

打开 AgileMedic → MCP Server 面板 → 找到对应客户端卡片 → 点该行 一键接入。

面板会自动定位该客户端的配置文件、按其格式写入 agilemedic entry(写前 .bak 备份、保留你其他内容),并做三态检测。多实例客户端(Claude Code / Codex)会展开"全局默认 + 各实例"多行,可逐个接入。

面板还提供批量接入 / 批量取消,一次处理所有目标。

各客户端配置格式

不同客户端的 MCP 配置结构差异很大。一键接入已按格式自动处理;下表供手动配置或排查时参考。

客户端	配置文件路径(Windows)	顶层字段 / 格式
Cursor	~/.cursor/mcp.json	mcpServers(标准 JSON)
Cline	~/.cline/mcp.json	mcpServers(结构同 Cursor)
Claude Code (CLI)	~/.claude.json(及各实例目录)	mcpServers(标准 JSON)
Codex (OpenAI CLI)	~/.codex/config.toml	[mcp_servers.*](TOML)
Zed	~/.config/zed/settings.json	context_servers(command 为嵌套对象)
OpenCode	~/.config/opencode/opencode.json	mcp(type:"local" + command 数组)

~ 在 Windows 上即你的用户目录 C:\Users\<你的用户名>。

Cursor 手动配置

1. 打开 Cursor MCP 配置

Ctrl+, 打开设置 → 搜索 MCP → Edit MCP Server config(或直接编辑 ~/.cursor/mcp.json)。

2. 加入 AgileMedic

{
  "mcpServers": {
    "agilemedic": {
      "command": "C:\\Program Files\\AgileMedic\\agilemedic-mcp.exe",
      "args": []
    }
  }
}

路径转义与 sidecar

• Windows 反斜杠在 JSON 中须双写 \\,或改用正斜杠 /。
• command 指向 agilemedic-mcp.exe(sidecar),不是主程序;args 留空即可,sidecar 启动就进 stdio 主循环。

3. 重启 Cursor

完全退出 → 重新打开。

4. 在 Composer 中使用

打开 Composer(Ctrl+I)→ 试一句 "帮我看看现在哪个进程最占内存" → AI 应自动调用 list_processes。

Cline 配置

Cline 的结构与 Cursor 完全一致(mcpServers.<entry>),配置文件是 ~/.cline/mcp.json。把上面 Cursor 那段 JSON 原样放进去即可,或直接用一键接入。

Codex 配置(TOML)

Codex 用 TOML 而非 JSON。编辑 ~/.codex/config.toml,加入:

[mcp_servers.agilemedic]
command = "C:\\Program Files\\AgileMedic\\agilemedic-mcp.exe"
args = []

多实例

Codex 与 Claude Code 一样支持多实例(~/.codex-instance-N/config.toml)。一键接入会把"全局 + 各实例"都列出来,逐个接入。

Zed 配置

Zed 用 context_servers 字段,且 command 是嵌套对象(与前面几个不同)。编辑 ~/.config/zed/settings.json:

{
  "context_servers": {
    "agilemedic": {
      "command": {
        "path": "C:\\Program Files\\AgileMedic\\agilemedic-mcp.exe",
        "args": []
      }
    }
  }
}

OpenCode 配置

OpenCode 用根级 mcp 字段,type 为 "local",command 是数组。编辑 ~/.config/opencode/opencode.json:

{
  "mcp": {
    "agilemedic": {
      "type": "local",
      "command": ["C:\\Program Files\\AgileMedic\\agilemedic-mcp.exe"],
      "enabled": true
    }
  }
}

写操作仍需 GUI 授权

无论用哪个编辑器,只读工具(列进程、扫垃圾、看指标等)即使 AgileMedic GUI 没开也能用;但写操作(结束进程、清理垃圾、改服务等)执行前会通过命名管道连 GUI 弹窗授权:

• GUI 运行中 → 弹出 consent 对话框,你点"允许"才执行。
• GUI 没运行 → 授权失败,操作不执行(fail-safe)。

想让 AI 帮你动手时,请先打开 AgileMedic 主程序。详见 概览的 consent 机制。

故障排查

问题	原因 / 解决
工具列表里没有 agilemedic	配置文件语法错误(JSON 逗号/引号、TOML 段名)→ 校验后重启编辑器
报 "spawn failed"	agilemedic-mcp.exe 路径写错/文件不存在 → 核对绝对路径,反斜杠双写
Zed 不生效	用错字段了 → Zed 是 context_servers 且 command 为嵌套对象,不是 mcpServers
Codex 不生效	Codex 是 TOML,不是 JSON;段名须是 [mcp_servers.agilemedic]
面板显示"需重新接入"	升级/迁移后 entry 指向旧路径 → 点"重新接入"
只读能用、写操作总失败	AgileMedic 主程序(GUI)没开 → 写操作需它弹窗授权
服务/HKLM 启动项操作失败	需管理员权限 → 以管理员身份运行主程序

下一步

• 接入 Claude Desktop
• 工具参考 —— 每个工具的完整参数与返回
• 反向 MCP Server 概览