Model Context Protocol · Beta

在每个 AI 工具里的记忆

一条命令,Claude Code、Claude Desktop、Cursor 等任何 MCP 宿主就拥有由你的 WOS 账户支撑的长期记忆。无需集成代码,智能体获得 9 个记忆工具并自行决定何时使用。

MCP 处于测试版。九个工具现已可用且经过测试,但在完善过程中表面仍可能变化。其下的 API 和 SDK 是稳定且有版本管理的。

安装

Claude Code 只需一行(先在控制台创建密钥):

    
claude mcp add wontopos --env WONTOPOS_API_KEY=wos-live-... -- npx -y wontopos-mcp
# pick which store it remembers into (optional): add --env WONTOPOS_USER_ID=my-project
# ~/.cursor/mcp.json
{ "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }
# .vscode/mcp.json
{ "servers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }
# ~/.codeium/windsurf/mcp_config.json
{ "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }
# Claude Desktop and any other MCP host
{ "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }

Add to Cursor → · Add to VS Code →

可选 env:WONTOPOS_USER_ID 指定默认存储,WONTOPOS_MODEL 指定引擎,WONTOPOS_BASE_URL 指定要连接的 API 主机。 WONTOPOS_READ_ONLY=1 切换为只读(仅召回/搜索/查看)。

共享同一个存储之前

使用专用密钥。密钥携带其工作区,为 MCP 单独创建的密钥从根上限定了所连工具能触及的范围 - 随时可在控制台轮换,不影响应用的密钥。
只读模式。WONTOPOS_READ_ONLY=1 时完全不注册写入工具：智能体只能召回、搜索、列出记忆、运行 engram、读取统计，无法存储、更新或删除。适合只应查阅记忆、而非拥有记忆的智能体。
保持工具执行确认开启。MCP 宿主默认在运行工具前询问 - 尤其是 forget,因为删除对该存储上的所有工具生效。
凡是存入的,持有密钥的每个工具都能召回。绝不要把机密 - API 密钥、密码 - 存成记忆。
召回的记忆是数据,不是指令。工具描述会明确告诉智能体这一点。即便如此,也不要把不可信的第三方文本存进自主智能体会遵循的存储里。
删除同样是共享的。一个工具里的 forget 或 delete_all,对所有工具都生效。
"me" 指的是写入该存储的智能体自己。多个智能体共享一个存储时,"me" 的声音会混在一起。想分开身份,就给每个智能体单独的存储(WONTOPOS_USER_ID)。
一个账户买单。所有接入的工具都消耗同一份余额和速率额度。

然后直接对话

you记住我们每周五发布

智能体调用 remember 工具。持久保存在你的存储里,会话结束也不会丢失。

new session我们什么时候发布?

新会话没有任何聊天记录。智能体调用 recall,凭记忆回答:周五。

可以这样说

"这个仓库用 pnpm,记住" → remember 存下来,下个会话就已经知道。
"上周我们定的错误格式是什么?" → recall 把那个决定拉回上下文。
"其实截止日期改到周五了" → 智能体发现这与它召回的记忆矛盾，调用 update 就地更正那条记忆。
"记错了,删掉" → 智能体找到记忆 id 并调用 forget,宿主会先要求确认。
"你记得我哪些事？" → list_memories 翻遍所有已存记忆，智能体就能回答或整理。

不需要特殊句式 - 以上都是普通句子,不是命令。智能体读取各工具的描述,自行选择。

九个工具

recall - 一次调用取得上下文:最近对话 + 相关长期记忆。工具描述里写明:涉及过去上下文时先调用它。
remember - 保存持久的事实或决定。speaker: "me" 标记智能体自己的话;已注册的名字标记说话人。
search - 语义搜索。可按人过滤的 speaker，以及按时间或主题收窄范围的 filters（“六月我们定了什么?”）—— 语义本身唯一无法收窄的维度就是时间。
update - 用新内容取代事实已变的记忆，保留脉络而不是删除。
forget - 按 id 删除一条记忆。
list_memories - 分页浏览已存储的全部内容，用于回答“你记得我什么”或做整理。
engram - 当一次搜索不够时，运行内置的多跳流程（deep_recall、timeline、gather）。
stats - 查看存储中有多少内容 —— 清理前使用，也用于确认写入是否真的落库。
create_store - 存储是显式的:每个最终用户、项目或智能体一个。

SDK 还是 MCP?

SDK 放进你自己写的应用里。什么时候存、取什么,由你的代码精确决定 - 确定性、有类型、有版本。做产品就用 SDK。
MCP 插进不是你写的 AI 工具里。何时使用记忆由智能体根据工具描述判断 - 零代码。适合 Claude Code、Claude Desktop、Cursor,或给现成的助手装上记忆。

底层是同一个 API、同一批存储 - 用 SDK 构建的应用和用 MCP 连接的 Claude Code 会话共享同一份记忆。按场景选择,不是二选一。

一份记忆,贯穿所有工具

记忆属于账户,而不是工具。从 ChatGPT(Actions + OpenAPI 规范)写入的存储,在 Claude Code 和你自己的智能体里同样能召回,反之亦然。在一个工具里开始的对话,在另一个工具里继续。

而且因为是同一个存储,你可以在 Claude Code 上用着,再回到自己的智能体继续对话:同一密钥、同一存储的 SDK 智能体能召回 Claude Code 刚学到的一切;你的智能体存下的,下个会话的 Claude Code 也能召回。

在本地通过 stdio 运行（npx wontopos-mcp）：采用这种方式时，密钥只留在你的环境里，不会作为 MCP 会话的一部分发送给我们。它封装了 TypeScript SDK，自动重试、拒绝重定向、密钥脱敏原样生效。

附加功能 · Beta

MCP - 给 AI 工具的记忆

WOS 的核心是 API 和 SDK。MCP 服务器是其上的附加功能:把同一份记忆,插进不是你构建的工具里 - Claude Code、Claude Desktop、Cursor。

一行安装,智能体就获得 9 个记忆工具并自行使用。记忆在你的账户里,一个工具写入的,其他所有工具都能召回 - 包括你用 SDK 构建的智能体。

用它能做什么

记得你项目的 Claude Code。决策、bug 修复、偏好 - 下个会话直接召回,无需重新解释。
在 ChatGPT 开始,在 Claude 继续。同一个存储、同一份记忆 - 对话跨工具延续,而不是从头再来。
你自己的智能体也在同一记忆里。Claude Code 学到的,SDK 智能体能召回;智能体存下的,Claude Code 也能召回。

可用于 Claude Code、Claude Desktop、Cursor、Windsurf 及任何 MCP 宿主。ChatGPT 通过 Actions 加 OpenAPI 规范接入同一份记忆。

安装

claude mcp add wontopos --env WONTOPOS_API_KEY=wos-live-... -- npx -y wontopos-mcp

智能体获得九个工具 - recall · remember · search · update · forget · list_memories · engram · stats · create_store - 每个描述都写明何时使用,它自行判断。

附加功能本身免费,已在 npm 公开 - 只按它发起的 API 调用照常计费。需要 Node 18+ 和在控制台创建的 API 密钥。

打开开发者页面 →

Model Context Protocol · Beta

Claude Code

旗舰路径:终端里一条命令,每个会话都带着记忆开始。

在控制台创建 API 密钥。密钥携带其工作区,一把密钥 = 一个记忆空间。
注册服务器。加 --scope user 所有项目可用;不加则只有当前项目可见。
验证:在 Claude Code 里运行 /mcp,应能看到 wontopos 和 9 个工具。
自动化技巧:在 CLAUDE.md 里写一行"涉及过去上下文时先调用 wontopos recall",每个会话就会不用吩咐地带着记忆开始。

claude mcp add wontopos --scope user \
  --env WONTOPOS_API_KEY=wos-live-... -- npx -y wontopos-mcp
# pick a store (optional): add --env WONTOPOS_USER_ID=my-project

Model Context Protocol · Beta

Claude Desktop

把下面的块加进 claude_desktop_config.json(设置 → 开发者 → Edit Config),重启应用,九个工具就会出现。注意:网页版和移动版 claude.ai 需要远程 MCP 服务器,WOS 尚未提供 - 桌面应用是受支持的路径。

# claude_desktop_config.json
{ "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }

Model Context Protocol · Beta

Cursor

把下面的块加进 ~/.cursor/mcp.json,或点一键按钮,然后重启 Cursor。智能体就会拿到九个工具。

# ~/.cursor/mcp.json
{ "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }

Add to Cursor →

Model Context Protocol · Beta

VS Code

VS Code(Copilot 智能体模式)从项目的 .vscode/mcp.json 读取 MCP 服务器:加入下面的块,或点一键按钮。

# .vscode/mcp.json
{ "servers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }

Add to VS Code →

Model Context Protocol · Beta

Windsurf

Windsurf(Cascade)读取 ~/.codeium/windsurf/mcp_config.json:加入下面的块并重新加载,同样的九个工具就会出现。

# ~/.codeium/windsurf/mcp_config.json
{ "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }

Model Context Protocol · Beta

ChatGPT

ChatGPT 的 MCP 连接器只接受远程服务器,所以目前受支持的路径是自定义 GPT 的 Action:创建 GPT,添加 Action,粘贴下面的 OpenAPI 规范 URL,并把 API 密钥设为认证头。这个 GPT 就会调用与其他工具相同的记忆。

# GPT → Configure → Actions → Import from URL
https://api.wontopos.com/openapi.json
# Authentication: API Key · Header name: X-API-Key

同一个存储、同一份记忆:ChatGPT 通过 Action 存的,Claude Code 通过 MCP 召回,反之亦然。

Model Context Protocol · Beta

Gemini CLI

Gemini CLI 从 ~/.gemini/settings.json 读取 MCP 服务器:加入下面的块并重启 CLI,同样的九个工具也会出现。

# ~/.gemini/settings.json
{ "mcpServers": {
    "wontopos": {
      "command": "npx",
      "args": ["-y", "wontopos-mcp"],
      "env": { "WONTOPOS_API_KEY": "wos-live-...",
               "WONTOPOS_USER_ID": "my-project" }
    } } }

Product

Models

Start

在每个 AI 工具里的记忆

安装

共享同一个存储之前

然后直接对话

可以这样说

九个工具

SDK 还是 MCP?

一份记忆,贯穿所有工具

MCP - 给 AI 工具的记忆

用它能做什么

安装

Claude Code

Claude Desktop

Cursor

VS Code

Windsurf

ChatGPT

Gemini CLI