ChatGPT

前置条件

使用支持远程 MCP 服务器和托管的 Streamable HTTP 端点的 OpenAI 应用程序配置。运行时与前置条件：

• 具体接口：ChatGPT Web 和桌面客户端 (OpenAI Apps / Actions)。
• 端点：https://xmemo.dev/mcp。
• 传输：Streamable HTTP (streamable-http)。
• 认证模式：具有 memory:read 和 memory:write 范围的 OAuth。
• 账户：在 https://xmemo.dev 拥有有效的 XMemo 账户。

安装 / 设置

在 ChatGPT 客户端或 OpenAI 平台仪表板中，注册远程连接的托管 MCP URL 和 OAuth 元数据：

• 在应用仪表板中配置托管的 MCP URL：https://xmemo.dev/mcp。
• 在同意时请求 memory:read 和 memory:write。
• 不要在应用列表中添加承载令牌。

设置凭据

无需密钥 — 完成浏览器 OAuth。ChatGPT 通过 OAuth 授权接收凭据；不要设置 XMEMO_KEY 或添加 Authorization 标头：

No XMEMO_KEY
Complete browser OAuth in ChatGPT

生成 / 确认 XMEMO_AGENT_INSTANCE_ID

经过审查的 ChatGPT OAuth 列表没有客户端身份标头。不要在应用配置中编造或粘贴 XMEMO_AGENT_INSTANCE_ID；确认此客户端路径的归属由 OAuth 授权管理。

保留现有配置块

使用经过审查的 ChatGPT 配置块。保留其托管 URL、OAuth 模式和请求的范围；仅更改客户端所需的本地仪表板值：

{
  "servers": {
    "xmemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp"
    }
  }
}

重启客户端

保存应用配置，关闭所有陈旧的 MCP 连接，然后重新打开 ChatGPT 应用或对话，以便加载当前的 OAuth 元数据。

使用真实的召回调用进行测试

使第一次 MCP 调用为只读。这是实际的召回调用，而不是健康检查占位符，并且它不会写入记忆。

recall({ query: "connection check", limit: 1 })

预期响应（字面形态）

成功的调用将返回以下公开的排序文本形态；引用和内容是来自授权记忆空间的真实值。

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

首个实用任务：合成记忆生命周期

在 ChatGPT 内演练完整的合成记忆任务：

• 1. 保存合成事实：要求 ChatGPT 调用 remember，内容为 "Demo project timestamps use UTC."，路径为 "projects/demo-onboarding/conventions"。
• 2. 无状态转换：在 ChatGPT 中打开一个全新的聊天会话，以确保不保留对话内的记忆。
• 3. 带溯源归属的召回：要求 ChatGPT 召回 "demo project timestamp format"。确认返回的 Reference 和 Location。
• 4. 修正记忆：要求 ChatGPT 使用有效 ID 调用 update_memory，将规范更新为 ISO 8601 格式。
• 5. 可选清理：测试结束后，要求 ChatGPT 使用记忆 ID 调用 forget。

功能与配置文件工具

ChatGPT 可以访问 MCP 文档契约中为 chatgpt-public 配置文件定义的限定工具：

• 核心记忆工具：remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context。
• 项目与上下文工具：get_mcp_identity, get_project_summary, project, todo, update_state, record_event, restore_memory, analyze_memory_text, memory_overview。
• 交互式工作区：open_project_workspace, open_todo_board, open_ledger, ledger。

限制与边界

ChatGPT 集成的操作边界与约束：

• 工作区边界：记忆访问严格限制在授权用户的工作区内。
• Skill 支持：ChatGPT 远程运行工具调用，不执行独立的本地 Node.js skills。
• OAuth 会话：非活动 OAuth 会话可能会定期过期，需要一键式浏览器重新授权。

常见错误

ChatGPT 特定的 OAuth 失败映射到真实的令牌端点响应：

• invalid_grant — 授权码无效或已过期，或已被使用：重新连接 ChatGPT 并再次授权。
• invalid_target — OAuth 资源与此 MCP 服务器不匹配：使用 https://xmemo.dev/mcp 作为资源重新启动连接。
• 403 insufficient_scope — 授权不包括 memory:read 或 memory:write：批准所请求的范围并重新连接。

更新与移除

ChatGPT 的维护流程：

• 更新：更新 ChatGPT 客户端或重新进行身份验证以刷新工具定义。
• 移除：在 ChatGPT Settings -> Connected Accounts / MCP 中移除 XMemo 连接。