세션을 넘나드는 기억

AI 에이전트는 기본적으로 세션을 종료하면 모든 맥락을 잃어버립니다. memtomem을 연결하면 한 세션에서 알려준 내용이 영구 저장되어, 이후 어떤 세션·어떤 에이전트에서도 자연어 질문으로 되찾을 수 있습니다. 이 튜토리얼은 그 흐름을 실제로 따라가 봅니다.

전제 조건

빠른 시작을 완료하여 memtomem이 설치·초기화되고 MCP 클라이언트(Claude Code, Cursor, Claude Desktop 등)에 연결된 상태여야 합니다.

세션 A: 기억 저장

첫 번째 세션에서 에이전트에게 다음처럼 자연어로 지시합니다.

“이 사실을 기억해둬: 우리 팀은 이번 분기에 마이그레이션 중단. 이유는 legal 검토 대기 중.”

에이전트는 mem_add 도구를 호출해 내용을 저장하고, 네임스페이스와 ID가 포함된 확인 메시지를 반환합니다.

CLI로 저장 여부를 검증하려면:

mm search "마이그레이션 중단"

방금 저장한 항목이 상위 결과로 나타나야 합니다. 또는 mm web으로 브라우저 대시보드를 열어 시각적으로 확인할 수 있습니다.

세션 종료

에이전트 세션을 완전히 종료합니다. Claude Code라면 터미널을 닫고, Claude Desktop이라면 앱을 재시작해도 됩니다. memtomem 서버 자체는 다음 호출 때 자동 실행되므로 별도 조작이 필요하지 않습니다.

세션 B: 기억 복원

새 세션을 시작한 뒤 다음처럼 질문합니다.

“우리 팀 마이그레이션 상태 어때? 이전 세션에서 얘기했던 것 같은데.”

에이전트는 MCP 도구 설명을 기반으로 mem_search를 자동 호출하여 세션 A에서 저장한 항목을 찾아냅니다. “legal 검토 대기 중”이라는 이유까지 포함된 응답을 받을 수 있어야 합니다.

무슨 일이 일어났는가

세션 A: 에이전트 → mem_add("마이그레이션 중단, 이유 legal 검토") → SQLite
         (BM25 FTS5 + vector 인덱스 동시 기록)

세션 B: 에이전트 → mem_search("마이그레이션 상태") → 하이브리드 검색
                                                   → 같은 청크를 상위로 반환

저장·검색 모두 로컬 SQLite에서 처리되며, 세션 간 별도 동기화가 필요하지 않습니다. 검색 엔진 동작 원리는 하이브리드 검색을 참조하세요.

흔한 함정

• 에이전트가 mem_search를 호출하지 않는 경우 — 질문이 과거 맥락임을 명시해야 도구 호출이 트리거됩니다. “이전에 말했던”, “아까 저장한”, “기억해뒀던” 같은 표현을 포함하세요.
• 결과가 비어 있는 경우 — mm status로 서버 연결과 네임스페이스를 확인하세요. 세션 A와 B가 다른 네임스페이스를 사용 중일 수 있습니다. 기본 네임스페이스는 mm init 설정값을 따릅니다.

다음 단계

• 하이브리드 검색 — 원하는 결과가 나오지 않을 때 검색을 튜닝하는 방법
• STM 개요 — 에이전트가 명시 요청 없이도 관련 기억을 자동으로 받아보게 하려면 STM 프록시 추가를 고려하세요
• 멀티 에이전트 협업 — 기억을 여러 에이전트가 공유하도록 네임스페이스 설계