MCP 設定

大多數使用者不需要這一頁。每個現代 AI 用戶端（Claude、Cursor、ChatGPT、VS Code、Windsurf、Zed）都有圖形介面，點幾下就能加入 Engram。各用戶端的操作說明請參閱 AI 整合。

如果你比較想自己編輯設定檔（或你的用戶端沒有圖形介面），有三種做法，由易到難：把設定交給你的 AI、照著各用戶端分頁操作，或是完全略過 OAuth，改用 API 金鑰。

讓你的 AI 幫你設定

最快的做法：把下面的提示貼給你的 AI 助理。它會偵測自己執行在哪個用戶端、編輯正確的設定檔（或執行正確的 CLI 指令），並告訴你下一步該做什麼。

Add Engram as an MCP server in this AI client, then teach the AI to use it.

URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.

First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.

After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:

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.

Reference: https://engram.page/docs/mcp/manual-config/

如果過程出了問題（或你想自己動手），下方各用戶端分頁有完整的手動做法。

Engram 的 MCP 端點

https://mcp.engram.page

Engram 透過 HTTPS 提供 MCP。有兩種驗證方式：

OAuth（預設）。 用戶端第一次連接上方的 URL 時，會開啟瀏覽器視窗讓你登入。之後用戶端會持有權杖，並自動重新連接。不用複製任何金鑰。
API 金鑰，適用於無頭、腳本化或共用知識庫的情境。把金鑰以 Bearer 權杖的形式放在 Authorization 標頭中傳送。請參閱下方的 API 金鑰驗證。

不論哪種方式，都不需要環境變數，也不需要本機伺服器程序。

設定你的用戶端

在下方挑選你的用戶端。每個分頁都是完整的做法：設定、重新載入、首次驗證，以及在哪裡教 AI 真正使用 Engram。

自行架設時，把下列片段中的雲端 URL 換成你自己後端的 /api/mcp URL。標準的預留位置請見上方的端點一節。

1. 加入 Engram。 使用 Claude Code CLI，它會幫你處理設定的編輯：

claude mcp add --transport http --scope user engram https://mcp.engram.page

--scope user 旗標會讓 Engram 在每個專案中都可使用。拿掉它（或改用 --scope project），就只限制在目前專案的 .mcp.json。

想手動設定？把下列內容加入 ~/.claude.json（使用者範圍）或專案根目錄的 .mcp.json：

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. 重新載入。 結束目前的 Claude Code 工作階段，再重新執行 claude。執行 claude mcp list 確認 Engram 已註冊。

3. 首次驗證。 Claude Code 不會自動提示。在新的工作階段中執行 /mcp，選取 engram （它會顯示 △ needs authentication），再選擇 Authenticate。瀏覽器會開啟進行 OAuth。登入 Engram、核准連線，Claude Code 就會儲存權杖，之後直接重複使用。目前授予的是完整的 mcp 範圍，更細緻的逐項操作範圍已列入路線圖。

4. 告訴 Claude 要使用它。 把下方的片段附加到 ~/.claude/CLAUDE.md，也就是你的使用者層級指令檔，會套用到每個專案。

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.

1. 編輯設定。 把 Engram 加入 ~/.cursor/mcp.json（使用者範圍）或專案根目錄的 .cursor/mcp.json（專案範圍）：

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. 重新載入。 完全結束 Cursor（Cmd+Q / File → Exit）後重新開啟。只重新載入視窗並不夠，MCP 伺服器是在應用程式啟動時註冊的。

3. 首次驗證。

Cursor第一次呼叫 Engram 時，會開啟瀏覽器進行 OAuth。登入 Engram、核准連線，就完成了。Cursor會儲存權杖，之後直接重複使用。目前授予的是完整的 mcp 範圍，更細緻的逐項操作範圍已列入路線圖。

4. 告訴 Cursor 要使用它。 把下方的片段加入你的 Cursor Rules： ~/.cursor/rules（使用者範圍），或專案中的 .cursor/rules。

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.

1. 編輯設定。 把 Engram 加入工作區中的 .vscode/mcp.json。 VS Code 使用 servers 而不是 mcpServers，而且需要 "type": "http"：

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

2. 重新載入。 從命令面板（Cmd+Shift+P / Ctrl+Shift+P）執行 Developer: Reload Window。不需要完整重新啟動 VS Code。

3. 首次驗證。

Copilot Chat（或你使用的支援 MCP 的擴充功能）第一次呼叫 Engram 時，會開啟瀏覽器進行 OAuth。登入 Engram、核准連線，就完成了。Copilot Chat（或你使用的支援 MCP 的擴充功能）會儲存權杖，之後直接重複使用。目前授予的是完整的 mcp 範圍，更細緻的逐項操作範圍已列入路線圖。

4. 告訴 VS Code 要使用它。 把下方的片段加入你工作區的 custom instructions（Copilot Chat → 設定 → Custom Instructions，或你的擴充功能中對應的位置）。

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.

1. 編輯設定。 把 Engram 加入 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. 重新載入。 完全結束 Windsurf 後重新開啟。只重新載入視窗可能不會觸發 MCP 伺服器註冊。

3. 首次驗證。

Windsurf第一次呼叫 Engram 時，會開啟瀏覽器進行 OAuth。登入 Engram、核准連線，就完成了。Windsurf會儲存權杖，之後直接重複使用。目前授予的是完整的 mcp 範圍，更細緻的逐項操作範圍已列入路線圖。

4. 告訴 Windsurf 要使用它。 把下方的片段加入 Windsurf 的 AI Rules 面板（Workspace → AI Rules），或加入 ~/.codeium/windsurf/global_rules.md 作為使用者全域規則。

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.

1. 編輯設定。 開啟 ~/.config/zed/settings.json，在 context_servers 下加入 Engram（這是 Zed 專用的外層鍵，不是標準的 mcpServers）：

{
  "context_servers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. 重新載入。 從命令面板（Cmd+Shift+P）執行 zed: reload settings。如果仍無效，請完全結束 Zed 後重新開啟。

3. 首次驗證。

Zed 的助理第一次呼叫 Engram 時，會開啟瀏覽器進行 OAuth。登入 Engram、核准連線，就完成了。Zed 的助理會儲存權杖，之後直接重複使用。目前授予的是完整的 mcp 範圍，更細緻的逐項操作範圍已列入路線圖。

4. 告訴 Zed 要使用它。 把下方的片段加入 settings.json 中助理的預設提示（在 assistant.default_prompt 下），或透過助理的設定介面加入。

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.

1. 編輯設定。 大多數 MCP 用戶端都接受標準的 mcpServers 外層鍵：

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

如果你的用戶端不認得這個結構，請查閱它的文件，確認它預期的外層鍵（VS Code 使用 servers，Zed 使用 context_servers）。

2. 重新載入。 大多數用戶端需要完整重新啟動，而不只是重新載入視窗，新的 MCP 伺服器才會註冊。

3. 首次驗證。

該用戶端第一次呼叫 Engram 時，會開啟瀏覽器進行 OAuth。登入 Engram、核准連線，就完成了。該用戶端會儲存權杖，之後直接重複使用。目前授予的是完整的 mcp 範圍，更細緻的逐項操作範圍已列入路線圖。

4. 告訴你的 AI 要使用它。 把下方的片段放到你的用戶端接受長期系統指令或全域指令的位置。

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.

API 金鑰驗證

OAuth 是預設。以下情境請使用 API 金鑰：無頭或腳本化存取、逐連線控制（可寫入的機器人與唯讀的代理），或是在不授予完整登入權限的情況下共享知識庫。同一把金鑰可同時驗證 MCP 與 REST API。目前每把金鑰都帶有你帳號的完整存取權；細緻的逐金鑰範圍已列入路線圖。

取得金鑰

到 app.engram.page/settings/api-keys 產生一把。 Engram 只會在建立時顯示一次完整金鑰，之後只顯示前綴。請像對待密碼一樣對待它，並存放在安全的地方。

加入你的設定

加入一個 headers 區塊，把金鑰以 Bearer 權杖的形式傳送。外層鍵（mcpServers / servers / context_servers）依你設定的用戶端而定，所以請沿用上方對應分頁所示的結構。標準的 mcpServers 用戶端如下：

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer engram_YOUR_KEY_HERE"
      }
    }
  }
}

設定好 API 金鑰後，第一次連接時不會開啟瀏覽器，金鑰會立即完成驗證。要輪替金鑰，請在設定中產生新金鑰，並取代設定中的值。

疑難排解

編輯後用戶端看不到 Engram。 請完整重新啟動用戶端，而不只是重新載入視窗。
瀏覽器一直沒有開啟進行驗證。 確認沒有彈出視窗封鎖器擋住；有些用戶端會用自己的瀏覽器邏輯處理 OAuth 視窗，被封鎖時會無聲失敗。
Failed to connect。 確認該 URL 可以連線。跨用戶端的問題請參閱疑難排解。

各用戶端的圖形介面流程，請參閱 AI 整合。