我想解決什麼
我想讓手機和網頁上的 AI 用戶端讀寫 Mac mini 上的 Obsidian vault，這樣人不在家裡也能整理筆記。範圍包含 Claude 的網頁與 iOS App、ChatGPT 網頁版，以及 Gemini Apps 的網頁與 iOS App
我原本考慮用 Auth0，但手上已經有 Cloudflare Tunnel 和 Cloudflare Access，最後決定先把現有元件串起來。這樣不用再引入另一套身分系統，對外入口和 OAuth 也能集中在同一層處理
最後長成什麼樣
Claude / ChatGPT / Gemini
│ HTTPS + OAuth 2.1 / PKCE
▼
Cloudflare Access Managed OAuth
│ Access policy
▼
cloudflared Tunnel
▼
obsidian-mcp-server（只綁 127.0.0.1:3010/mcp）
│ 本機 API key（不對外）
▼
Obsidian Local REST API with MCP（https://127.0.0.1:27124）
▼
iCloud Obsidian vault公開入口是 https://mcp.example.com/mcp，本機則由 obsidian-mcp-server 接到 Obsidian 的 Local REST API
本機會用到 Obsidian 插件 obsidian-local-rest-api（Local REST API with MCP）、obsidian-mcp-server、啟動包裝 ~/.local/bin/obsidian-mcp-start.sh，以及存放日誌的 ~/Library/Logs/obsidian-mcp 目錄。每日 vault 快照由 ~/.local/bin/obsidian-snapshot.sh 執行，寫到 /Volumes/Mac_mini/obsidian-snapshots
secret token 不會記在這裡: 套件 API Token, MCP 環境設定, Cloudflare API Token, Access Token, Oauth Client Token，以及 Cloudflare 帳號/AUD 都不放在程式裡
關於外部存取的部份
只接受 loopback(127.0.0.1)
MCP 伺服器只綁 127.0.0.1:3010，不能直接從網路存取，Tunnel 是唯一的外部入口。Cloudflare Access 的存取政策只允許帳號擁有者的電子郵件，沒有 Everyone 或 Bypass 規則，Tunnel 端也會用 Access assertion 驗證，避免 Access 應用程式被誤刪時原始服務變成裸露服務
OAuth 和本機 API key 分開
OAuth 由 Cloudflare Access 處理，提供授權伺服器探索、Dynamic Client Registration（DCR）、PKCE S256、15 分鐘的存取權杖和 14 天的授權工作階段。AI 用戶端只拿到 Cloudflare 發的 OAuth Token，API 只在本機這一段使用，不會交給 Claude、ChatGPT 或 Gemini
可讀寫，但不開 command 工具
我選擇讓 AI 用戶端可以讀寫整個 vault，所以每日 NAS 備份是前提，不是額外工作
obsidian_execute_command 和 obsidian_list_commands 這兩個指令工具沒有對外暴露，但這不等於唯讀，筆記仍可能被建立、覆寫或刪除，寫入與刪除工具應保留用戶端的人工作業確認
關於備份
備份保留 30 天，每日一次代表最多損失一天的修改
實際 API 驗證結果
| 驗證 | 結果 |
|---|---|
| 本機初始化 / MCP session / tools list | 成功，可以列出讀寫工具 |
| 危險 command 工具 | 不在工具清單裡 |
| 公開 MCP 無 token | 401，且有 WWW-Authenticate |
| 公開 MCP 帶假 Bearer token | 401，沒有工具回應 |
| OAuth discovery | /.well-known/oauth-authorization-server 有 issuer、authorization/token/registration endpoint 與 S256 |
| Protected-resource discovery | resource 為 https://mcp.example.com/mcp，並宣告 authorization server |
| Access policy | 維持單一 Allow-by-email 規則，未被 OAuth 設定修改 |
收不到驗證信的那一小時
我直接在瀏覽器開 MCP URL，走 Cloudflare One-time PIN，頁面顯示驗證碼已寄出，但一直沒收到信。同一個帳號登入既有的 Vaultwarden 卻能收到 PIN
我比對兩個 Access app 的設定，暫時關閉 Obsidian MCP 的 Managed OAuth，再重試直接用瀏覽器登入。Managed OAuth 關掉後，PIN 電子郵件立刻收到，也能順利登入
最後我重新開啟 Managed OAuth，並保留 Claude、ChatGPT、Gemini 的 redirect URI allow-list。遠端 MCP 用戶端需要 OAuth 探索、PKCE 和 DCR，不能為了方便測試直接開網址，就長期關閉 Managed OAuth
代表第一次不要用 One-time PIN，正式入口應該走 OAuth 用戶端流程
Gemini 為什麼沒接上
Gemini 顯示的錯誤是：
無法自動向這個伺服器註冊。如要連線，請輸入 OAuth 用戶端 ID 和用戶端密鑰。
我在 Cloudflare 端確認了四件事：
- Managed OAuth 已啟用
- DCR registration endpoint 已宣告
- PKCE S256 已宣告
https://gemini.google.com/*已在 DCR redirect URI allow-list
所以這次我不為 Gemini 新增靜態 OAuth 用戶端，也不做相容層。那會新增一組可存取 vault 的長期用戶端密鑰和另一個授權維護面，但 Claude 和 ChatGPT 不需要這些東西
如果 Gemini 之後修好 DCR，我可以重試同一個 URL，現有基礎設施不用重建
Claude 網頁版怎麼接上
個人 Free／Pro／Max 帳號：到 Customize > Connectors（https://claude.ai/customize/connectors），按 Connectors 旁的 +，選 Add custom connector，貼上 https://mcp.example.com/mcp。新版兩步驟視窗還會要顯示名稱，按 Continue 後 Claude 會檢查這個 URL，把偵測到的驗證方式標成 Detected
驗證方式可以選 Claude 內建身分（CIMD）、Register automatically（DCR，我這邊用這個，因為 Cloudflare Access 有宣告 registration_endpoint），或自備 OAuth Client ID（Secret 可留空）。加好之後回到 Customize > Connectors 按 Connect，會跳到 Cloudflare Access 的登入頁（我這邊是 One-time PIN），過關後回到 Claude
之後在對話框左下角按 + > Connectors，把這個連接器切成開啟就能用；個別工具允許／需核准／封鎖在同一頁的 Tool permissions 調整。Team／Enterprise 帳號要先由 Owner 在 Organization settings > Connectors 新增，成員才能在 Customize > Connectors 按 Connect
有個限制要注意：Claude 是從 Anthropic 的雲端連到 MCP Server，不是瀏覽器或裝置直接連，所以 MCP 端點和 OAuth discovery 都得是公開可連到的位址，內網或 VPN-only 端點行不通
ChatGPT 怎麼接上：Web 設定，Web／iOS 都能用
官方文件只記載 Web 端的建立流程：開啟 Developer mode（Settings → Security and login → Developer mode，帳號版本不同位置可能是 Settings → Apps → Advanced Settings），打開 https://chatgpt.com/plugins 按 + 建立一個 developer-mode app。建立表單裡有個 Name 欄位，我填的是 obsidian-macmini——這個名字之後就是對話框 @ 呼叫用的字串，取名時最好直接想清楚要打的 handle。接著填 MCP endpoint、選驗證方式，按 Scan Tools，OAuth 授權完成後按 Create，草稿要再發布才會出現在可用清單裡
但 connector 建好、發布之後，不管 Web 還是 iOS App，我實測都能用：直接在對話框輸入 @obsidian-macmini，就會觸發呼叫這個 MCP。官方 FAQ 只寫「MCP apps 目前限 Web」，指的是新增／建立 connector 這一步；已發布 connector 的呼叫是透過對話框的 @ 提及，這一段 Web 和 iOS 我都測過可以動
為什麼 @ 在 iOS 也能用： OpenAI 文件把 @／+ 定義成對話中「指定一個可用 App／Plugin」的一般入口，這一層文件沒有寫只限 Web；Apps SDK 也明確說這些 App 是架在 MCP 之上。真正被官方標成「Web only」的是 Developer mode 這個開發／管理表面——建立、測試、發布 connector 都得在 Web 做。所以合理的解讀是：@ 提及走的是比較通用的 App／Plugin 呼叫入口，發布之後不分平台都能被指定；Developer mode 只是設定這一段被鎖在 Web。要老實說，OpenAI 沒有公開文件證明 @ 在 iOS 內部是不是走跟 Developer mode 一模一樣的 MCP tool-calling 路徑，所以這裡只能寫成「實測可用」，不能講成「官方已文件化的 iOS MCP 支援」
現在的狀態
| Client | 狀態 |
|---|---|
| Claude（網頁 / iOS） | 已建立自訂連接器並完成 OAuth 授權，對話框開啟後可呼叫工具 |
| ChatGPT（網頁 / iOS） | Developer mode 於 Web 建立並發布，Web 與 iOS App 都用 @obsidian-macmini 觸發，兩邊都實測過 |
| Gemini Apps | 實測失敗，卡在 DCR |