AnchorMindANCHORMIND
SIGN IN

Documentation

AnchorMind MCP 서버 연동과 기억 도구 사용법.

1. Getting Started

  1. GitHub로 가입하고 관리자 승인을 받는다.
  2. 콘솔에서 API 액세스 키를 발급한다.
  3. 사용하는 에이전트(Claude Code·Cursor 등)에 MCP 서버를 등록한다.
  4. 첫 remember → recall 왕복으로 연동을 검증한다.

2. 연결 정보

엔드포인트는 Streamable HTTP(JSON-RPC)이며, 인증은 Bearer 헤더를 사용한다.

Endpoint: https://memento.anchormind.net/mcp
Auth: Authorization: Bearer <ACCESS_KEY>

3. Claude Code 연동

프로젝트 루트의 .mcp.json 또는 ~/.claude.json에 서버를 등록한다. 템플릿은 Downloads에서 받을 수 있다.

{
  "mcpServers": {
    "anchormind": {
      "type": "http",
      "url": "https://memento.anchormind.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_KEY"
      }
    }
  }
}

4. Cursor 연동

~/.cursor/mcp.json에 동일한 서버를 등록한다.

{
  "mcpServers": {
    "anchormind": {
      "url": "https://memento.anchormind.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_KEY"
      }
    }
  }
}

5. 기억 도구 레퍼런스

context세션 시작 시 Core/Working Memory 로드.
PARAMS선택: tokenBudget(기본 2000) · types(기본 preference·error·procedure) · sessionId · structured · workspace
RETURNSANCHOR/CORE MEMORY 파편 목록, _meta.hints
recall파편 검색. 키워드/시맨틱/하이브리드 자동 라우팅.
PARAMSkeywords · text(자연어) · topic 중 1개 이상 권장 / 선택: type · tokenBudget(기본 1000) · caseMode · depth · timeRange · threshold · pageSize
RETURNSfragments[], _meta.searchEventId · hints · suggestion
remember자기완결적 사실 1건 저장(1~3문장, 300자 권장).
PARAMS필수: content(4000자 초과 거부) · topic · type / 선택: keywords(3~5개) · importance · isAnchor · caseId · supersedes
RETURNS생성 파편 id, validation_warnings
batch_remember다건 일괄 저장(최대 200건, 단일 트랜잭션).
PARAMS필수: fragments[] (항목별 content · topic · type) / 선택: async(비동기 큐 적재)
RETURNS동기: 저장 결과 / async: accepted 수와 jobId
batch_statusbatch_remember(async) 잡 처리 상태 조회. 읽기 전용.
PARAMS필수: jobId
RETURNSstate(queued|processing|completed|dead) · accepted · processed · failed
reflect세션 학습 내용을 원자 파편으로 영속화.
PARAMSsummary 또는 sessionId 중 1개 이상 필수 / 선택: decisions · errors_resolved · new_procedures · open_questions · narrative_summary
RETURNS생성 파편 목록, _meta.link_suggestions
amend기존 파편 수정. 변경 필드만 전달.
PARAMS필수: id / 선택: content · topic · keywords · importance · assertionStatus(observed|inferred|verified|rejected)
RETURNS갱신 결과
forget해결된 에러·불필요 파편 삭제.
PARAMSid 또는 topic / 선택: force(permanent 파편 강제 삭제)
RETURNS삭제 결과
link파편 간 인과·관계 연결.
PARAMS필수: fromId · toId / 선택: relationType(related 기본, caused_by · resolved_by · part_of · contradicts) · weight
RETURNS링크 생성 결과
graph_explore에러 인과 관계 추적(RCA).
PARAMS필수: startId(error 파편 권장)
RETURNScaused_by/resolved_by 1-hop 인과 그래프
fragment_history파편 변경 이력 조회.
PARAMS필수: id
RETURNSamend 이전 버전, superseded_by 체인
reconstruct_history케이스 작업 히스토리를 시간순 재구성.
PARAMScaseId 또는 entity 중 하나 필수 / 선택: timeRange · query · limit(기본 100)
RETURNSordered_timeline · causal_chains · unresolved_branches · case_events · summary
search_traces파편 테이블 경량 탐색(grep식 필터).
PARAMS선택: event_type · entity_key · keyword · case_id · session_id · time_range · limit(기본 20)
RETURNStraces[] · count
tool_feedback검색 유용성 피드백(링크 가중치 학습).
PARAMS필수: tool_name · relevant · sufficient / 선택: fragment_ids · search_event_id
RETURNS피드백 반영 결과
memory_stats기억 통계·할당량 조회.
PARAMS없음
RETURNS파편 수 · 할당량 등 통계
memory_consolidate수동 GC 트리거(master key 전용).
PARAMS없음
RETURNSTTL 전환 · 감쇠 · 만료 삭제 · 중복 병합 결과
session_rotate현재 세션 종료 후 새 sessionId 발급.
PARAMS선택: reason(감사 로그 기록)
RETURNS새 sessionId
get_skill_guideSKILL.md 활용 가이드 반환.
PARAMS선택: section(overview · lifecycle · tools 등)
RETURNS전체 가이드(약 12KB) 또는 지정 섹션

6. 연동 검증

연결 후 다음 체크리스트로 왕복을 확인한다.

  1. context 호출 → ANCHOR/CORE MEMORY 응답 확인(신규 계정은 빈 목록이 정상).
  2. remember로 파편 1건 저장 → 응답의 success와 파편 id 확인.
  3. recall로 해당 키워드 검색 → 방금 저장한 파편이 반환되면 정상.
  4. 세션 종료 시 reflect 호출 → 요약 파편 생성 확인.

7. curl 폴백

MCP 세션이 만료되면 JSON-RPC로 직접 호출한다. initialize로 세션을 발급받아 MCP-Session-Id 헤더로 전달한다.

1. 세션 초기화 — 응답 헤더의 MCP-Session-Id를 보관

SESSION_ID=$(curl -s -X POST https://memento.anchormind.net/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_KEY" \
  -D - \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}' \
  2>/dev/null | grep -i "^mcp-session-id" | tr -d '\r' | awk '{print $2}')

2. 도구 호출 — remember 예시

curl -s -X POST https://memento.anchormind.net/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_KEY" \
  -H "MCP-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
    "name":"remember",
    "arguments":{"content":"connection test","topic":"setup","type":"fact"}
  }}'

3. 응답 검증