把 Engram 连接到你的 AI

Engram 是一个远程 MCP 服务器。下面的每个客户端都连接到同一个 URL，用 OAuth 让你登录，然后读写你知识库中的笔记。无需安装任何东西， Obsidian 也不必保持打开。

https://mcp.engram.page

服务器使用 Streamable HTTP，并通过 OAuth 2.1 认证。客户端会自动完成注册，所以你不需要复制任何客户端 ID 或密钥。

开始之前

开始之前，请确认：

你在 app.engram.page 上有一个 Engram 账号。
至少有一个知识库已同步。打开 Obsidian 插件或网页版，确认笔记在最近一天内已完成同步。
你可以通过浏览器登录。MCP 认证流程会打开一个浏览器窗口。
如果你打算用 API 密钥代替 OAuth：API 密钥需要 Pro 套餐。 OAuth 登录在所有套餐上都可用（包括 Free），也是推荐的方式。 Free 和 Starter 套餐无法创建或使用 API 密钥。

Claude（网页版和桌面版）

打开 claude.ai/customize/connectors。在这里的设置会同时应用于 claude.ai 和桌面应用。
点击 +，然后选择 Add custom connector。
名称填 Engram，远程 MCP 服务器 URL 填 https://mcp.engram.page。 Advanced settings 留空。
点击 Add，再点击 Connect，并在登录窗口中批准。

Claude 的 Free 套餐允许添加一个自定义连接器。完整步骤： Claude Desktop。

ChatGPT

自定义连接器位于 ChatGPT 的 Developer mode 之后，仅限网页版，且需要符合条件的付费套餐。在 Business 或 Enterprise 工作区中，需要管理员先放行。

前往 Settings → Apps → Advanced settings，打开 Developer mode。
回到 Settings → Apps，点击 Create app。
命名为 Engram，把 MCP 服务器 URL 设为 https://mcp.engram.page，认证方式选择 OAuth。
点击 Scan Tools 并等待完成。
点击 Create，并在登录窗口中批准。
在对话中，从输入框的工具菜单里选择 Engram。

在 Business 工作区中，该应用会出现在 Workspace settings → Apps → Drafts 中，直到管理员将其发布。

完整步骤：ChatGPT。

Grok

Grok 的连接器目录中没有 Engram。你需要通过 URL 把它添加为自定义连接器。

打开 grok.com/connectors。
点击 New Connector，然后选择 Custom。
粘贴 https://mcp.engram.page 并完成登录。

想在 xAI API 上开发，而不是使用 Grok 应用？请参阅 Grok (xAI API)。

Cursor

把 Engram 添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json （单个项目）：

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

完全退出 Cursor 后重新打开。代理首次调用 Engram 工具时，会弹出登录窗口。完整步骤：Cursor。

VS Code

VS Code 在 Copilot Chat 的 Agent 模式下读取 MCP 服务器。在命令面板中运行 MCP: Add Server，或者把下面的内容添加到 .vscode/mcp.json：

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

点击 engram 条目上方的 Auth code-lens 进行登录。完整步骤：GitHub Copilot。

Claude Code

claude mcp add --transport http engram https://mcp.engram.page

重启 claude，运行 /mcp，选择 engram，然后选择 Authenticate。加上 --scope user 可让 Engram 在所有项目中可用。完整步骤：Claude Code。

任何 MCP 客户端

如果你的客户端支持远程 MCP 服务器，请提供：

URL： https://mcp.engram.page
传输方式： Streamable HTTP
认证： OAuth。Engram 公开了授权服务器元数据，并支持动态客户端注册，所以符合规范的客户端不需要其他任何东西。

无法进行浏览器登录的客户端，可以改为把 Engram API 密钥放在 Bearer 请求头中发送。API 密钥需要 Pro 套餐。两种配置方式都在 MCP 配置中。

首次登录

首次连接时，客户端 会打开一个浏览器窗口，请你登录 Engram。登录后，勾选你想授予的权限，再点击 Approve。浏览器随后会自动把你带回客户端。无需复制粘贴令牌，也无需设置环境变量。这和你把某个应用连接到 Google、Dropbox 或 GitHub 时用到的登录流程是同一类。

如果你不想走浏览器流程（无头环境、脚本化场景或共享知识库的配置），也可以改用 API 密钥认证。请参阅 MCP 配置 → API 密钥认证。

检查是否可用

问你的 AI 一个只有你的笔记才能回答的问题，例如：

我在部署笔记里把 POOL_SIZE 设成了多少？

如果它根据你的知识库作答，就说明已经连接成功。如果没有，请参阅故障排查。

断开连接

在你的 AI 客户端中移除该连接器，然后到 app.engram.page/settings/connections 撤销它的会话。