Cursor
Cursor 原生支援 MCP。放入一個 mcp.json 檔案、重新啟動 Cursor,
代理第一次使用 Engram 時,OAuth 就會在你的瀏覽器中執行。想了解協定背景,
請參閱 MCP。
開始前,請確認:
- You have an Engram account at app.engram.page.
- 至少已同步一個儲存庫。開啟 Obsidian 插件或網頁版,確認筆記已在過去一天內同步。
- 你可以透過瀏覽器登入。MCP 驗證流程會開啟一個瀏覽器視窗。
- 如果你計畫使用 API 金鑰而非 OAuth 登入: API 金鑰適用於所有方案,包括「免費」方案。OAuth 登入仍然是建議的方式。
https://mcp.engram.page1. 編輯 mcp.json。 建立或編輯 ~/.cursor/mcp.json
(使用者全域),或專案根目錄的 .cursor/mcp.json
(專案範圍,同名伺服器會覆蓋全域設定):
{ "mcpServers": { "engram": { "url": "https://mcp.engram.page" } }}2. 重新啟動 Cursor。 完全結束(Cmd+Q / File → Exit)後重新開啟。
只重新載入視窗並不夠,MCP 伺服器是在應用程式啟動時註冊的。
3. 確認。 開啟 Settings → Tools & MCP,確認 engram
出現在伺服器清單中。
Cursor 在連接時不會提示 OAuth,而是在第一次呼叫工具時觸發。
開啟新的對話,請代理搜尋你的 Engram。瀏覽器會開啟,讓你登入 Engram 並核准連線。
Cursor 會儲存權杖,之後直接重複使用。授予的是完整的 mcp 範圍。
更細緻的逐項操作範圍已列入路線圖。
若要略過 OAuth(適用於無頭或共用知識庫的情境),把該區塊換成 API 金鑰:
{ "mcpServers": { "engram": { "url": "https://mcp.engram.page", "headers": { "Authorization": "Bearer ${env:ENGRAM_API_KEY}" } } }}在 app.engram.page/settings/api-keys 取得金鑰。
告訴 Cursor 如何使用它
Section titled “告訴 Cursor 如何使用它”把下方的片段加入你的 Cursor Rules:~/.cursor/rules
(使用者範圍),或專案中的 .cursor/rules/*.mdc 檔案。
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.連接完成後,問 Cursor 的代理:
- 在我的知識庫中搜尋有關工程師面試流程的筆記,並摘要最相關的三篇。
- 找出我上個月寫過的所有關於 embeddings 的內容。
Cursor 會呼叫 Engram 的 search(或 get_note、write_note 等)工具,
取回結果並就地回答。如果工具有被觸發,就設定完成了。
疑難排解(Cursor 專屬)
Section titled “疑難排解(Cursor 專屬)”- Tools & MCP 中出現兩個
engram項目。 該伺服器同時定義在~/.cursor/mcp.json與.cursor/mcp.json。請移除其中一個 (專案範圍的優先)。 - 伺服器出現在 Settings,但代理從不呼叫它。 這是部分 Cursor 版本已知的
全域設定注入問題。變通做法:
把設定移到專案層級的
.cursor/mcp.json。 - OAuth 一直沒有提示。 代理還沒有呼叫過任何工具。
強制它:請代理依名稱呼叫 engram 的
search工具。 如果仍然沒有反應,請重新啟動 Cursor;過時的連線狀態可能會擋住第一次呼叫。
跨用戶端的故障請參閱疑難排解。
要讓 Cursor 與 Engram 斷開連線:
- 在Cursor中,找到該連接器或 MCP 伺服器項目並移除。
- 在 Engram 應用程式中,開啟 設定 → 連線,然後點擊對應連接或 API 金鑰的 撤銷。
- 作廢的 API 金鑰將立即停止運作。已撤銷的 OAuth 連線無法重新授權,其目前存取的憑證在 15 分鐘後失效。Cursor需要重新驗證才能再次連接。
若要在用戶端移除,請刪除 mcp.json 中的 engram 區塊,並重新啟動 Cursor。