首页 支持 隐私 媒体

最后更新于 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 中查看。

操作步骤

  1. 在 Obsidian 中开启社区插件,安装 Local REST API with MCP 并启用。
  2. 在 Obsidian 中打开 Settings → Local REST API。复制 API 密钥,然后开启 Enable HTTP server。README 说明,开启此开关即可使用插件的明文 HTTP 地址。
  3. 在 Mac 上的 AskWatch 中打开 设置,进入 MCP 服务器 选项卡,选择 添加 MCP 服务器,然后选择 按地址添加。
  4. 在 服务器名称 下输入任意名称。在 服务器 URL 下输入 http://127.0.0.1:27123/mcp/。将 身份验证 设为 Bearer 令牌,并将 API 密钥粘贴到 Bearer 令牌 字段中。然后选择 添加并测试服务器。
  5. 由于地址以 http 开头,AskWatch 会先显示 未加密的 MCP 连接 警告。请阅读警告,开启 我了解风险,然后选择 我已了解 — 继续。
  6. 随后,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 规则允许的每台设备都能访问插件。

  1. 在 Mac 和 iPhone 或 iPad 上安装 Tailscale,并在两端登录同一个 tailnet。在 iOS 上,应用会请求安装 VPN 配置。使用工具期间,请让 iPhone 或 iPad 上的 Tailscale 保持连接。
  2. 在 Tailscale 管理控制台中打开 DNS 页面,如果 MagicDNS 尚未开启,请将其开启,然后在 HTTPS Certificates 下选择 Enable HTTPS。Tailscale 提醒您,此操作会将您的设备名称和 tailnet 名称公布在公开的证书记录中,因此,如果设备名称包含敏感信息,请勿启用。
  3. 在 Obsidian 中确认 Enable HTTP server 已开启,与上文第 2 步相同。插件仍然只在 127.0.0.1 上监听。
  4. 在 Mac 的终端中运行 tailscale serve --bg http://127.0.0.1:27123。Tailscale 会输出一个形如 https://device-name.tailnet-name.ts.net 的地址。运行 tailscale serve status 可再次查看该地址,运行 tailscale serve reset 可关闭服务共享。
  5. 在 iPhone 或 iPad 上的 AskWatch 中,依次打开设置、MCP 服务器和管理 MCP 服务器。选择添加 MCP 服务器,然后选择按地址添加。
  6. 在服务器名称下输入任意名称。在服务器 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日阅读。