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,写入前自动备份原文件。
手动(三选一):
- 命令行运行:
claude mcp add biglazycat -- "<安装路径>" --mcp-stdio; - 编辑
~/.claude.json,往mcpServers里合并:
{
"mcpServers": {
"biglazycat": {
"command": "<安装路径>",
"args": ["--mcp-stdio"]
}
}
}
- 只给单个项目用:把同样的条目写进项目根目录的
.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
- Qoder 里打开设置(
Ctrl+Shift+,,macOS 为⌘⇧,),左侧导航选「MCP」; - 「我的服务」右上角点「+ 添加」,传输类型选 STDIO;
- 名称填
biglazycat,命令填本应用的安装路径(从「手动配置」里复制),参数填--mcp-stdio,保存; - 也可以用命令行:
qoder mcp add biglazycat -- "<安装路径>" --mcp-stdio。
保存后在 Qoder 的会话里即可调用。
WorkBuddy
- 打开 WorkBuddy 的「设置 → 连接器 → 添加服务」,传输方式选 stdio,命令填本应用安装路径,参数填
--mcp-stdio; - 或直接编辑配置文件
~/.workbuddy/mcp.json(Windows 在用户目录的.workbuddy\mcp.json),往mcpServers里合并与 Claude 相同形状的条目; - WorkBuddy 的新服务器要手动信任:在「连接器管理」里找到 biglazycat 点「信任」,之后对话里就能用了。
OpenCode 与 Gemini CLI
两者都在「检测」名单里,点「一键写入」即可;手动片段在「手动配置」里分别生成——OpenCode 是 mcp 键下的本地服务器(command 为数组),Gemini CLI 是 ~/.gemini/settings.json 的 mcpServers。配置后重启客户端。
接好之后
- 先让 AI 调用
get_app_guide了解你的工作区,再开始操作; - 不想暴露的工具在「设置 → MCP 服务」的工具列表里逐个勾掉,即时生效;
- 写入正文前 AI 都要走应用的确认流程;正文改动可在「版本历史」回滚;
- 每次调用的记录在「设置 → AI 调用日志」。
不生效?
- 应用必须正在运行:从系统托盘退出即停止服务,只关窗口不算退出;
- 写入的配置要重启对应客户端才生效;
- 新装了客户端后点「重新检测」;
- 客户端配置文件带注释导致自动写入失败时,按提示手动合并;
- 提示「已存在同名配置,但不是本应用写入的」说明有条目冲突,先手动检查再合并。