用 MCP 让 Claude Code 开工前先读到你的习惯和笔记
每次新开会话，不用再重讲技术栈、提交规范和项目背景。连上之后，Codex、Claude Code、Hermes 会读取你在 Foremind 里允许分享的协作习惯、笔记、待办和人生图谱；你在授权页勾选了写入权限，它也能把结果写回来，每一次改动都能撤销。
- 协作约定
- 工具偏好
- 允许的笔记
- 网页剪藏
- 待办事项
- 人生图谱
不再向 AI 编程助手重复自我介绍
写代码的上下文不应该每次都从零搭建。连上 Foremind 之后，助手开工前先读你允许分享的工作习惯。
新会话开始时的空白记忆
每一次启动新的 Claude Code 或 Codex 终端会话，你都需要重新敲打一遍熟悉的段落：正在使用的编程语言版本、代码格式规范、测试框架偏好，以及当前项目的业务背景。一旦关闭终端，这些背景信息再次消失。
在知识库与终端之间手动搬运
架构决策、接口约定和需求说明沉淀在日常笔记里。为了让助手写出符合预期的逻辑，你只能切到知识库，手动找到对应段落，复制并粘贴进终端。长段文本不仅占用操作时间，还容易遗漏关联的上下文。
开箱即用的个性化协作
连入 Foremind 之后，你在终端中提出需求，助手开工前会自动读取你允许分享的协作约定与工具偏好。当它需要相关设计时，会通过接口直接调取对应笔记与待办。你不需要再粘贴任何文本，它开工前已经读过你的习惯。
能读什么、能改什么，都由你勾选
助手能读的，只有你允许分享的个人信息类别和没有排除的文件夹。要不要让它创建、修改或删除笔记和待办，在授权页逐项勾选；它做过的每一次改动都记在「外部修改记录」里，可以撤销。主对话记录和说说始终不开放，你随时可以断开。
四步完成外部助手连接
不用自己找 API 密钥，也不用输入密码。授权在浏览器里完成，你看清它要哪些权限再点「允许」。
设置分享范围与排除文件夹
登录 Foremind 并进入「设置 → 外部助手」。检查「允许分享的个人信息」，默认开启沟通习惯、沟通偏好、使用工具和正在推进的事项。你可以将保密文件夹加入「不分享的文件夹」，其所有子文件夹也会自动排除。
复制安装提示词并发送
在外部助手设置页点击「复制安装提示词」，将整段内容发送给 Codex、Claude Code 或 Hermes。提示词里已经有你这个账号对应的服务地址和安装命令，助手只运行它自己的命令，你不用手动拼参数。
已包含你的服务地址和安装命令
在浏览器中核对并点击允许
助手启动连接后，会自动打开 Foremind 授权网页。核对助手的名字和它申请的权限，不想给的取消勾选，用要分享资料的那个 Foremind 账号登录，再亲手点「允许」。
重载会话并验证读取
当授权页面提示「已连接」后，回到终端重新加载 MCP 或新起会话。让助手查询一项你允许分享的内容以验证连接。助手只会确认连接名称与范围，不会重复倾倒你的个人信息。
支持主流 AI 编程助手客户端
Foremind 支持 Codex MCP、Claude Code MCP 与 Hermes。添加连接的命令中包含匹配的实际服务地址，请直接从安装提示词中复制。
检查当前连接状态并完成 OAuth 浏览器授权：
添加连接的具体命令由复制的安装提示词提供。完成授权后，通过 get_user_context 即可检索允许分享的个人上下文。
Codex 客户端检查与授权登录：
在纯终端无图形界面服务器上，复制打印出的网址到本地浏览器完成点击允许即可。
Hermes 客户端检查与授权指令：
安装提示词还会问你：把 Foremind 的使用约定保存给所有项目，还是只给当前项目。这一步只保存约定，不会把本地记忆导入 Foremind。
读什么、写什么，逐项由你决定
外部助手只在你授权的范围里读写。它改过的每一处，都能在「外部修改记录」里撤销。
在你的授权下可以读的内容
- 沟通习惯与沟通偏好 你习惯怎么沟通、喜欢什么样的回复。
- 使用的工具与正在推进的事项 你常用的工具，以及眼下在推进的事。
- 允许范围内的笔记与网页剪藏 位于未排除文件夹中的技术方案、架构草稿和资料剪藏。
- 待办事项与人生图谱 你的待办，以及人生图谱里的目标和路线。
- 对话沉淀笔记（需单独开启） 由主对话和议事厅沉淀的笔记默认关闭，需显式打开开关才可检索。
不开放的内容，和没给的权限
- 主对话记录与个人说说 主对话记录和说说始终不对外部助手开放。
- 不分享的文件夹及子文件夹 加入排除列表的目录无法被搜索或读取，子文件夹同样自动继承屏蔽。
- 你没有勾选的权限 授权页上没勾选的创建、修改、删除权限，它都用不了。之后也能在设置里改，不用重新连接。
- 没经你确认的个人事实 助手可以把协作经验记进「协作记忆」；涉及你个人的事实，要你确认后才保存。
- 超出电脑权限的操作 主对话派出的外部任务，各自带着你定的电脑权限：只读、只写任务文件夹，或可写指定项目。
随时一键断开连接
在「设置 → 外部助手」的「已连接的助手」里找到它，点「断开」，权限立即终止。断开前它已经收到的内容无法撤回。
常见做法与 Foremind MCP 的对比
对比日常开发中维护 AI 提示词的方式，体验结构化个人上下文带来的效率改变。
| 维度 | 常见做法 | Foremind |
|---|---|---|
| 每次新开会话 | 把技术栈、习惯和项目背景重讲一遍 | 助手开工前读取你允许分享的协作约定 |
| 项目资料 | 手动复制粘贴进对话框 | 助手按需读取你允许的笔记、剪藏、待办和人生图谱 |
| 几个助手 | 每个工具各写一份说明 | Codex、Claude Code、Hermes 连到同一个 Foremind，读同一份你允许的资料 |
| 授权方式 | 到处复制密钥 | 在浏览器里核对范围后点「允许」，不用自己找密钥 |
| 隐私边界 | 不清楚它能看到什么 | 按类别和文件夹决定范围，主对话记录和说说始终不开放 |
| 不用了 | 手动删配置 | 在设置里点「断开」，权限立即终止 |
常见问题解答
关于 MCP 连接、权限控制、指令配置与排查的详细说明。
Claude Code 怎么通过 MCP 读取我在 Foremind 里的笔记？
在 Foremind 的「设置 → 外部助手」中勾选允许分享的笔记范围与文件夹，点击「复制安装提示词」并将整段文字发送给 Claude Code。Claude Code 运行安装指令后会自动拉起浏览器授权页面。在浏览器中核对权限范围并登录对应账户，点击「允许」完成授权。连接成功后重载当前会话，Claude Code 就能检索你允许分享的笔记与资料。
连接以后，外部助手能修改我的资料吗？
只有你在授权页勾选了对应权限才能，比如「创建和修改笔记」「创建和修改待办」「删除笔记」。它做过的每一次改动都记在「设置 → 外部助手」的「外部修改记录」里，点「撤销修改」就能恢复改动前的内容。权限之后也能在设置里调整，不用重新连接。
需要自己填 API 密钥或者密码吗？
不需要。Foremind 采用基于 OAuth 的浏览器授权模式。安装提示词中已经内置了你的服务地址和专属安装指令，你不需要手动寻找 API 密钥，也不需要在终端中输入任何密码。授权过程完全在浏览器安全页面中完成。
Codex 和 Hermes 也能连吗？命令是什么？
可以。Codex 和 Hermes 均支持通过标准 MCP 协议连接 Foremind。Codex 检查状态指令为 codex mcp list，授权指令为 codex mcp login foremind --oauth-client-registration dcr，在无图形界面终端中可追加 --no-browser 参数并在打印出的网址中完成授权。Hermes 检查状态指令为 hermes mcp list，授权指令为 hermes mcp login foremind。
外部助手能看到我的聊天记录吗？
不能。你的主对话历史记录以及个人说说永远不会对外部助手开放。由主对话和议事厅沉淀生成的笔记默认处于关闭状态，只有在设置中单独开启对应开关后才允许外部助手读取。
怎么不让它读某个文件夹？
在「设置 → 外部助手」中，找到「不分享的文件夹」设置项，将需要保密的文件夹添加进去即可。被添加的文件夹及其包含的所有子文件夹都会被彻底排除，外部助手无法检索或读取其中的任何笔记。
怎么断开？断开以后它之前读到的内容怎么办？
打开 Foremind「设置 → 外部助手」，在「已连接的助手」列表中找到对应的外部助手，点击「断开」即可。断开后它的权限立即终止，之前已经收到的内容无法撤回。
连上了，但当前会话里没有 Foremind 的工具，怎么办？
请在终端的助手中重新加载 MCP 配置，或者完全退出并开启一个全新的终端会话。如果依然没有显示，请检查授权页面是否顺利完成，或在设置页面重新确认连接状态。
连接状态与常见异常排查
遇到授权中断或内容未显示时，根据具体提示快速恢复正常连通。
提示「请求已过期」或「连接被拒绝」
从外部助手中重新发起登录流程，并使用新打开的浏览器页面完成授权确认。不要使用之前过期的授权标签页。
页面状态显示「尚未确认」
检查终端里的助手是否已经输出登录成功的确认消息。确认终端提示成功后，点击 Foremind 授权页面上的「重新检查」按钮。
显示已连接但会话中缺少工具
在终端客户端中重载 MCP，或者完全关闭当前会话并开启新窗口。新会话启动时会自动加载已注册的工具列表。
已连接但某篇笔记或分类缺失
核对当前登录的 Foremind 账号是否一致，检查个人信息开关与不分享的文件夹设置。主对话与议事厅笔记需单独开启开关。
探索 Foremind 的其他核心能力
外部助手读取的丰富上下文，正来自于 Foremind 内部紧密咬合的系统能力。