# MindMax MCP：在 Claude Code 里用你的资料

URL: https://mindmax.me/zh/features/mcp/
Last verified: 2026-11-15

> 本机 MCP 服务：让 Claude Code、Codex、ChatGPT 或 Cursor 读你的整个资料库、引文到页、改稿走评审。不上传文件，不花 MindMax 额度。

接进你正在用的 AI 应用

## MindMax MCP：把资料库和工具接进你正在用的 AI 应用

MindMax 你用得上，你的 AI 也用得上，方法和资料都是同一套。Claude Code、Codex、ChatGPT 和 Cursor 可以直接用 MindMax 打开的那个文件夹——论文、整本书、笔记、高亮。模型用那个应用自己的；工具、书架、阅读地图，以及挡在它写入之前的那道评审门，都是 MindMax 提供的——模型通过调用这些工具，让任务成果和协作的质量更高。

[下载](https://mindmax.me/zh/download/)[怎么连 →](https://mindmax.me/zh/docs/getting-started/connect-an-ai-agent/)

连接

点一下，不用改配置文件

花费

MindMax 这边零额度，动脑的是你连的那个应用

支持平台

macOS（Apple 芯片）· Windows

价格

软件免费 · AI 订阅每月 $10 起，或用自己的 key

AI

订阅自带，或用你自己的 API key

你的 AI 应用

Claude Code · Claude · Codex · Cursor · WorkBuddy

用它自己的模型用 MindMax 提供的工具

MCP只在这台电脑上

MindMax

桌面应用，监听 127.0.0.1

你的文件夹阅读地图评审门

它能调用什么

search_knowledgeread_documentsuggest_editscreate_documentadd_comments

不上传 · 不调用 MindMax 的模型 · 不花额度

一个能读文件的 agent，不等于一个读过你资料库的 agent。把它指向一个文件夹，它会打开能找到
的东西，读装得下的部分，引用抄得下来的句子——面对一整个书架，这意味着大量猜测结构，以及对
你上个月标过什么一无所知。常见的解法是把文件上传到某个地方。这里反过来：资料留在原处，
agent 过来。

## 它读的是整个书架，不只是你碰巧点到的那份文件

外部 agent 缺的第一样东西不是智力，是地图。

- 搜索覆盖你在 MindMax 里打开过的每一种格式——PDF、EPUB 与 Kindle、Word、PowerPoint、Excel、图片、Markdown；每条命中都带回它所在的章节，以及一个可以引用的句柄。
- 问一本长书，agent 拿到的是一张地图，不是一堵文字墙：两级结构、每章一句说明、每节一个 section id。它挑一章，把那一节完整读回来，不够再回去换一章。
- 提问可以连同地图一起作为词法线索传过去，于是可能相关的章节在被选择之前就已经标出来了。但选哪一章始终由模型决定——MindMax 不替它选。
- 图、表、扫描页可以以页面图的形式给回去，所以一张图表是被看过的，而不是从图注里猜出来的。

[阅读地图里有什么 →](https://mindmax.me/zh/docs/reference/agent-tools/#read)

只有文件可用的 agent

pdftotext四千页纯文本在第 8,312 行附近翻找

结构、标题、页码全丢了。一个跨章节的问题没有立足点。

拿到 MindMax 地图的 agent

一本 550 页的书，它拿到的是这张地图

1 · 试验到底测了什么

主要终点；次要结局点了名，但没有报告结果。

block-12

2 · 效应在哪里消失

亚组分析；作者自己称为探索性结果。

block-48

3 · 摘要里省掉的局限

只做了十二周，没有描述随访。

block-96

整本书约 1.2 万字符。agent 先挑一章，再把那一节完整读回来。

读 → 想 → 写

借用方法

## 它可以在你的画布上想，用的还是你库里的方法

- 你选中的那张卡、当前这张画布、背后打开的那份文档：一次调用就把你眼前的东西交给 agent，所以「把这条分支再想深一点」不需要复制粘贴。
- MindMax 里那些有名字的方法——第一性原理、决策矩阵、红队、SWOT——可以逐个读到完整正文，连同每种方法产出的卡片形状；外部 agent 可以把一个方法施加到画布上，而不是临场发明一个结构。
- 更长的方法以管线方式运行：MindMax 规划步骤、校验产出，写作由 agent 自己的模型完成，结果落在 MindMax 自己跑也会落的地方——阅读面板、批注线程、译文文件、识别出的页面。

[每个思维方法是怎么写的 →](https://mindmax.me/zh/features/thinking-models/)

外部应用在画布上加的卡片，署着它的名字——这里是 Codex。请求卡记着要它做什么，并链到拿回来的结果。

页边

## 你指着那一句，活就在那一句上干

关于一句话的指令，就该落在那句话上——而不是隔着三百字，放在另一个聊天窗里。

- 在出错的那一行写一句批注：「这句和上一段重复了」「这里该用 2024 年的数字」。agent 读的是这条批注，连同它压着的那段原文，所以不用贴原文，也不用数第几段。
- 批注也可以只选类型、一个字不写：选中一段，设成改写、核查或找来源。改动提出来时，它会在那个线程里回一句——一轮下来，每条批注要么被回答、要么被改、要么带着理由还开着。
- 这条通道是双向的。要评审而不是要改写，意见就会落在页边、等你处理；你回其中一条，agent 从你的回复接着做，而不是另起一场对话。

[一条批注怎么变成一处改动 →](https://mindmax.me/zh/use-cases/revise-in-the-margin/)

外部应用跑的一轮评审：意见落在页边上，署着它的名字，一条条等你处理。

## 它的改动以建议的形式到达，不是既成事实

外部 agent 缺的第二样东西是克制。这里是强制它的地方。

- 新文件可以直接建。对你已经写过的东西做修改——改一个词或者整篇重写——会以建议的形式到达，显示在你自己的文字上，分组标成修订，每组附一句理由。你不接受，就一个字都不写盘。
- 回应批注的那份建议会说清回应的是哪一条：批注里多一条回复，接受改动之后它被标为完成；拒绝则线程留在原处，不会有东西在你不知情时关掉。
- 工具集里没有覆盖写，也没有删除。改名和移动要经过 MindMax，历史、批注、已打开的标签页才会跟着文件走。它写过的每一笔都会在版本历史里署上它的名字。

[为什么改动要等你点头 →](https://mindmax.me/zh/concepts/edits-wait-for-you/)

不经过 MindMax

agent 直接写 .md改了什么没有记录

批注丢了锚点，历史里没有这一笔，你第一次看到它是在别的工具的 diff 里。

经过 MindMax

1

suggest_edits

改动作为一份建议到达，带着它要改的那段原文。

2

修订标记

分组显示在你自己的文字上，每组附理由。

3

你接受或拒绝

你不点，一个字都不写盘。

新文件可以直接建；已有文档不会被覆盖，也没有删除。

## 这条连接的其他部分

只读，或者协作

每个连上的应用只处于两档之一：读与搜索，或者读加上建议、批注、新建文件。默认是协作——一个不能写入的资料库只是半个工具。

它在干活，你看得见

有应用在用你的资料库时，状态栏会点名显示。点开能看到最近的调用、临时暂停，或者断开——不用去翻配置文件。

事后读得到的会话

每个连上的应用在会话栏里有自己的一条：它调了什么、提了哪些建议、跑了哪次管线。这不是一份要解码的审计日志，就是你自己那些对话所在的同一个列表。

八个应用，各一条配置

Claude、Claude Code、Codex、ChatGPT、Gemini CLI、Cursor、Windsurf、WorkBuddy 会被检测出来，各自写进自己的配置，改之前先备份。WorkBuddy 之后还可能在授权上把它拦住：条目录在「连接器 → 自定义」下面，等你去打开。

文件夹自己会说明

工作空间里放一份说明文件，告诉编程 agent 这里的格式约定，以及新建文档和改动应当经过 MindMax。默认开着，且只在有外部 AI 连上时存在。

「/」菜单里现成的事

支持 prompts 的宿主会列出 MindMax 自己的方法：校对一份文档、拿你的资料库核对它的说法、处理等着回应的批注、用你的资料写一篇新的。

图解先体检再落地

图解会用编辑器同一套渲染器先画一遍，所以坏掉的代码块会作为错误退回给模型去修，而不是在你笔记里变成一块灰框。

交付成 Word 或 PDF

导出走 MindMax 自己的导出器，表格、可编辑公式、编号的来源都保留——和「导出」菜单产出的是同一份文件。

原来的连接器照旧可用把一份文档或一张思维导图从 claude.ai、ChatGPT 交接给[在线编辑器](https://mindmax.me/write/?utm_source=site_mcp&lang=zh-CN)的那套连接器没有变，仍然不需要桌面应用。这一页讲的是反方向：连上的应用对着你的文件夹干活。那边的说明在[从 Claude 和 ChatGPT 生成思维导图](https://mindmax.me/zh/docs/guides/mind-maps-from-claude-and-chatgpt/)。

## 连接是点一下的事，不是一份配置文件

应用会替你写进各个宿主自己的配置，先备份，并主动提出帮忙重启。万一某个宿主写不进去，它会给出那一行需要粘贴的内容——那是唯一需要你动手改文件的情况。

-

在 MindMax 里打开那个文件夹

外部应用能碰到的资料库，就是你打开着的那个工作空间；MindMax 在后台时，取最近打开的那个。

-

进「设置 → 外部 AI」

MindMax 已经找过这台电脑上装了哪些应用，逐个列出状态。

-

点「连接」

找到的应用一次全连上。不弹权限框、不选工作空间：协作档，最近打开过的全部工作空间。

-

该重启的，它会问你

Claude、ChatGPT、Cursor、Windsurf 需要重启，MindMax 直接给按钮。Claude Code、Codex 和 Gemini CLI 下一个会话就生效。

-

随口问一件平常的事

「用我的 MindMax 资料库，这几篇论文里的试验到底说明了什么？」状态栏会显示是哪个应用在读，回答里的引文点开就到原文那一页。

设置 → 外部 AI。装了哪些应用 MindMax 已经找好了；点「连接」就写进它自己的配置，旧的先备份。

## 从「把文件拖进聊天窗」过来，会变的是什么

大多数人到这里时，已经在把文档交给某个 agent 了。把这件事挪到自己的资料库上，变的是下面这些——包括聊天窗仍然赢的那几行。

| 对比项 | 一个带上传的聊天窗把文件拖进去、提问、下周重来一遍 | 在 MindMax 里 |
| --- | --- | --- |
| agent 能看到什么 | 你上传的那几份文件，一次对话一份。 | 工作空间里的每一份文件，MindMax 支持的格式都能搜、能读——一文件夹的论文、一整个书架、上个月的高亮。 |
| 整本书篇幅的文档 | 能在上传和上下文上限里活下来的那部分。长书通常被截断、抽样，或者直接拒收。 | 整本书的地图，然后按需把整节读回来。agent 是在导航，不是在扫读。 |
| 核对一个回答 | 一条你希望它抄对了的引文。 | 句柄由 MindMax 展开成逐字原文，带一个可以点开的锚点——落地之前已经和原文比对过。 |
| 你上个月标过的东西 | 跟着那次对话一起没了。 | 高亮、批注、书签 agent 都读得到，包括你给每种高亮颜色定的含义。 |
| 说清要改哪儿 | 用文字描述位置——「第三段」「讲试验的那块」——再把原文贴一遍以防说错。 | 在那几个字上写一句批注。agent 就改那一行，在批注里回你，下一轮从那条回复接着走。 |
| 对你文字的修改 | 一段重写好的内容，你自己复制回去。 | 落在你自己文字上的修订，分组附理由，一组一组接受或拒绝。 |
| 花谁的钱 | 一份把模型和存储都包了的订阅。 | 模型是你已经在付的那个，在你已经在用的应用里。连接本身 MindMax 不收钱，这条路径上也不跑 MindMax 的模型。 |
| 手机上问一个文件 | 开一个标签页、上传、提问。很难被打败。 | 这条连接连的是这台电脑上的桌面应用。手机上只处理一份文件的话，浏览器里的 MindMax Read 更短。 |
| 在借来的电脑上干活 | 什么都不用装。 | 资料库在你自己的机器上，所以这本来就是桌面的安排——没有一个云端副本可以让你登录。 |

## 哪里会不顺手

- 各个应用的支持程度不一样

Claude、Claude Code、Codex 和 ChatGPT 桌面版是端到端实测过的。Gemini CLI、Cursor、Windsurf、WorkBuddy 会被检测、会写好配置，第一次真实调用之后才显示为已连接。ChatGPT 桌面版和 Codex 共用同一条配置，连好之后要重启宿主；MindMax 会如实显示「已配置但还没调用过」，而不是声称它可用。

- 它不会让模型变聪明

思考是你那个应用所用的模型在做。弱模型配一张好地图仍然是弱模型；变的是它手上的材料、它能调用的工具，和它被允许对你的文件做什么。

- 读一整本书不免费——对你的应用而言

MindMax 这边不花额度，但 agent 读进去的每一页都是它自己上下文里的 token。一本书跑完整的阅读镜头，大致相当于把那本书读一遍，工具会在开跑前说明。

- 刻意不做覆盖写，也不做删除

外部应用不能整篇替换一份文档，也不能删掉它。这是有意的：一个带删除按钮的工具集，离「被一段提示注入清空文件夹」只差一步。要删，你自己在文件管理器里删。

- 目前只在本机

连接只监听 127.0.0.1，而且要求 MindMax 在运行——没运行的话它会在后台把应用拉起来。没有远程端点，所以跑在服务器上的 agent 到不了这个资料库。

- 扫描件仍然是扫描件

页面图能让 agent 看一眼它读不出文字的页面，识别也可以用 agent 自己的模型来跑，但质量取决于扫描本身。MindMax 会如实报告哪几页效果差，而不是把它们当干净的原文引用。

## 常见问题

### MindMax MCP 是什么？

MindMax MCP 是桌面应用里的一个本地 Model Context Protocol 服务。它让同一台电脑上的 AI 应用——Claude Code、Codex、Claude、ChatGPT、Gemini、Cursor、Windsurf、WorkBuddy——搜索你的文档、读完整篇论文和整本书、在画布上工作，并对你的稿子提修改建议。模型用那个应用自己的，工具、资料库和评审这一步由 MindMax 提供——模型正是通过调用这些工具，让任务成果和协作的质量更高。

### 连上 AI 应用会把我的文档上传吗？

不会。连接是应用内部 127.0.0.1 上的一个服务，调用它的应用在同一台机器上跟它说话。你的文件不会被复制到 MindMax，也不会到我们这边。真正离开这台电脑的，是那个应用发给它自己的模型服务商的内容——和你在它里面做别的事时一样。

### 这条连接花 MindMax 额度吗？

不花。这条路径上没有任何一处调用 MindMax 的模型，所以不消耗额度。读、写、推理都由你所连应用登录的模型完成，在那边计费。

### 能连哪些 AI 应用？

Claude、Claude Code、Codex、ChatGPT 桌面版、Gemini CLI、Cursor、Windsurf、WorkBuddy。MindMax 检测这台机器上装了哪些，一键写进它们的配置。其中 Claude、Claude Code、Codex 和 ChatGPT 桌面版是端到端实测过的，其余四个——Gemini CLI、Cursor、Windsurf、WorkBuddy——在第一次真实调用后确认。ChatGPT 桌面版与 Codex 共用同一条配置，连好之后需要重启。

### 连上的应用能改或删我的文档吗？

它能新建文档、往已有文档追加、移动或重命名文件，并对你写过的东西提修改建议——这些建议以修订的形式到达，由你接受或拒绝。它不能整篇覆盖一份文档，也不能删除；它写下的每一笔在版本历史里都署它的名字。

### 我可以只在要改的那一句上写批注吗？

可以，而且这是最短的一条路。在那一句上写批注，agent 读的是批注连同它压着的原文——不用数段落，也不用贴原文。它把改动提在那一行上，并在批注里回你；接受之后批注被标为完成。这条通道是双向的：要评审的话，它的意见也会落在页边等你。

### 能用我自己的模型或本地模型吗？

模型属于你连的那个应用。如果那个应用跑的是本地模型或你自己的 API key，整条路径都留在你的机器上——MindMax 不会替换成自己的模型。

### MindMax 关着的时候还能用吗？

能。第一次工具调用会在后台把 MindMax 拉起来，不抢焦点，然后等它就绪。拉不起来时，调用会明确告诉你去打开 MindMax，而不是静默失败。

### 能从服务器或手机连吗？

目前不能。服务只绑在 MindMax 所在机器的回环地址上，远程 agent 和手机都到不了。浏览器里处理单份文档有在线阅读器；整个文件夹只有桌面应用这一条路。

### 和 claude.ai 里的 MindMax 连接器有什么区别？

那些连接器是把一份文档或一张思维导图通过链接交给在线编辑器，不存任何东西。这里是反方向、也是更大的那一半：你电脑上的应用对着你真实的文件夹工作，多轮进行，用得上你已有的高亮、批注和文件。

### 遇到一本很长的书会怎样？

它会先拿到一张地图——两级结构、每章一句说明、每节一个 section id——然后由模型挑选章节，一次一整节读回来。一本 550 页的书，地图大约 1.2 万字符，足够 agent 导航，而不必逐页读完。

## 相关功能

[和外部 AI 应用一起工作一张能力地图：能要什么、由哪个工具接、结果落在哪里等你审。](https://mindmax.me/zh/docs/guides/working-with-an-external-ai-agent/)[连接一个 AI 应用一键连接的路径、两个权限档位，以及应用没出现时该查什么。](https://mindmax.me/zh/docs/getting-started/connect-an-ai-agent/)[agent 能调用的工具按访问档分组的全部工具，从 search_knowledge 到 export_document。](https://mindmax.me/zh/docs/reference/agent-tools/)[在 AI 应用里问你的资料库一条走通的路径：跨书架提问、按地图读一本书、写一篇带引文的稿子、审一次它提的改动。](https://mindmax.me/zh/use-cases/ask-your-ai-app-about-your-library/)[在页边改稿，一条批注一处改动批注写在出错的那一句上，改动回到那一句，下一轮从线程接着走。](https://mindmax.me/zh/use-cases/revise-in-the-margin/)[AI 思维导图画布agent 往里加卡片时写在哪里，以及那些卡片之后还能承载什么。](https://mindmax.me/zh/features/canvas/)[改动等你点头为什么对你文字的修改会带着标记到达，以及「接受」到底写入了什么。](https://mindmax.me/zh/concepts/edits-wait-for-you/)[什么是模型上下文协议（MCP）这条连接背后的标准，用人话讲一遍，以及它在哪些地方不管用。](https://mindmax.me/zh/glossary/model-context-protocol/)

博客文章

- [你的 agent 不缺上传，缺一座自带地图的资料库](https://mindmax.me/zh/blog/agent-with-a-library/)
- [别再说“第三段”](https://mindmax.me/zh/blog/the-margin-is-not-a-chat/)
- [标一句、递一句、审一次](https://mindmax.me/zh/blog/mark-hand-off-review/)

## 把你已经在用的 AI 应用，接到你已经有的文件夹上。

[下载](https://mindmax.me/zh/download/)[价格](https://mindmax.me/zh/pricing/)

连接本身不花额度：动脑的是你连的那个应用，用它自己的模型。
