MCP 与外部 AI

2026-11-01

MCP(Model Context Protocol)是让 AI 客户端调用软件能力的开放协议。大懒猫桌面端内置 MCP 服务:开启后,Codex、Claude Code 等外部 AI 可以直接创建章节、修改正文、操作导图与画布——共 51 个工具,全部在本机运行。

开启服务

  1. 打开「设置 → MCP 服务」,打开开关,立即生效,无需重启;
  2. 服务只监听本机回环地址(随机端口),令牌每次启动重新生成,外部设备无法访问。

51 个工具

设置页的工具列表可以逐个勾掉不需要的工具,勾选即时生效;也有「全部开启 / 仅只读 / 全部关闭」快捷按钮。九组工具:

  • 引导与定位(8 个):读取使用指南与当前上下文、截取创作视图、定位资源文件等,外部 AI 靠它们认识你的工作区;
  • 内容与章节(16 个):列出、读取、创建章节与合集,按版本写入正文,局部修改文章,全文检索,批量导入,打标签;
  • 创作产物(4 个):管理思维导图等创作成果文件;
  • 思维导图(3 个):从大纲文本创建导图、增量修改节点、导入 .xmind;
  • 流程画布(4 个):创建与更新流程画布;
  • 白板(3 个):读取画布快照,批量添加、修改、删除元素,连线、对齐、分布、分组;
  • 图片库(5 个):列出、读取、导入、更新图片;
  • 主题(5 个):列出、校验、安装、删除主题——外部 AI 可以帮你编写并安装主题,见「主题与外观」;
  • 任务与记录(3 个):查询操作状态、取消进行中的操作、查看最近的写入记录。

接入外部 AI

  1. 打开「设置 → MCP 服务」,确认服务已开启;
  2. 点「检测」找到本机已装的客户端(支持 Claude Code、Codex CLI、OpenCode 与 Gemini CLI),点「一键写入」把大懒猫登记进去——写入前会自动备份原配置文件;
  3. 其他客户端用「手动配置」里现成的片段复制粘贴。

接入原理一句话:客户端按配置里的 --mcp-stdio 参数拉起大懒猫自带的桥接进程,桥把请求转发给正在运行的应用。应用没有运行时,工具不可用。

接入后建议让 AI 先调用 get_app_guide 了解用法,再开始操作。Claude Desktop、Qoder、WorkBuddy 等更多客户端的逐步接法,见「MCP 客户端接入教程」。

写入安全

  • 每次写入都返回回执:改了哪个文件、版本号、内容哈希,全部来自实际落盘结果;同一操作重复提交不会写两遍;
  • 章节被外部修改前会自动留存旧版本,可在应用的「版本历史」里回滚;
  • 调用日志保留 30 天,只记操作身份,不记正文内容;
  • 从系统托盘退出应用,服务立即停止;只关闭窗口不算退出,服务仍然可用。

注意

取消一个进行中的操作,已提交的部分不会回滚。导图与画布接收外部修改后,旧的撤销历史会被清除。