설정 가이드

2분 만에 AI 코딩 에이전트에 영구 클라우드 메모리를 추가하세요. 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