Cursor

Cursor 原生支援 MCP。放入一個 mcp.json 檔案、重新啟動 Cursor，代理第一次使用 Engram 時，OAuth 就會在你的瀏覽器中執行。想了解協定背景，請參閱 MCP。

先決條件

開始之前，請確認：

你在 app.engram.page 有一個 Engram 帳號。
至少有一個知識庫已同步。開啟 Obsidian 外掛或網頁版，確認筆記在最近一天內已完成同步。
你可以透過瀏覽器登入。MCP 驗證流程會開啟一個瀏覽器視窗。
如果你打算改用 API 金鑰而不是 OAuth：API 金鑰需要 Pro。 OAuth 登入在每個方案（包括 Free）都能使用，也是建議的做法。 Free 與 Starter 無法建立或使用 API 金鑰。

端點

https://mcp.engram.page

設定

1. 編輯 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 如何使用它

把下方的片段加入你的 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 專屬）

Tools & MCP 中出現兩個 engram 項目。 該伺服器同時定義在 ~/.cursor/mcp.json 與 .cursor/mcp.json。請移除其中一個（專案範圍的優先）。
伺服器出現在 Settings，但代理從不呼叫它。 這是部分 Cursor 版本已知的全域設定注入問題。變通做法：把設定移到專案層級的 .cursor/mcp.json。
OAuth 一直沒有提示。 代理還沒有呼叫過任何工具。強制它：請代理依名稱呼叫 engram 的 search 工具。如果仍然沒有反應，請重新啟動 Cursor；過時的連線狀態可能會擋住第一次呼叫。

跨用戶端的故障請參閱疑難排解。

撤銷

要讓 Cursor 與 Engram 斷開連線：

在Cursor中，找到該連接器或 MCP 伺服器項目並移除。
在 Engram 中，開啟你的帳號 → API Keys & Sessions，撤銷對應的工作階段。
OAuth 權杖會在伺服器端失效。Cursor需要重新驗證才能再次連接。

若要在用戶端移除，請刪除 mcp.json 中的 engram 區塊，並重新啟動 Cursor。

後續步驟

MCP協定概覽。

範圍授權涵蓋的內容。

所有整合挑選其他用戶端。