에이전트의 기억을 연결하다
Claude Code, Cursor, Windsurf — 어떤 에이전트도 Nexus로 맥락을 공유합니다
2단계로 모든 에이전트에 연결
설정 파일을 직접 수정할 필요 없습니다
설정 코드 복사 → 붙여넣기 → 재시작
발급 완료 모달에서 에이전트를 선택하면 API 키가 이미 채워진 설정 코드가 나타납니다. 복사 후 해당 파일에 붙여넣고 에이전트를 재시작하면 끝입니다.
{
"mcpServers": {
"nexus": {
"command": "npx",
"args": ["-y", "@nunchiai/nexus-mcp"],
"env": {
"NEXUS_API_KEY": "nxs_••••••••••••"
}
}
}
}어떻게 쓰나요?
에이전트에서 세 가지 도구를 호출하기만 하면 됩니다
오늘 한 작업을 내일도 기억합니다
nexus_remember("RecallEngine threshold 0.2로 조정 — 한국어 임베딩 대응", "decision")새 세션을 열어도 맥락이 이어집니다
nexus_recall("지난번 Gravity 작업 내용")
// → "threshold 0.5→0.2 조정, 한국어 임베딩 대응..." 반환Claude Code에서 저장, Cursor에서 꺼냅니다
// Claude Code에서
nexus_remember("API 설계 결정 — REST 대신 GraphQL 채택", "decision")
// Cursor에서 (같은 Nexus, 같은 기억)
nexus_recall("API 설계 결정")도구 레퍼런스
| 도구 | 파라미터 | 설명 |
|---|---|---|
| nexus_remember | content, type | 기억 저장 |
| nexus_recall | query, depth? | 의미 기반 기억 검색 |
| nexus_sessions | limit? | 세션 이력 조회 |
| nexus_stats | — | MU 사용량 · atom 수 조회 |
| nexus_session | session_id | 특정 세션 atom chain 조회 |
| nexus_summary | limit? | 최근 세션 요약 (full chain) |
자주 묻는 질문
무료 체험이 가능한가요?
Nexus는 프리 플랜 없이 Starter ($9/월)부터 시작합니다. 30일 사용해본 후 계속 쓸지 결정하세요. 취소는 언제든 가능하며 잔여 기간 기억은 그대로 유지됩니다.
기억은 얼마나 보존되나요?
Starter 30일 · Pro 90일 · Infra 무제한. 보존 기간이 지나도 즉시 삭제되지 않습니다 — energy 점수가 낮은 오래된 기억부터 우선 정리됩니다.
MU(Memory Unit)가 무엇인가요?
API 사용량을 측정하는 단위입니다. nexus_remember = 1 MU, nexus_recall shallow = 1 MU, nexus_recall deep = 3 MU, nexus_session = 5 MU, nexus_summary = 5 MU. 월간 한도는 플랜에 따라 Starter 5,000 · Pro 25,000 · Infra 100,000 MU입니다.
v0.2에서 무엇이 추가됐나요?
3가지 새 MCP 도구가 추가됐습니다. nexus_stats — MU 사용량과 atom 수를 한눈에 확인. nexus_session — 특정 세션의 전체 atom chain과 인과관계(sequential · caused_by · contradicts) 조회. nexus_summary — 최근 N개 세션의 전체 내용을 한 번에 복기.
여러 프로젝트를 섞이지 않게 할 수 있나요?
환경변수 NEXUS_AGENT_NAME으로 에이전트별 기억이 자동 구분됩니다. 예를 들어 "project-a-claude", "project-b-cursor"처럼 설정하면 프로젝트마다 독립된 메모리 공간을 가집니다.
민감한 코드나 비밀키가 저장되나요?
저장되는 내용은 에이전트가 nexus_remember로 직접 호출한 것뿐입니다. 코드베이스를 자동 스캔하거나 대화 내용을 몰래 저장하지 않습니다. 저장하지 말아야 할 정보(API 키, 비밀번호 등)는 remember 호출 시 포함하지 마세요.
팀원과 기억을 공유할 수 있나요?
같은 API 키를 사용하는 에이전트들은 기억을 공유합니다. 팀 단위로 하나의 API 키를 공유하면 모든 팀원의 에이전트가 같은 컨텍스트를 갖습니다. 개인별로 격리하려면 각자 API 키를 발급하세요.
Norfolk와 Nexus는 어떻게 다른가요?
Norfolk는 개인/팀 지식 워크스페이스이고 OAuth 로그인 기반으로 플랜을 관리합니다. Nexus는 Claude Code·Cursor 같은 AI 에이전트의 외부 기억 API이며, OAuth로 키를 발급한 뒤 API 키 + 플랜 자격이 유효한 동안만 동작합니다. 두 서비스는 Synapsis Engine을 공유하지만 제품으로는 분리되어 있습니다.
어떤 AI 에이전트를 지원하나요?
MCP(Model Context Protocol)를 지원하는 모든 에이전트에서 사용할 수 있습니다. 현재 공식 지원: Claude Code · Cursor · Windsurf · Kilo Code. npx 명령 한 줄로 설치되므로 MCP를 지원하는 새 에이전트에도 즉시 적용됩니다.
한도 초과 시 어떻게 되나요?
monthly_mu_limit에 도달하면 API가 402 Payment Required를 반환합니다. 에이전트가 nexus_remember/recall 호출에 실패하지만 기존에 저장된 기억은 삭제되지 않습니다. 플랜 업그레이드 후 즉시 사용이 재개됩니다.
pgvector 검색은 어떻게 작동하나요?
nexus_recall은 두 단계로 검색합니다. ① 벡터 유사도 — OpenAI 임베딩으로 의미가 유사한 기억 우선 반환. ② energy 가중치 — 자주 참조되고 최신인 기억에 높은 점수 부여. 두 점수를 cosine(0.6) + energy(0.4) 가중합으로 랭킹합니다.
6가지 도구로 완성되는 기억
nexus_remember(content, type)작업 내용·결정·에러를 장기 기억에 저장합니다. 세션이 끝나도 사라지지 않습니다.
nexus_recall(query)자연어 쿼리로 과거 맥락을 의미 기반 검색합니다. 토큰 예산 내에서 최적 결과를 반환합니다.
nexus_sessions(limit?)최근 작업 세션 이력을 조회합니다. 언제 무엇을 했는지 빠르게 파악합니다.
nexus_stats()MU 사용량, atom 수, 잔여 쿼터를 확인합니다. 대규모 작업 전 예산 파악에 유용합니다.
nexus_session(session_id)특정 세션의 전체 atom chain을 조회합니다. 과거 작업 순서와 인과관계를 상세히 파악합니다.
nexus_summary(limit?)최근 세션의 전체 내용을 요약합니다. 새 세션 시작 전 이전 작업을 빠르게 복기합니다.
프리 플랜 없이 Starter부터
모든 플랜은 월 단위 구독 · 언제든 취소 가능
에이전트 협업의 새로운 기준
Claude Code에서 한 결정을 Cursor가 기억합니다
서로 다른 에이전트가 동일한 메모리 레이어를 공유합니다. 맥락 손실 없이 툴을 전환하세요.
세션이 끊겨도 맥락은 유지됩니다
Energy Decay 알고리즘이 중요한 기억은 오래, 오래된 기억은 자연스럽게 희미하게 관리합니다.
모든 에이전트가 같은 두뇌를 공유합니다
MCP 표준 기반으로 설정 몇 줄이면 끝. Claude, Cursor, Windsurf, Kilo Code 모두 지원.
에이전트에게 기억을 주세요
Starter $9/월로 시작하고, 팀 규모에 맞게 확장합니다.
Stripe 안전 결제 · 즉시 시작 · 언제든 취소 가능