關於 MCP

MCP（Model Context Protocol） 是一項新的開放標準，Anthropic、OpenAI 等主要 AI 公司都已採用， 讓 Engram 這類工具可以直接接上 AI 助理。把它想成通用連接器：一套標準，Claude、Cursor、ChatGPT 或任何支援 MCP 的 AI 工具都能存取你的筆記。它們可以搜尋、讀取，也能儲存新筆記，而且所有權限都由你掌控。

你不需要懂 MCP 也能使用 Engram。在 AI 整合中挑選你的 AI 工具， 點幾下就完成了。這一頁是給想了解背景的人看的。

MCP 是什麼

在 MCP 出現之前，要把筆記交給 AI 助理，只能複製貼上、匯出，或為每個應用程式各做一個客製整合。 MCP 把這個連接方式標準化：

• Engram 只提供一個 MCP 端點（一個 URL、一種協定）。
• 你的 AI 用戶端使用 MCP（Claude、Cursor、ChatGPT、VS Code、Windsurf、Zed 等）。
• 握手使用 OAuth。 哪些內容可以透過哪個用戶端存取，由你決定。
• 工具、提示與資源都可被探索。 用戶端詢問 Engram 有哪些可用項目，Engram 回答。 不需要為每個整合預先寫死任何東西。

一句好用的比喻：MCP 就是 AI 的 USB-C。 一種線路格式，兩端可以接上許多不同的裝置。

連接之後你可以做什麼

• 請 AI 找出某個主題的筆記。它會在你的知識庫中進行語意搜尋，並取回最相關的內容
• 請它摘要一個資料夾，或把相關筆記串連起來
• 讓它草擬一則新筆記，直接存入你的知識庫（需經你核准）
• 在 AI 工作流程中使用 Engram 的搜尋，不必匯出、複製貼上，也不必把筆記複製到任何其他地方

你可以問 Claude 「我上個月寫過哪些關於 X 的內容？」，它會呼叫 Engram 的搜尋工具，實際找出答案。

協定簡介

給想深入了解的讀者，以下是技術層面的概要。跳過這一段也完全不影響使用 Engram。

Engram 透過 HTTPS 提供 MCP。具體來說：

• 授權：OAuth 2.1 搭配動態用戶端註冊（Dynamic Client Registration，DCR）， 用戶端不需要預先發放的憑證。
• 探索：GET /.well-known/oauth-authorization-server 與 tools/list，讓用戶端得知有哪些可用項目。
• 工具：search、get_note、write_note、list_folders 等。
• 資源：可用 URI 定址的筆記。
• 範圍：每個工作階段分別授予的細緻權限（請參閱 範圍）。

本節頁面

• MCP 設定：JSON 片段與路徑對照表， 適用於用設定檔而不是圖形介面連接的使用者
• 範圍：每項權限各授予什麼
• 疑難排解：連接器無法與 Engram 通訊時

各用戶端的設定方式（Claude、Cursor、ChatGPT 等），請參閱 AI 整合。

互動式工具目錄（Engram 提供的每個工具，附輸入結構與範例）將於後續階段推出， 並直接由後端程式碼產生，確保內容不會與實作脫節。