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 中。删掉其中一个（项目级的优先）。
设置中能看到服务器，但代理从不调用它。 部分 Cursor 版本存在已知的全局配置注入问题。变通办法：把配置移到项目级的 .cursor/mcp.json。
OAuth 始终没有提示。 代理还没有调用过任何工具。强制触发：让代理按名称调用 engram 的 search 工具。如果仍然没有反应，重启 Cursor；残留的连接状态可能会阻塞第一次调用。

跨客户端的故障，请参阅故障排查。

撤销

要断开 Cursor 与 Engram 的连接：

在Cursor中找到对应的连接器或 MCP 服务器条目，并将其移除。
在 Engram 中打开你的账号 → API Keys & Sessions，撤销对应的会话。
OAuth 令牌会在服务器端失效。Cursor需要重新认证才能再次连接。

如果想在客户端侧移除，请删除 mcp.json 中的 engram 配置块，然后重启 Cursor。

下一步

MCP协议概览。

权限范围授权涵盖哪些内容。

所有集成选择其他客户端。