最后更新于 2026年11月7日。
可以实现什么
Adam Coddington 开发的社区插件 Local REST API with MCP 内置了一个在 Obsidian 内运行的 MCP 服务器。其 README 说明,该服务器使用 Streamable HTTP 传输方式,并需要 API 密钥。AskWatch 通过 Streamable HTTP 连接您输入地址的 MCP 服务器。
- Mac 必须保持开机。插件在桌面版 Obsidian 内运行,因此,无论使用哪种连接方式,都必须在 Mac 上打开 Obsidian 并启用该插件。下方步骤中的地址 127.0.0.1 始终指您当前使用的计算机。因此,这些步骤适用于运行 Obsidian 的 Mac 上的 AskWatch,不适用于 iPhone、iPad 或 Apple Watch。另一种通过 Tailscale 的连接方式可让 iPhone 或 iPad 访问它。
- 操作笔记的工具。该插件列出的工具可读取、搜索、创建、修改、移动和删除笔记,以及执行 Obsidian 命令。
- 社区软件。该插件并非由 Obsidian 或 AskWatch 开发。AskWatch 尚未测试该插件。
所需条件
- Mac 上安装了 AskWatch,且其设置中有 MCP 服务器 选项卡。
- 同一台 Mac 上安装了 Obsidian,并已开启社区插件。Obsidian 仅在 Restricted mode 关闭时运行社区插件。请先阅读 Obsidian 的插件安全说明:其中指出,社区插件可以访问您计算机上的文件。
- 已从 Obsidian 的社区插件中安装并启用 Local REST API with MCP 插件。该插件已收录在 Obsidian 插件目录中。
- 该插件的 API 密钥,可在 Obsidian 的 Settings → Local REST API 中查看。
操作步骤
- 在 Obsidian 中开启社区插件,安装 Local REST API with MCP 并启用。
- 在 Obsidian 中打开 Settings → Local REST API。复制 API 密钥,然后开启 Enable HTTP server。README 说明,开启此开关即可使用插件的明文 HTTP 地址。
- 在 Mac 上的 AskWatch 中打开 设置,进入 MCP 服务器 选项卡,选择 添加 MCP 服务器,然后选择 按地址添加。
- 在 服务器名称 下输入任意名称。在 服务器 URL 下输入
http://127.0.0.1:27123/mcp/。将 身份验证 设为 Bearer 令牌,并将 API 密钥粘贴到 Bearer 令牌 字段中。然后选择 添加并测试服务器。 - 由于地址以 http 开头,AskWatch 会先显示 未加密的 MCP 连接 警告。请阅读警告,开启 我了解风险,然后选择 我已了解 — 继续。
- 随后,AskWatch 会向服务器请求工具列表。此次设置过程中发现的每个工具,初始设置均为 每次都提问。
Obsidian 和插件中的名称均按插件 README 中的写法以英文显示。
https 地址
该插件也提供 https://127.0.0.1:27124/mcp/。其证书由插件自行创建的证书颁发机构签发,README 说明客户端必须信任该机构。AskWatch 的 MCP 连接代码没有针对 macOS 不信任的证书设置例外。除非您已让 macOS 信任该插件的证书颁发机构,否则请使用 http 地址。我们尚未尝试 https 地址。
在 iPhone 或 iPad 上
除非您更改插件的 Binding host 设置,否则它只在 Mac 本机上监听。对于 iPhone 或 iPad,地址必须能通过网络访问 Mac,因此这是另一种连接方式,设置也更复杂。下表中的每种连接方式,AskWatch 都未尝试过。命令和设置均来自相关产品的官方文档。
开启同步后,AskWatch 会将您添加的 MCP 服务器及其地址同步到您的其他设备。tailnet 中的地址在每台设备上都相同。127.0.0.1 始终指使用该地址的设备本身,因此,在 Mac 上使用该地址添加的服务器无法让 iPhone 访问 Obsidian。
哪些连接方式可用,取决于 AskWatch 能发送哪些内容。按地址添加 表单提供 无、Bearer 令牌 和 OAuth 登录 选项。表单中没有用于填写额外请求头的字段。
我们找到的所有连接方式
以下连接方式可供其他设备访问 Mac 上的插件,内容来自所列产品的文档,并说明了 AskWatch 目前能否使用。
| 连接方式 | iPhone 和 iPad | 谁能访问笔记库工具 | 需要设置什么 | 我们的看法 | AskWatch 目前能否使用 |
|---|---|---|---|---|---|
仅限 Mac 本机,地址为 127.0.0.1(步骤见上文) | 否 | 该 Mac 上的程序 | 插件及其 HTTP 服务器开关 | 最简单的连接方式。其他设备均无法连接。 | 可以。AskWatch 未尝试过。 |
| Tailscale Serve(步骤见下文) | 可以,需要在 Tailscale 应用中登录同一个 tailnet | 您的 tailnet 中获 Tailscale 访问规则允许的设备 | 在两台设备上安装 Tailscale,在管理控制台中启用 HTTPS,在 Mac 上运行一条命令 | 一种私有连接方式。请将工具保持设置为每次都提问。 | 可以,使用以 ts.net 结尾的 https 地址。AskWatch 未尝试过。 |
| Tailscale Funnel | 可以 | 互联网上的任何人 | 在 Mac 上运行一条命令 | 不推荐。对于能够写入和删除笔记的工具,插件的 API 密钥将是唯一的保护。 | AskWatch 可以接受 https 地址,但我们不推荐这种连接方式,也不提供操作步骤。 |
| 单独使用 Cloudflare Tunnel,配置公共主机名 | 可以 | 互联网上能访问该主机名的任何人 | 一个托管在 Cloudflare 上的域名、Mac 上的 cloudflared,以及插件的公共主机名 | 不推荐。对于能够写入和删除笔记的工具,插件的 API 密钥将是唯一的保护。 | AskWatch 可以接受 https 地址,但我们不推荐这种连接方式,也不提供操作步骤。 |
| Cloudflare Tunnel 配合 Cloudflare Access 和服务令牌 | 可以 | 仅限携带服务令牌的请求 | 一个托管在 Cloudflare 上的域名、一条隧道、一个配置了 Service Auth 策略的 Access 应用,以及一个服务令牌 | 这种方式可实现私有访问,但 AskWatch 无法发送该令牌。 | 不可以。目前无法使用:“按地址添加”表单和 MCP 连接都没有用于填写请求头 CF-Access-Client-Id 和 CF-Access-Client-Secret 的字段。计划提供支持。 |
| Cloudflare Tunnel 配合 Cloudflare Access 和登录验证(Managed OAuth) | 可以 | 您的 Access 策略允许的人员 | 与上一行相同,并为 Access 应用开启 Managed OAuth | 这种方式可实现私有访问,但我们不知道它是否可行。 | 尚不清楚。插件要求在 Authorization 请求头中提供其自身的 API 密钥,而 AskWatch 只发送一个 Authorization 值,因此我们看不出如何同时发送两者。AskWatch 未尝试过。 |
| Cloudflare 私有网络,在 iPhone 或 iPad 上使用 Cloudflare One Client | 可以,需要使用 Cloudflare One Agent 应用 | 已注册到您的 Cloudflare Zero Trust 组织的设备 | 一个 Zero Trust 组织、一个连接器和一条路由,以及设备上的应用 | 原则上可实现私有访问。 | 尚不清楚。在我们阅读的页面中,没有找到这种连接方式如何访问仅在 127.0.0.1 上监听的服务,因此我们不提供操作步骤。 |
| Mac 在家庭网络中的地址 | 可以,需要连接同一个网络 | 该网络上的每台设备 | 将插件的 Binding host 设置为 Mac 的地址 | 不推荐。连接使用未加密的 http,且网络上的每台设备都能访问插件。 | AskWatch 接受使用未加密 http 的私有地址,并显示未加密的 MCP 连接警告。我们不提供操作步骤。 |
Tailscale Serve 操作步骤
只有在您接受以下情况时,才应使用这些步骤:AskWatch 未尝试过这些步骤,且您的 Tailscale 规则允许的每台设备都能访问插件。
- 在 Mac 和 iPhone 或 iPad 上安装 Tailscale,并在两端登录同一个 tailnet。在 iOS 上,应用会请求安装 VPN 配置。使用工具期间,请让 iPhone 或 iPad 上的 Tailscale 保持连接。
- 在 Tailscale 管理控制台中打开 DNS 页面,如果 MagicDNS 尚未开启,请将其开启,然后在 HTTPS Certificates 下选择 Enable HTTPS。Tailscale 提醒您,此操作会将您的设备名称和 tailnet 名称公布在公开的证书记录中,因此,如果设备名称包含敏感信息,请勿启用。
- 在 Obsidian 中确认 Enable HTTP server 已开启,与上文第 2 步相同。插件仍然只在 127.0.0.1 上监听。
- 在 Mac 的终端中运行
tailscale serve --bg http://127.0.0.1:27123。Tailscale 会输出一个形如https://device-name.tailnet-name.ts.net的地址。运行tailscale serve status可再次查看该地址,运行tailscale serve reset可关闭服务共享。 - 在 iPhone 或 iPad 上的 AskWatch 中,依次打开设置、MCP 服务器和管理 MCP 服务器。选择添加 MCP 服务器,然后选择按地址添加。
- 在服务器名称下输入任意名称。在服务器 URL下输入上一条命令输出的地址,并在末尾加上
/mcp/,例如https://device-name.tailnet-name.ts.net/mcp/。将身份验证设置为Bearer 令牌,粘贴插件的 API 密钥,然后选择添加并测试服务器。地址以 https 开头,因此 AskWatch 不会显示连接未加密的警告。
Tailscale 从公共证书颁发机构 Let's Encrypt 获取证书,因此您无需手动信任证书。我们尚未在设备上核实这一点。
请勿为此使用 tailscale funnel。Tailscale 将 tailscale serve 描述为在您的 tailnet 内共享服务,将 tailscale funnel 描述为通过互联网共享服务,向所有人开放。
Tailscale 的访问规则对 Serve 的适用方式与其他服务相同,共享到您的 tailnet 中的设备也能访问它。仍然需要提供插件自身的 API 密钥。请将工具保持设置为每次都提问。
允许工具操作笔记之前
- 该插件的工具可以写入、移动和删除笔记,并执行任意 Obsidian 命令。在 AskWatch 中,每个工具都可以设为 关闭、每次都提问 或 运行时不询问。
- 请将工具保持为 每次都提问。对于服务器未标记为只读的工具,AskWatch 会先显示警告,之后才允许设为 运行时不询问。
- 工具返回的内容会成为对话的一部分,因此会发送给您选择的 AI 服务提供商。该插件的 README 说明,结果通常会直接进入模型的上下文。
- 根据 README,该插件通过 API 密钥控制访问。请妥善保管密钥,不要让互联网能够访问该插件的端口。
- AskWatch 会将密钥保存为钥匙串中的一个项目,该项目可通过 iCloud Keychain 同步到您的其他设备。
如果无法使用
- 请检查 Obsidian 是否已打开、插件是否已启用、Enable HTTP server 是否已开启,以及地址是否与
http://127.0.0.1:27123/mcp/完全一致,包括端口和末尾的斜杠。 - 请检查您粘贴的是否为插件当前的 API 密钥。根据 README,如果在 1 分钟内出现 10 次错误密钥,插件会拒绝后续的错误密钥,直到该分钟结束。
- 另一个社区选项是 cyanheads 开发的 obsidian-mcp-server,它也通过同一个插件工作。其 README 说明,它支持 STDIO 或 Streamable HTTP,默认以 STDIO 方式运行,在 HTTP 模式(
MCP_TRANSPORT_TYPE=http)下监听http://127.0.0.1:3010/mcp。AskWatch 只能使用服务器的 HTTP 模式。该插件的 README 说明,已不再需要第三方服务器。我们也尚未尝试这个选项。 - 我们无法保证此方案能够正常工作,也无法修复第三方插件。如果插件出现问题,请向其问题跟踪页面报告。
我们尚未验证的事项
- AskWatch 团队中尚未有人将 AskWatch 连接到此插件。我们不知道对该插件执行 添加并测试服务器 是否会成功。
- 从文档来看,双方支持部分相同的协议修订版本:AskWatch 支持 MCP 修订版本 2026-07-28、2025-11-25、2025-06-18 和 2025-03-26;插件的 README 说明,其服务器支持 2026-07-28,以及 2024-10-07 至 2025-11-25 的修订版本。我们尚未尝试。
- 我们尚未尝试 https 地址,也尚未尝试任何其他 Obsidian 插件或服务器。
- 该插件和 Obsidian 都可能发生变化。本页面依据的是插件 5.5.2 版本的 README,该版本发布于 2026年10月17日,我们于 2026年11月7日阅读了该文档。
- 我们未尝试过任何适用于 iPhone 或 iPad 的连接方式,包括 Tailscale 和表中的其他方式。命令和设置来自我们于 2026 年 11 月 7 日阅读的 Tailscale 和 Cloudflare 文档。
第三方声明
Obsidian、Tailscale 和 Cloudflare 均为第三方产品。AskWatch 与 Obsidian、Tailscale 或 Cloudflare 无关联,也未获得其认可。其名称和商标归各自所有者所有。
参考来源
均于 2026年11月7日阅读。
- Local REST API with MCP:GitHub 上的 README
- Obsidian:插件安全
- Obsidian 插件目录:Local REST API with MCP
- cyanheads/obsidian-mcp-server:GitHub 上的 README
- RFC 1122,第 3.2.1.3 节:127 回环地址
- Tailscale:tailscale serve 命令
- Tailscale:Tailscale Serve
- Tailscale:tailscale funnel 命令
- Tailscale:启用 HTTPS
- Tailscale:在 iOS 上安装 Tailscale
- Cloudflare:用于公共应用的 Tunnel
- Cloudflare:Universal SSL 证书
- Cloudflare:Access 服务令牌
- Cloudflare:Access 策略
- Cloudflare:Managed OAuth
- Cloudflare:私有网络
- Cloudflare:Cloudflare One Client 下载
- Local REST API with MCP:包含默认绑定主机的源文件