跳转到内容

ChatGPT

ChatGPT 的 Custom Connectors(也叫 MCP apps)位于 Developer Mode 开关之后。你用 URL 添加 Engram,OAuth 会立即触发,之后该连接器就可以从对话的工具菜单中选用。 网页版支持 Plus、Pro、Business/Team 和 Enterprise/Edu 套餐。桌面应用和手机应用 不提供创建连接器的入口。

开始之前,请确认:

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

另外还需要满足 ChatGPT 的特定要求:

  • 网页版上的 Plus、Pro、Business/Team 或 Enterprise/Edu 套餐。
  • 在 Team/Enterprise 上:工作区管理员已在工作区层面启用 Developer Mode。个人的 Plus/Pro 用户可以自行启用;企业工作区则需要管理员放行。
https://mcp.engram.page

1. 打开 Developer Mode。 在 ChatGPT 网页版中,前往 Settings → Apps & Connectors → Advanced → Developer Mode = ON。确认其中关于未经验证的连接器 可能修改或删除数据的警告。对 Engram 而言,能访问到的数据只有你自己的知识库。

2. 添加连接器。 在同一界面点击 Add new connector(或 Create)。按下面的值填写表单:

Name: Engram
MCP server URL: https://mcp.engram.page
Authentication: OAuth
Transport: Streamable HTTP

然后勾选 I trust this application。

3. 批准。 点击 Create。OAuth 会立即触发。浏览器会打开,让你登录 Engram 并批准连接。ChatGPT 会保存令牌并在之后复用。授予的是完整的 mcp 权限范围。更细粒度的按操作划分的权限范围 已列入路线图。

4.(仅 Team/Enterprise)发布。 随后由管理员在 Workspace Settings → Apps → Drafts 中发布该草稿,工作区的其他成员才能使用。

连接器没有单独的系统提示词。想留下一条”需要时去用 Engram”的提示, 持久的位置是 Settings → Personalization → Custom Instructions 里的 “What traits should ChatGPT have?” 字段。 粘贴下面这句简短的话:

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.

打开一个新对话。从工具菜单中选择 Engram(输入框中的 + 标签或 Developer Mode 标签)。然后提问:

  • 在我的知识库中搜索关于工程面试流程的笔记,并总结最相关的三篇。
  • 找出我上个月写过的所有关于 embeddings 的内容。

ChatGPT 会调用 Engram 的 search(或 get_note、write_note 等)工具, 取回结果,并在上下文中作答。如果工具被调用了,就说明设置成功。

ChatGPT 的 Custom Connectors 界面不支持静态 API 密钥认证,只支持 OAuth。 如果你需要 API 密钥访问(例如在无法使用 OAuth 的自托管环境中), 请改用其他 MCP 客户端。参见 MCP 配置 → API 密钥认证。

  • 看不到 “Developer Mode” 开关。 该功能受套餐或灰度发布限制。 Plus/Pro 用户请等待功能推出。Team 或 Enterprise 用户,请让工作区管理员在 Workspace settings → Connectors → Developer Mode 中启用。
  • Create 时出现 Connector is … 错误。 URL 被拒绝,或者传输方式不对。 确认 URL 与上面的端点一致,并且传输方式是 Streamable HTTP,而不是 SSE。
  • 连接器在不同对话之间”掉了”。 Custom Connectors 需要在每个新对话中从工具菜单里 重新选择。这是设计如此,不是 bug。OAuth 令牌仍然有效。

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

要断开 ChatGPT 与 Engram 的连接:

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

你也可以在 ChatGPT 自身的 Settings → Apps & Connectors 中移除该连接器。