最後更新於 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 上執行 1 個指令 | 私有連線方式。請將工具維持在每次都詢問。 | 可以,使用以 ts.net 結尾的 https 位址。AskWatch 尚未嘗試過。 |
| Tailscale Funnel | 可以 | 網際網路上的任何人 | 在 Mac 上執行 1 個指令 | 不建議使用。對於能寫入及刪除筆記的工具,外掛程式的 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 會傳送 1 個 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 中,依照上述步驟 2,確認 Enable HTTP server 已開啟。外掛程式仍只會監聽 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 都可能變更。本頁依據 2026 年 11 月 7 日閱讀的外掛 5.5.2 版 README 撰寫,該版本發布於 2026 年 10 月 17 日。
- 我們尚未嘗試過任何供 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:供公開應用程式使用的通道
- Cloudflare:Universal SSL 憑證
- Cloudflare:Access 服務權杖
- Cloudflare:Access 原則
- Cloudflare:Managed OAuth
- Cloudflare:私有網路
- Cloudflare:Cloudflare One Client 下載
- Local REST API with MCP:含預設綁定位址的原始碼檔案