Memory MCP：五分钟接入 Cursor

你能获得什么

Engra 通过 MCP 暴露 Agent Memory，端点为 /api/v1/memory/mcp。传输协议为 Streamable HTTP——无需本地 stdio 桥接，开发机也不必常驻守护进程。

已发布工具： • memory_list_libraries — 列举库（memory:read） • memory_search — L3 语义搜索（memory:read） • memory_recall — L2 主题召回（memory:read） • memory_wake_up — L0+L1 会话上下文（memory:read） • memory_save_atom — 持久化新 Atom（memory:write；默认异步 202） • memory_correct_atom — 修正 Atom（memory:write；默认异步 202） • memory_list_atoms — 分页列出 Atom（memory:read）

配合 Agent Skills：SKILL.md 说明何时唤醒、如何搜索、如何把持久事实写回 Atom 图。

前置条件

需要 Engra 账号、记忆库，以及带 memory:read（若需写入则加 memory:write）的平台 API Key。在 控制台 的 API 密钥页面创建。

Cursor（或任何支持 Streamable HTTP 的 MCP 客户端）需能访问 Engra 源站，并按文档在 Authorization 或 X-API-Key 头中携带密钥。

最小接入路径

1. 从文档复制 MCP 端点 URL。 2. 在 Cursor MCP 设置中添加服务器并填入 API Key。 3. 安装已发布的 Skill，让 Agent 知道何时 wake_up、何时 search。 4. 新开对话，确认 memory_list_libraries 返回你的库。

推荐会话流：会话开始 memory_wake_up → 工具密集轮次前 memory_search → 用户陈述持久偏好或决策时 memory_save_atom。写工具默认快速返回（202 + job.id），后台落盘，减少 IDE 聊天阻塞。

常见坑

跳过 wake_up 会让 Agent 只依赖 L3 搜索，丢失 L0 身份与 L1 叙事。多轮编码 Agent 务必在会话开始时唤醒。

保存 Atom 时不填 Scope/Topic 会稀释检索。按 Skill 剧本：写入时传 memoryLibraryId 并填写 scope、topic（legacy 写入字段 persona 仍接受）。

何时用 REST

自定义后端、批量入库、多租户编排应直接调用 /api/v1/memory。MCP 面向 IDE 与对话 Agent；REST 面向你控制的服务。