範圍

把 Engram 加為 MCP 連接器時，用戶端會收到一個 OAuth 存取權杖。權杖帶有一個範圍， 決定用戶端可以對你的知識庫做什麼。

權杖目前授予的內容

Engram 的 MCP 端點目前只提供一個整體範圍：mcp。

擁有 mcp 權限的 Token，授予客戶完整的 MCP 功能：讀取筆記、語義搜尋、寫入筆記、編輯資料夾、附加檔案。權限不依單一動作劃分，但僅限於您在連接時，於同意畫面選擇的儲存庫。您可以選擇特定儲存庫，或全部儲存庫（包含日後建立的儲存庫）。

計畫中的細緻範圍

把 mcp 拆成逐項操作的範圍（notes:read、notes:search、notes:write、notes:delete、 folders:write、metadata:read）已列入路線圖。推出後，連接器流程將讓你只授予 AI 代理所需的 最低權限（「可讀取與搜尋，但絕不寫入」），而不是像現在這樣全有或全無。

如果你現在就在意細緻權限，變通做法是 不要連接你不放心讓它寫入知識庫的 AI 代理。授權一旦發出， 目前沒有任何協定內的方式可以限縮。

稽核與撤銷存取

設定 → 連線 在 Engram 應用程式中，列出所有已啟用 OAuth 連線和 API 金鑰。點擊 撤銷 以移除其中一個：

• 作廢的 API 金鑰將立即停止運作。
• 已撤銷的 OAuth 連線無法重新授權，其目前存取的憑證在 15 分鐘後失效。

範圍語法（給 SDK 開發者）

端點會透過 /.well-known/oauth-authorization-server 公布它支援的範圍。 SDK 開發者應讀取該中繼資料，而不是把範圍字串寫死，因為細緻範圍的拆分會最先出現在那裡。