Claude Desktop
Claude Desktop 的 Connectors 介面是連接 Engram 最順暢的方式。 貼上 URL 再登入即可，不需要設定檔，也不必複製 API 金鑰。想了解背後的運作方式， 請參閱 MCP。
開始之前，請確認：
- 你在 app.engram.page 有一個 Engram 帳號。
- 至少有一個知識庫已同步。開啟 Obsidian 外掛或網頁版，確認筆記在最近一天內已完成同步。
- 你可以透過瀏覽器登入。MCP 驗證流程會開啟一個瀏覽器視窗。
- 如果你打算改用 API 金鑰而不是 OAuth：API 金鑰需要 Pro。 OAuth 登入在每個方案（包括 Free）都能使用，也是建議的做法。 Free 與 Starter 無法建立或使用 API 金鑰。
-
開啟 Add Engram connector 頁面。它會啟動 Claude 的連接器設定，並已填入 Engram 的名稱與 URL。這些設定會同時套用到桌面應用程式與 claude.ai。
想手動操作？前往 claude.ai/customize/connectors 並按下 + 按鈕新增自訂連接器。
-
填寫兩個欄位，然後按一下 Add。如果你是從上方連結開啟對話框，兩個欄位都已預先填好； 否則請自行輸入。
Name： 任意名稱，例如：
EngramRemote MCP server URL：
https://mcp.engram.page -
瀏覽器授權視窗會開啟。請參閱首次驗證了解會發生什麼。
-
在範圍畫面上檢視所要求的權限並核准。
-
告訴 Claude 如何使用它，讓它自動優先使用 Engram。
-
試試看，確認連接器可以運作。
第一次連接時，Claude Desktop會自動開啟一個瀏覽器視窗，請你登入 Engram。登入後，勾選要授予的權限，再按一下 Approve。瀏覽器會自動帶你回到Claude Desktop。不用複製貼上權杖，也不用設定環境變數。這和你把任何應用程式連接到 Google、Dropbox 或 GitHub 時用的登入流程是同一類。
如果你想略過瀏覽器流程（無頭、腳本化或共用知識庫的情境），可以改用 API 金鑰驗證。請參閱 MCP 設定 → API 金鑰驗證。
告訴 Claude 如何使用它
Section titled “告訴 Claude 如何使用它”加入連接器只完成了一半。除非你告訴 Claude，否則它不會主動使用 Engram。 在 Claude 的全域偏好設定中加入一段簡短指示，讓每次對話都知道要把 Engram 當作記憶使用。
- 開啟 claude.ai/settings/general。
- 找到 What personal preferences should Claude consider in responses? 欄位（全域指令輸入框）。
- 貼上這段片段。讓它獨立成一行，這樣每次對話都會套用：
Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.這樣一來，Claude 在需要查詢或儲存你分享過的內容時，就會自動使用 Engram。
連接完成且全域提示就緒後，連接器會出現在你的側邊欄。試著問：
- 在我的知識庫中搜尋有關工程師面試流程的筆記，並摘要最相關的三篇。
- 找出我上個月寫過的所有關於 embeddings 的內容。
- 讀取我標題為「Q3 planning」的筆記，並整理出待辦事項。
- 顯示 'project-ideas.md' 的 frontmatter 與外連連結。
- 在我的「Meeting notes」資料夾中，建立一則標題為「Sync with design, May 21」的新筆記，寫入今天的重點。
- 在 'roadmap.md' 末尾加上「Decisions」段落，列出這三項。
- 列出我知識庫中的頂層資料夾。
- 把「inbox」中所有提到「Q4」的內容移到「Q4-planning」。
Claude 會呼叫 Engram 的 search（或 get_note、write_note 等）工具，
取回結果並就地回答。
Claude Desktop 會在核准畫面上要求 mcp 範圍。這是單一授權，涵蓋對你的知識庫的完整 MCP 工具。
細緻的逐項操作範圍（唯讀、禁止刪除等）已列入路線圖。詳情與撤銷流程請參閱範圍。
疑難排解（Claude Desktop 專屬）
Section titled “疑難排解（Claude Desktop 專屬）”- 授權視窗一直沒有開啟。 確認 Claude Desktop 是最新版本，且沒有啟用彈出視窗封鎖器。
- “Connector failed to load.” 確認 MCP URL 可以連線。 把它貼到瀏覽器分頁。如果看到的是結構化的回應頁面而不是錯誤， 代表連線正常，問題出在 Claude Desktop 那一側。重新啟動後再試一次。
跨用戶端的故障（驗證被拒、範圍錯誤、同步缺漏）請參閱 疑難排解。
從任一側都能中斷連接，並立即生效。挑你方便的方式：
透過 Claude 應用程式： 開啟 Settings → Connectors，找到 Engram， 選擇 Disconnect。
透過網頁版 Claude： 前往 claude.ai/customize/connectors， 按一下 Engram 連接器，選擇 Disconnect。
透過 Engram： 前往 app.engram.page/settings/connections 並中斷該工作階段。
無論哪種方式，OAuth 權杖都會在伺服器端失效，Claude Desktop 需要重新驗證才能再次連接。