MCP 客户端接入教程

2026-11-11

MCP 服务开启后,把本应用登记进 AI 客户端的配置文件,Codex、Claude、Qoder、WorkBuddy 等外部 AI 就能直接创建章节、修改正文、操作导图与画布。服务的开启与工具权限见「MCP 与外部 AI」;这一篇是每个客户端的具体接法。

接入原理

所有客户端都按同一条配置拉起大懒猫自带的桥接进程:命令填本应用的安装路径,参数填 --mcp-stdio。应用运行中时,桥把客户端的请求转发给它;应用没运行,工具不可用。任何支持「stdio 类型 MCP 服务器」的软件都能这样接入。

路径不要手写:应用的「设置 → MCP 服务 → 手动配置」里已经按客户端生成好指向本机安装路径的片段,复制过去合并即可。

Claude Code

自动写入:打开「设置 → MCP 服务」,点「检测」——在 Claude Code 行点「一键写入」,登记进 ~/.claude.json,写入前自动备份原文件。

手动(三选一):

  1. 命令行运行:claude mcp add biglazycat -- "<安装路径>" --mcp-stdio;
  2. 编辑 ~/.claude.json,往 mcpServers 里合并:
{
  "mcpServers": {
    "biglazycat": {
      "command": "<安装路径>",
      "args": ["--mcp-stdio"]
    }
  }
}
  1. 只给单个项目用:把同样的条目写进项目根目录的 .mcp.json。

配置在重启 Claude Code 后生效。

Claude Desktop

Claude Desktop 读同一种 mcpServers 形状,配置文件是 claude_desktop_config.json(Windows 在 %APPDATA%\Claude\,macOS 在 ~/Library/Application Support/Claude/)。把上面的 biglazycat 条目合并进去,重启 Claude Desktop,对话输入框的工具入口里就能看到大懒猫的工具。

Codex CLI

自动写入:「检测」后在 Codex CLI 行点「一键写入」,登记进 ~/.codex/config.toml。

手动:往 ~/.codex/config.toml 里加一段 TOML:

[mcp_servers.biglazycat]
command = '<安装路径>'
args = ["--mcp-stdio"]

路径用单引号字面量,Windows 反斜杠原样保留,不会出错。重启 Codex CLI 生效。

Qoder

  1. Qoder 里打开设置(Ctrl+Shift+,,macOS 为 ⌘⇧,),左侧导航选「MCP」;
  2. 「我的服务」右上角点「+ 添加」,传输类型选 STDIO;
  3. 名称填 biglazycat,命令填本应用的安装路径(从「手动配置」里复制),参数填 --mcp-stdio,保存;
  4. 也可以用命令行:qoder mcp add biglazycat -- "<安装路径>" --mcp-stdio。

保存后在 Qoder 的会话里即可调用。

WorkBuddy

  1. 打开 WorkBuddy 的「设置 → 连接器 → 添加服务」,传输方式选 stdio,命令填本应用安装路径,参数填 --mcp-stdio;
  2. 或直接编辑配置文件 ~/.workbuddy/mcp.json(Windows 在用户目录的 .workbuddy\mcp.json),往 mcpServers 里合并与 Claude 相同形状的条目;
  3. WorkBuddy 的新服务器要手动信任:在「连接器管理」里找到 biglazycat 点「信任」,之后对话里就能用了。

OpenCode 与 Gemini CLI

两者都在「检测」名单里,点「一键写入」即可;手动片段在「手动配置」里分别生成——OpenCode 是 mcp 键下的本地服务器(command 为数组),Gemini CLI 是 ~/.gemini/settings.json 的 mcpServers。配置后重启客户端。

接好之后

  • 先让 AI 调用 get_app_guide 了解你的工作区,再开始操作;
  • 不想暴露的工具在「设置 → MCP 服务」的工具列表里逐个勾掉,即时生效;
  • 写入正文前 AI 都要走应用的确认流程;正文改动可在「版本历史」回滚;
  • 每次调用的记录在「设置 → AI 调用日志」。

不生效?

  • 应用必须正在运行:从系统托盘退出即停止服务,只关窗口不算退出;
  • 写入的配置要重启对应客户端才生效;
  • 新装了客户端后点「重新检测」;
  • 客户端配置文件带注释导致自动写入失败时,按提示手动合并;
  • 提示「已存在同名配置,但不是本应用写入的」说明有条目冲突,先手动检查再合并。