セットアップガイド

AIコーディングエージェントに永続的なクラウドメモリを2分で追加。Claude Code、Cursor、Windsurf、その他のMCP対応エージェントに対応。

前提条件

  • ✓agent-memo.aiの無料APIトークン — agent-memo.ai
  • ✓Node.js 18+（npx用）
  • ✓MCP対応エージェント（Claude Code、Cursor、Windsurfなど）
1

APIトークンを取得

無料アカウントに登録し、ダッシュボードからAPIトークンをコピーしてください。

無料アカウントを作成
2

プロジェクトに設定を追加

以下からエージェントを選択してください。設定ファイルの場所と機能はエージェントごとに異なります。

.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
      }]
    }]
  }
}

フックが重要なタイミングでコンテキストを自動保存 — これがClaude Code + Agent-Memoを完全自動にする機能です。

SessionStart: 新しいセッション開始時にメモリを呼び出し。

Stop: 定期的に重要なコンテキストを保存。

PreCompact: コンテキストウィンドウ圧縮前に重要な情報を保存。

環境変数

変数必須説明
AGENTMEMO_TOKENはいダッシュボードから取得したAPIトークン
AGENTMEMO_PROJECTいいえプロジェクトID。省略時はgitリモートURLまたはディレクトリ名から自動検出
3

コーディング開始

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