MCP 配置

大多数用户不需要这一页。每个主流 AI 客户端（Claude、Cursor、ChatGPT、 VS Code、Windsurf、Zed）都有图形界面，点几下就能添加 Engram。各客户端的操作步骤请参阅 AI 集成。

如果你更想自己编辑配置文件（或者你的客户端没有图形界面），有三种方式，由易到难：把设置交给你的 AI、按下面各客户端的标签页操作，或者用 API 密钥完全跳过 OAuth。

让你的 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 中启用 Engram。

想手动配置？把下面的内容添加到 ~/.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 去使用它。 把下面的片段添加到工作区的自定义指令中（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，把 Engram 添加到 context_servers 下（这是 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 密钥：无头或脚本化访问、按连接分别控制（可写入的机器人 vs 只读代理），或者在不授予完整登录权限的前提下共享知识库。同一个密钥既可以认证 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 集成。