配置指南

2 分钟为你的 AI 编程智能体添加持久化云端记忆。兼容 Claude Code、Cursor、Windsurf 及任何 MCP 兼容智能体。

前置要求

✓一个来自 agent-memo.ai 的免费 API 令牌 — agent-memo.ai
✓Node.js 18+（用于 npx）
✓一个 MCP 兼容智能体（Claude Code、Cursor、Windsurf 等）

获取你的 API 令牌

注册免费账户，然后从控制台复制你的 API 令牌。

创建免费账户

在项目中添加配置

选择下方的智能体。配置文件位置和功能因智能体而异。

.mcp.json

{
  "mcpServers": {
    "agent-memo": {
      "command": "npx",
      "args": ["-y", "@agent-memo/mcp-client"],
      "env": {
        "AGENTMEMO_TOKEN": "your-token-here",
        "AGENTMEMO_PROJECT": "my-project"
      }
    }
  }
}

.claude/settings.local.json

{
  "hooks": {
    "SessionStart": [{
      "matcher": "startup",
      "hooks": [{
        "type": "command",
        "command": "npx -y @agent-memo/mcp-client --hook recall",
        "timeout": 30
      }]
    }],
    "Stop": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "npx -y @agent-memo/mcp-client --hook save",
        "timeout": 30
      }]
    }],
    "PreCompact": [{
      "hooks": [{
        "type": "command",
        "command": "npx -y @agent-memo/mcp-client --hook precompact",
        "timeout": 30
      }]
    }]
  }
}

Hooks 在关键时刻自动保存上下文——这使得 Claude Code + Agent-Memo 实现完全自动化。

SessionStart：新会话开始时自动回忆记忆。:SessionStart：新会话开始时自动回忆记忆。

Stop：定期保存重要上下文。:Stop：定期保存重要上下文。

PreCompact：上下文窗口压缩前保存关键信息。:PreCompact：上下文窗口压缩前保存关键信息。

环境变量

变量	必填	描述
AGENTMEMO_TOKEN	是	你的 API 令牌，可在控制台获取
AGENTMEMO_PROJECT	否	项目 ID。未指定时自动从 git 远程 URL 或目录名检测

开始编程

启动你的 AI 智能体。它现在拥有 14 个记忆工具。验证方式：

memory_stats()

> 已连接。已存储 0 条记忆。

可用工具（14 个）

记忆（7 个）

memory_store — 保存一条记忆
memory_recall — 语义搜索
memory_overview — 会话开始时的快速概览
memory_expand — 展开记忆详情
memory_update — 更新已有记忆
memory_delete — 删除记忆
memory_stats — 使用统计

知识图谱（5 个）

kg_add — 添加实体关系
kg_query — 查询关系
kg_invalidate — 使事实失效
kg_timeline — 查看事实历史
kg_stats — 图谱统计

发现（2 个）

memory_list_topics — 浏览主题
memory_check_duplicate — 保存前去重

Let your agent do it

Send the setup guide URL to your agent and it will configure everything automatically:

https://agent-memo.ai/setup.md