如何通过 MCP 将 Obsidian 连接到 YouMind
你的 Obsidian 知识库可能已经包含了下一个项目所需的一切：研究资料、计划、阅读笔记和未完成的任务。将其连接到 YouMind，你就可以通过一个自然语言请求，把这些笔记变成可用的内容。
在本指南中，你将把一个本地的 Obsidian 知识库连接到 YouMind，让 YouMind 读取并整理一组笔记，然后将结果保存回 Obsidian。示例使用了五篇关于抗炎饮食的笔记，来创建一个包含原始来源链接的行动计划。
开始之前
你需要准备：
- Obsidian 桌面版以及一个你可以编辑的知识库。
- 一个有权访问自定义连接器的 YouMind 账户。
- 一个 ngrok 账户。我们将使用 ngrok 为你的本地 MCP 服务器提供一个 YouMind 可以访问的 HTTPS 地址。
- 一些可供操作的笔记。你可以使用自己的研究、项目笔记或膳食计划笔记。
连接的工作原理如下：
YouMind → ngrok HTTPS 地址 → MCP 连接器 → 你的 Obsidian 知识库
MCP，即模型上下文协议（Model Context Protocol），允许 AI 应用使用另一个应用提供的工具。Obsidian 插件提供了用于操作知识库的工具，YouMind 则使用这些工具来执行你的请求。
在使用此连接时，请保持你的电脑处于唤醒状态并连接网络，同时保持 Obsidian、已连接的知识库和 ngrok 处于运行状态。本地地址 127.0.0.1 仅指向你自己的电脑，因此 YouMind 需要 ngrok 地址才能访问它。
该连接器可以根据你授予的权限读取或修改笔记。请保管好它的令牌，并使用插件的工具权限和隐藏文件夹设置来控制访问权限。任务中使用的内容会经过 ngrok 和 YouMind；连接一个知识库并不会自动同步整个知识库。
截图展示了 macOS 上的工作流程。部分账户详情已被移除或替换为示例值。
1. 在 Obsidian 中允许社区插件
在 Obsidian 中打开 设置 → 社区插件。
如果你的知识库处于限制模式，请点击 退出限制模式 以允许社区插件。
点击 浏览 打开社区插件目录。
2. 安装并启用 MCP Connector
搜索 MCP Connector，然后选择由 istefox 开发的插件。请确认作者的名字，因为目录中可能包含名称相似的插件。
打开其详情页并点击 安装。
安装完成后，点击 启用。
在 Obsidian 的设置中打开 MCP Connector，以配置其本地服务器和访问令牌。你可以在插件的目录页面上找到更多信息。
3. 设置固定的服务器端口
找到 固定端口，输入 27200，然后点击 保存。
服务器端口 部分现在应显示：
http://127.0.0.1:27200/mcp
固定的端口可以确保你的 ngrok 连接始终指向同一个本地服务。如果端口 27200 已被占用，请选择一个可用的端口，并在下面的 ngrok 命令中使用该端口号。
4. 为 YouMind 创建一个令牌
在 访问控制 中，点击 添加令牌。
将新令牌命名为 YouMind，以便日后识别。
点击该令牌所在行的 复制 按钮。你将在后续步骤中将其粘贴到 YouMind 中。
每个令牌可以拥有独立的工具权限。本示例需要读取笔记和创建新笔记的权限。截图使用了插件的 所有 52 个工具 配置；可用工具的数量可能因插件版本和你的设置而异。
请像对待密码一样对待这个令牌，因为它授予了相应的访问权限。你不需要将其粘贴到 AI 聊天中。
5. 启动一个 ngrok 隧道
如果你尚未安装 ngrok，请遵循官方设置指南。在 macOS 上，如果你已经使用 Homebrew，可以通过以下命令安装：
brew install ngrok
添加来自你 ngrok 仪表盘的 authtoken：
ngrok config add-authtoken YOUR_NGROK_AUTHTOKEN
ngrok authtoken 用于将 ngrok 连接到你的账户。上一步中的 Obsidian 令牌则赋予 YouMind 访问你知识库的权限。请将这两个凭证分开保管。
在终端中运行：
ngrok httphttp://127.0.0.1:27200
保持此终端会话运行。一旦 Session Status 显示为 online，请复制 Forwarding 行中显示的 HTTPS 地址。
在该地址末尾添加 /mcp。你最终的连接器 URL 应具有以下结构：
https://YOUR_NGROK_DOMAIN/mcp
请使用你 ngrok 会话中显示的实际域名。截图中的域名仅为示例。如果你的转发地址之后发生变化，也需要在 YouMind 中更新保存的地址。
6. 在 YouMind 中添加自定义连接器
在 YouMind 中，打开 设置 → 连接器，然后点击 添加自定义连接器。
输入一个名称，例如 obsidian，并将你的 ngrok 地址（末尾带 /mcp）粘贴进去。展开 高级设置。在 自定义参数 下，点击 添加参数 并进行如下配置：
设置 | 值 |
|---|---|
名称 |
|
服务器 URL | 你的 ngrok HTTPS 地址，后跟 |
OAuth 客户端 ID | 留空 |
OAuth 客户端密钥 | 留空 |
自定义参数 |
|
参数值 |
|
密钥 | 开启 |
将 YOUR_OBSIDIAN_TOKEN 替换为你从 Obsidian 复制的完整令牌。确保在 **Bearer** 后面包含一个空格。 例如，如果你的令牌是 example-token，则该值应为：
Bearer example-token
这只是一个格式示例。请在实际配置中使用你自己的令牌。此连接使用 Bearer Token 认证，因此请将两个 OAuth 字段留空。
点击 添加，然后在连接器列表中找到 obsidian 并点击 连接。
你应该会看到其名称旁边显示 已连接。
现在，让我们通过一个读取笔记并写入新笔记的任务来检查连接。
7. 准备几篇相关的笔记
YouMind 需要实际的内容来操作。在本示例中，知识库包含五篇英文笔记：
笔记 | 内容 |
|---|---|
抗炎饮食基础 | 一般饮食原则和第一周的目标 |
抗炎购物清单 | 购物清单和食材替代品 |
7 天抗炎膳食计划 | 一周的早餐、午餐和晚餐 |
简单的抗炎备餐 | 准备步骤、简单食谱和储存说明 |
抗炎每周回顾 | 回顾模板和未完成的后续任务 |
这些笔记是用于演示工作流程的示例材料。它们并非个性化的医疗或营养计划。
你可以使用不同的主题。例如，将阅读笔记整合成学习指南，将项目笔记转化为下一步行动清单，或将旅行研究整理成行程计划。根据你知识库中的笔记，更新提示中的主题。
8. 让 YouMind 读取、整理并保存
在 YouMind 中开始一个新任务，并输入：
Review my Obsidian notes about anti-inflammatory eating. Summarize the key principles, connect the grocery list with the meal plan, and identify three outstanding tasks.
Save the result in English as a new Obsidian note titled "Anti-Inflammatory Eating Action Plan", with internal links to the source notes.
该提示告诉 YouMind 要读取哪些笔记、如何组织信息、要识别哪些任务，以及将结果保存到哪里。它还指定了新笔记的名称，并要求包含指向来源的链接，这使得输出结果易于核查。
提交任务。YouMind 将使用连接器查找并读取相关的笔记，然后整合结果。你可以在对话中跟踪其进度。
9. 在 Obsidian 中打开新笔记
在本示例中，YouMind 返回了：
- 入门笔记中原则的摘要。
- 购物清单与膳食计划之间的关联，包括哪些食材出现在多餐中。
- 三项未完成的任务：计划购物行程、选择午餐和备餐时间，以及之后完成回顾。
- 一篇名为 抗炎饮食行动计划 的新笔记，其中包含指向原始五篇笔记的内部链接。
所有待办事项已完成 指的是 YouMind 的读取、整理和写入任务。购物和备餐仍然是使用该计划的人需要执行的后续行动。
切换回 Obsidian，打开 抗炎饮食行动计划。
新笔记出现在文件列表中，其内容已保存到你的知识库中。在此次运行中，它还包含了标签和指向原始笔记的可点击链接。图谱视图显示了这些连接以及现有的笔记。
你现在可以继续在 Obsidian 中进行编辑，或者让 YouMind 根据更具体的要求继续操作，例如展开某个部分或使用另一篇笔记更新计划。
故障排除
为什么我看到 401 Unauthorized？
检查 Authorization 参数。其值必须是 Bearer，后跟一个空格和你的完整 Obsidian 令牌。确保你从 MCP Connector 复制了令牌。如果你重新生成或撤销了它，请在 YouMind 中更新该值。
为什么我看到 "OAuth authorization server metadata discovery failed (404)"？
令牌检查失败可能导致客户端尝试进行 OAuth 发现。此插件连接使用 Bearer Token，因此请首先检查 Authorization 标头，并确保 OAuth 客户端 ID 和密钥字段留空。缺少 Bearer 前缀可能会产生此错误。
为什么在浏览器中打开 /mcp URL 会返回 405？
该插件的 MCP 端点通过 POST 请求接受 MCP 请求。在浏览器的地址栏中打开 URL 通常会发送 GET 请求，这可能会返回 405 Method Not Allowed。请通过 YouMind 和一个实际任务来验证连接。
为什么一个正常工作的连接停止响应了？
检查你的电脑是否处于唤醒状态并在线，Obsidian 是否打开了正确的知识库，插件是否已启用，以及 ngrok 是否仍显示 online。然后，将本地端口和 ngrok URL 与 YouMind 中保存的值进行比较。
如果我找不到新笔记怎么办？
在已连接的知识库中搜索你在提示中指定的标题。检查令牌是否允许创建笔记。你也可以让 YouMind 提供它创建的文件的精确知识库相对路径，然后在 Obsidian 中打开该路径。
准备好用你自己的笔记试试了吗？打开 YouMind，让它把几篇相关的笔记变成你知识库中一个有用的新页面。