把 Claude、Codex 或 Cursor 连到你的资料库

MindMax 会在你的电脑上跑一个小服务，供 AI 应用调用。连上之后，它可以搜索你的文档、读完整篇 论文和整本书、在画布上工作，并对你的稿子提修改建议——用它自己的模型，在它自己的窗口里。

不会上传给 MindMax，也不会到我们这边。这条连接在你机器上，在那两个程序之间。

需要什么

• MindMax 桌面版（macOS 或 Windows），并且把你想要共享的文件夹作为工作空间打开着。
• 一个支持 Model Context Protocol 的 AI 应用：Claude、Claude Code、Codex、ChatGPT 桌面版、 Cursor、Windsurf 或 WorkBuddy。

点一下就连上

1. 打开你想让外部应用访问的文件夹，让它成为当前工作空间。
2. 进 设置 → 外部 AI。MindMax 会列出它在这台电脑上找到的应用。
3. 点某个应用的 连接，或者 全部连接。MindMax 写进各个应用自己的配置，并保留一份 .bak 备份。
4. 需要重启的应用，MindMax 会给出按钮。Claude Code 和 Codex 下一个会话就生效。
5. 开一段对话，随口问点什么——有应用在读你的资料库时，状态栏会点名显示。

设置 → 外部 AI。可以只连一个，也可以「全部连接」——每个应用第一次真实调用之后，状态才会更新。

应用	MindMax 写什么	什么时候生效
Claude	claude_desktop_config.json	重启后（MindMax 给按钮）
Claude Code	claude mcp add，用户级	下一个会话
Codex	~/.codex/config.toml	下一个会话
ChatGPT 桌面版	与 Codex 同一条 config.toml 条目	重启后
Cursor	~/.cursor/mcp.json	重启后
Windsurf	~/.codeium/windsurf/mcp_config.json	重启后
WorkBuddy	~/.workbuddy/mcp.json	立即

所有应用都写在同一个名字下：mindmax-desktop。断开时只删掉这一条，你其它的 MCP 服务不动。

两个权限档位

每个连上的应用处于其中一档，在同一个设置页那一行的 ⋯ 菜单里切换。

档位	它能做
协作（默认）	读、搜索、提修改建议、加批注、新建文档与画布，用它的模型跑 MindMax 的方法
只读	读、搜索、读你的批注——不提建议，不新建文件

两档都不允许覆盖已有文档，也不允许删除。

第一句说什么

连接在用过之前是看不见的，所以从你本来就想做的事开始：

• 「用我的 MindMax 资料库，这三篇论文里的试验到底说明了什么？」
• 「读我在 MindMax 里打开那本书的第三章，讲讲它在论证什么。」
• 「用我的资料写一份两页的简报，每个结论都要有我能核对的引文。」
• 「把我在 MindMax 里打开的那份文档改简洁些。」
• 「把这份稿子上我留的批注都处理一下；批注指着哪儿，就改哪儿。」
• 「把我在 MindMax 里打开的这一章当审稿人读一遍，把问题写成批注，先别改。」

支持 prompts 的应用，在 / 菜单里还能看到 MindMax 自己的活：校对文档、拿资料库核对说法、 处理等着回应的批注、用你的资料写一篇新东西。

应用写入的时候会发生什么

新文件直接建出来，工作空间的历史里留一行，写明是哪个应用写的。

对已有文件的修改会以 建议 的形式到达：MindMax 弹出评审卡，建议显示在你自己的文字上，分组 标成修订，每组说明理由。由你接受或拒绝——在你点头之前，磁盘上的文件一个字没变。

应用加的批注和高亮和你自己写的一样：挂在原文那一段上，署它的名字，MindMax 的 AI 之后可以回应。 这也让批注成了一条双向的通道——你写的批注是它可以去执行的一条请求，它写的批注等着你处理。见 和 AI agent 在页边一起改稿。

连上的应用跑的一轮评审：意见落在它评的那段原文上，署着它的名字，在页边等你处理。

事后去哪儿看

• 状态栏。 有应用在用资料库时会点名。点开能看到最近的调用、临时暂停，或者断开。
• 会话栏。 每个连上的应用有自己的一条：读了什么、提了什么建议、跑了哪次长任务。
• 版本历史。 每一笔写入都有署名，所以某个应用动过的文档可以和别的保存一样对比、回退。

应用没出现怎么办

没装，或者 MindMax 找不到它。 MindMax 会去各个应用的常规位置找，也会问你的登录 shell claude、codex 在不在 PATH 上。装在非常规位置的应用，可能显示为未安装。

连上了，但一次工具都没调用过。 只写了配置、还没有真实调用的应用，会显示为「已配置」而不是 「已连接」——这是有意的，因为写了配置不等于这个应用能用。调一次，状态就更新。

ChatGPT 里看不到工具。 ChatGPT 桌面版和 Codex 共用同一份配置，但它是否在对话里呈现本地 工具，取决于版本；如果不呈现，同一台机器上的 Codex 用的是同一条。

手动配置。 配置文件写不进去时（权限问题，或者文件已经不是合法 JSON），MindMax 会把那一条 配置原样给出，带复制按钮。贴进那个应用配置的 mcpServers 里，重启应用即可。

提示「请先打开 MindMax」。 工具调用会在应用关着的时候把它在后台拉起来，然后等。如果拉不 起来，调用会返回一句话让你打开 MindMax，而不是一直挂着。

工作空间之外的绝对路径。 只有 read_document 接受工作空间之外的文件，而且只读。往工作空间 外写会被拒绝；把那个文件夹作为工作空间打开才对。

隐私与边界

• 服务只监听 127.0.0.1，每个应用一个独立 token。没有远程端点，所以服务器和手机都到不了你的 资料库。
• 这条路径上 MindMax 不跑自己的任何模型。应用发给它模型服务商的内容，按那家服务商的条款处理， 和你在它里面做别的事一样。
• 调用记录在本地审计日志里，保留 30 天，同时也记在应用的会话条目里。
• 连上的应用只能读你最近打开过的工作空间，别的一概看不到。

工具与各自的权限，见 agent 工具参考；为什么没有删除、为什么 引文由 MindMax 展开而不是相信模型写的那句话，见 MindMax MCP。