Claude Desktop
Claude Desktop 的 Connectors 界面是连接 Engram 最顺畅的方式。 粘贴 URL、登录即可，无需配置文件，也无需复制 API 密钥。 想了解背后的原理，请参阅 MCP。
开始之前，请确认：
- 你在 app.engram.page 上有一个 Engram 账号。
- 至少有一个知识库已同步。打开 Obsidian 插件或网页版，确认笔记在最近一天内已完成同步。
- 你可以通过浏览器登录。MCP 认证流程会打开一个浏览器窗口。
- 如果你打算用 API 密钥代替 OAuth：API 密钥需要 Pro 套餐。 OAuth 登录在所有套餐上都可用（包括 Free），也是推荐的方式。 Free 和 Starter 套餐无法创建或使用 API 密钥。
-
打开 Add Engram connector 页面。它会启动 Claude 的连接器设置，并已预先填好 Engram 的名称和 URL。 这些设置会同时应用于桌面应用和 claude.ai。
想手动操作？前往 claude.ai/customize/connectors， 点击 + 按钮添加自定义连接器。
-
填写这两个字段，然后点击 Add。如果你是通过上面的链接打开的弹窗， 两者都已预填；否则请自行填写。
Name： 随意，例如：
EngramRemote MCP server URL：
https://mcp.engram.page -
会弹出浏览器授权窗口。请参阅首次认证了解会发生什么。
-
在权限范围界面查看所请求的权限，然后批准。
-
告诉 Claude 如何使用它，让它自动去用 Engram。
-
试一试，确认连接器可以正常工作。
首次连接时，Claude Desktop 会自动打开一个浏览器窗口， 请你登录 Engram。登录后，勾选你想授予的权限，再点击 Approve。 浏览器随后会自动把你带回Claude Desktop。无需复制粘贴令牌， 也无需设置环境变量。这和你把某个应用连接到 Google、Dropbox 或 GitHub 时用到的登录流程是同一类。
如果你不想走浏览器流程（无头环境、脚本化场景或共享知识库的配置）， 也可以改用 API 密钥认证。 请参阅 MCP 配置 → API 密钥认证。
告诉 Claude 如何使用它
Section titled “告诉 Claude 如何使用它”添加连接器只完成了一半。除非你告诉它，否则 Claude 不会主动去用 Engram。 在 Claude 的全局偏好设置中加入一条简短的指令，让每次对话都知道把 Engram 当作记忆来使用。
- 打开 claude.ai/settings/general。
- 找到 What personal preferences should Claude consider in responses? 字段（全局指令输入框）。
- 粘贴下面的片段。让它单独占一行，这样它对每次对话都有效：
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.这样，当 Claude 需要查找或保存你分享过的内容时，就会自动去用 Engram。
连接完成并设置好全局提示词后，该连接器会出现在你的侧边栏中。试着问：
- 在我的知识库中搜索关于工程面试流程的笔记，并总结最相关的三篇。
- 找出我上个月写过的所有关于 embeddings 的内容。
- 读一下我那篇标题为 'Q3 planning' 的笔记，把其中的待办事项提取出来。
- 给我看 'project-ideas.md' 的 frontmatter 和出链。
- 在我的 'Meeting notes' 文件夹里新建一篇标题为 'Sync with design, May 21' 的笔记，写入今天的要点。
- 在 'roadmap.md' 末尾追加一个 'Decisions' 小节，写入这三项内容。
- 列出我知识库中的顶层文件夹。
- 把 'inbox' 里所有提到 'Q4' 的内容移到 'Q4-planning'。
Claude 会调用 Engram 的 search（或 get_note、write_note 等）工具，
取回结果，并在上下文中作答。
授予的权限范围
Section titled “授予的权限范围”Claude Desktop 会在批准界面请求 mcp 权限范围。这是一项整体授权，
涵盖针对你知识库的完整 MCP 工具能力。细粒度的按操作划分的权限范围
（只读、禁止删除等）已列入路线图。详情和撤销流程请参阅
权限范围。
故障排查（Claude Desktop 专属）
Section titled “故障排查（Claude Desktop 专属）”- 授权窗口始终没有打开。 确认 Claude Desktop 是最新版本， 并且没有启用弹窗拦截。
- “Connector failed to load.” 确认 MCP URL 可以访问。 把它粘贴到浏览器标签页中。如果看到的是结构化的响应页面而不是错误， 说明连接本身没问题，问题出在 Claude Desktop 一侧。重启它再试一次。
跨客户端的故障（认证被拒、权限范围错误、同步缺失），请参阅 故障排查。
从任意一侧断开连接都会生效。选择你方便的一种：
通过 Claude 应用： 打开 Settings → Connectors，找到 Engram， 选择 Disconnect。
通过网页版 Claude： 前往 claude.ai/customize/connectors， 点击 Engram 连接器，选择 Disconnect。
通过 Engram： 前往 app.engram.page/settings/connections， 断开该会话。
无论哪种方式，OAuth 令牌都会在服务器端失效，Claude Desktop 需要重新认证才能再次连接。