关于 MCP

MCP（Model Context Protocol，模型上下文协议） 是一项新的开放标准， Anthropic、OpenAI 等主要 AI 公司都已采用，用来让 Engram 这类工具直接接入 AI 助手。可以把它看作一个通用连接器：只要遵循这一个标准，Claude、Cursor、 ChatGPT 或任何其他支持 MCP 的 AI 工具都能访问你的笔记。它们可以搜索笔记、 读取笔记、保存新笔记，而这一切都在你掌控的权限之内。

使用 Engram 并不需要先理解 MCP。在 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 提供的每个工具，附输入模式和示例）将在后续阶段推出， 并直接由后端代码生成，因此不会与实际情况脱节。