設定指南

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