MCP 疑難排解

端點

https://mcp.engram.page

”Failed to connect”

• URL 錯誤。 MCP 端點位於 /api/mcp（請見上方的端點）。 只有主機名稱、沒有路徑的網址不是 MCP 端點，會回傳 404。
• 自行架設的 TLS。 MCP 端點必須使用 HTTPS。依照 OAuth 2.1，用戶端會拒絕純 HTTP。
• 後端無法連線。 確認你能直接存取 /api/health。 如果連這個都失敗，MCP 不可能運作。

“Authorization failed”

• 帳號未啟用。 登入 app.engram.page，確認你的訂閱狀態正常。
• 尚未完成新手引導。 Engram 要求先接受條款， 知識庫端點（包括 MCP）才能使用。
• OAuth 期間被限流。 等一分鐘後再試。

Claude 找不到筆記

• 確認知識庫確實已從 Obsidian 同步。請檢查同步中心 與 app.engram.page。
• 確認 OAuth 權杖確實帶有 mcp 範圍；如果第一次安裝時略過了授權，請重新加入連接器。
• 試試更具體的查詢。語意搜尋只回傳前 K 筆，所以在大型知識庫上， 模糊的查詢可能找不到你預期的內容。

“Token expired”

OAuth 權杖的有效期限是有限的。大多數用戶端會自動更新；請再試一次該操作。 如果仍然失敗，請移除連接器後重新加入。

更多資訊在哪裡

• 伺服器端記錄：自行架設請參閱自行架設
• 用戶端記錄：Claude Desktop → Help → Open developer console
• 回報問題請至 engram-app/engram