MCP 疑難排解
https://mcp.engram.pageFailed to connect
Section titled “Failed to connect”- 網址錯誤。 MCP 端點位於
/api/mcp(請參閱上方端點)。僅有主機名稱 (沒有路徑) 並不是 MCP 端點,會返回 404 錯誤。 - 自行架設的 TLS。 MCP 端點必須使用 HTTPS。根據 OAuth 2.1,客戶端會拒絕使用純 HTTP。
- 後端無法連線。 請確認你可以直接訪問
/api/health。如果連線失敗,MCP 無法正常運作。
Authorization failed
Section titled “Authorization failed”- Account not active. Log in to
app.engram.pageand check your subscription is in good standing. - 設定尚未完成。 請在
app.engram.page完成設定 (包含使用條款,以及部分帳戶的儲存庫設定)。403 錯誤訊息包含你尚未完成的步驟連結。 - OAuth 期間可能會有速率限制。 請稍等片刻後再試。
Claude 找不到任何筆記
Section titled “Claude 找不到任何筆記”- 請確認儲存庫已成功從 Obsidian 同步。請檢查同步中心和
app.engram.page。 - 請確認 OAuth 憑證是否包含
mcp權限;如果首次安裝時跳過了授權,請重新新增連線器。 - 嘗試更精確的搜尋。語義搜尋會回傳前 K 個結果,因此在大型儲存庫中使用模糊的搜尋詞語可能無法找到你想要的内容。
Token expired
Section titled “Token expired”OAuth 憑證有其有效期限。大多數客戶端會自動處理重新整理;請再次嘗試該操作。如果問題持續發生,請移除並重新新增連線器。
Codex 無法再存取 Engram
Section titled “Codex 無法再存取 Engram”Codex 0.163 及更早版本可能會不斷重試已過期的登入,或遺失登入資訊,而不是要求你重新登入(相關問題 openai/codex#48507 和 openai/codex#39054,皆尚未解決)。Codex 0.164.0 會停止重試失敗的登入,因此請先更新 Codex。
如果 Engram 工具仍然無法使用,請重新連接。執行此指令 使用你為伺服器設定的名稱。
codex mcp login engram查找更多資訊的管道
Section titled “查找更多資訊的管道”- 伺服器端日誌:若為自行架設,請參閱 自行架設
- 客户端日志:Claude 桌面 → 說明 → 開啟開發者控制台
- 問題回報請至 engram-app/engram