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.page1. 打开 Developer Mode。 在 ChatGPT 网页版中,前往 Settings → Apps & Connectors → Advanced → Developer Mode = ON。确认其中关于未经验证的连接器 可能修改或删除数据的警告。对 Engram 而言,能访问到的数据只有你自己的知识库。
2. 添加连接器。 在同一界面点击 Add new connector(或 Create)。按下面的值填写表单:
Name: EngramMCP server URL: https://mcp.engram.pageAuthentication: OAuthTransport: Streamable HTTP然后勾选 I trust this application。
3. 批准。 点击 Create。OAuth 会立即触发。浏览器会打开,让你登录 Engram
并批准连接。ChatGPT 会保存令牌并在之后复用。授予的是完整的
mcp 权限范围。更细粒度的按操作划分的权限范围
已列入路线图。
4.(仅 Team/Enterprise)发布。 随后由管理员在 Workspace Settings → Apps → Drafts 中发布该草稿,工作区的其他成员才能使用。
告诉 ChatGPT 如何使用它
Section titled “告诉 ChatGPT 如何使用它”连接器没有单独的系统提示词。想留下一条”需要时去用 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 等)工具,
取回结果,并在上下文中作答。如果工具被调用了,就说明设置成功。
API 密钥访问
Section titled “API 密钥访问”ChatGPT 的 Custom Connectors 界面不支持静态 API 密钥认证,只支持 OAuth。 如果你需要 API 密钥访问(例如在无法使用 OAuth 的自托管环境中), 请改用其他 MCP 客户端。参见 MCP 配置 → API 密钥认证。
故障排查(ChatGPT 专属)
Section titled “故障排查(ChatGPT 专属)”- 看不到 “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 的连接:
- 在ChatGPT中找到对应的连接器或 MCP 服务器条目,并将其移除。
- 在 Engram 中打开你的账号 → API Keys & Sessions,撤销对应的会话。
- OAuth 令牌会在服务器端失效。ChatGPT需要重新认证才能再次连接。
你也可以在 ChatGPT 自身的 Settings → Apps & Connectors 中移除该连接器。