接入 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 → 左侧导航「诊断 · AI」→ MCP 接入 面板 → 找到对应客户端那一行 → 点 一键接入。

面板会自动定位该客户端的配置文件、按其格式写入 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

安装版的 sidecar 默认在 %LOCALAPPDATA%\Programs\AgileMedic\；JSON 里不展开环境变量，要写完整路径（把「你」换成你的用户名）：

{
  "mcpServers": {
    "agilemedic": {
      "command": "C:\\Users\\你\\AppData\\Local\\Programs\\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:\\Users\\你\\AppData\\Local\\Programs\\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:/Users/你/AppData/Local/Programs/AgileMedic/agilemedic-mcp.exe",
        "args": []
      }
    }
  }
}

OpenCode 配置

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

{
  "mcp": {
    "agilemedic": {
      "type": "local",
      "command": ["C:\\Users\\你\\AppData\\Local\\Programs\\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 启动项操作失败	写操作由 `agilemedic-mcp.exe` 执行，权限跟随拉起它的编辑器；编辑器以普通权限运行时这类操作会失败。需要的话在 AgileMedic 主程序里直接操作

下一步

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