모든 답에 출처가 붙습니다
엔티티·관계 응답마다 그것을 뒷받침하는 문서(docs)와 외부 레퍼런스(refs)가 실립니다. 틀렸을 때 어디가 틀렸는지 짚을 수 있습니다.
src/kal_mcp.py지하철 · 폰 · claude.ai
3월에 그 아키텍처 논의에서 인증을 뭘로 정했지?
세션 쿠키(HttpOnly · SameSite)에 서명을 붙이는 쪽으로 정했다. JWT 는 발급 뒤 폐기가 안 된다는 이유로 기각.
- wiki/decisions/auth.md
- raw/conversations/sessions/2026-03-14-arch.md
내 지식을 아는 Claude 를, 어느 기기에서나.
Obsidian 노트와 Claude Code 대화가 하나의 검색 가능한 그래프가 됩니다. 모든 답에 출처가 붙습니다.
무료로 셀프호스트 →AGPL-3.0 · Docker 한 줄
클라우드 시작 →$15/월 연납
- 376
- 문서
- 8,179
- 엔티티
- 12,355
- 관계
- 100MB
- 그래프
제작자의 vault 실측 · 2026-08-29 · 노트 1,129개(47MB) → 색인·그래프 100MB · 파일 80개
클로드 코드 기억 —— 노트만이 아니라 대화까지
한국어가 실제로 검색됩니다
multilingual-e5-small 임베딩에 2·3-gram 전문 색인을 겹칩니다. 한국어에서 무너지는 임베딩 하나로는 안 되는 일입니다.
src/kal_search.pyClaude Code 대화도 그래프에 들어갑니다
세션 로그를 정제해 노트와 같은 그래프에 넣습니다. "저번에 뭐라고 결정했지" 의 답은 대개 대화 안에 있습니다.
src/distill_sessions.py검색이 아니라 질문입니다.
Obsidian 검색은 문자열을 찾습니다. 이것은 "그때 그 결정을 왜 그렇게 했지" 에 답합니다 —— 노트와 대화를 엔티티와 관계로 엮어 두었기 때문입니다.
어떻게 동작하나 →당신의 vault 가 은하가 됩니다
합성 데이터로 그린 예시 —— 진짜 그림은 당신 vault 에서 나옵니다. Obsidian 안에서 보는 플러그인이 함께 있습니다.
로컬 RAG 옵시디언은 무료. 클라우드는 그래프가 사는 곳이 다릅니다.
클라우드 · 영속성
재시작을 넘어 사는 그래프
- 한 번 만든 그래프가 기기를 넘어 남습니다
- 어느 기기에서 물어도 같은 답
- 노트북을 바꿔도 다시 추출하지 않습니다
- laptop ─┐
- phone ─┼─▶ graph ─▶ same answer
- claude.ai ┘
클라우드 · 색인
기계가 자도 색인은 깨어 있습니다
- 항상 켜진 원격 MCP 엔드포인트
- claude.ai · Claude Code · ChatGPT · Gemini 에서 바로
- Claude Code 의 stdio MCP 는 그대로 무료
- 03:14 laptop sleeping
- 03:14 mcp listening
- 03:15 phone → query → answer + sources
무료 · 셀프호스트
Docker 한 줄로 전부
- vault 무제한
- 웹 UI 와 갤럭시 뷰 포함
- AGPL-3.0 —— 코드가 전부 열려 있습니다
- $ docker compose up -d
- api running
- web running → http://localhost:5173
아키텍처
추출은 당신의 기계에서. 서버는 LLM 을 부르지 않습니다
- 엔티티 추출은 당신의 Claude 구독으로, 로컬에서
- 클라우드로 가는 것은 색인에 필요한 형태뿐 —— vault 폴더를 그대로 미러링하지 않습니다
- 그래서 서버 원가가 저장뿐이고, 가격이 정액입니다
- Obsidian vault + Claude 세션 로그
- │ 추출 (당신 기계 · 당신 구독)
- ▼ 그래프 100MB
- │ push
- ▼ 클라우드 저장
- │
- ▼ 원격 MCP
프라이버시 —— 먼저 말합니다
클라우드에 올라가는 것은 메타데이터가 아니라 지식 그 자체입니다
엔티티 이름, 관계, 검색용 청크 본문. 서버가 검색해 주려면 읽을 수 있어야 하고, 그래서 종단간 암호화가 불가능합니다. 나중에 들키는 것보다 지금 말하는 편이 낫습니다.
- Obsidian 을 쓰는 이유가 프라이버시라면 무료 셀프호스트를 쓰십시오. 기능이 같습니다.
- 서버는 당신 노트로 LLM 을 돌리지 않습니다. 추출은 당신 기계에서, 당신 구독으로 합니다.
- 서버 코드도 AGPL 로 공개됩니다 —— 첫 외부 사용자를 받기 전에. "못 읽는다" 대신 "무엇을 하는지 코드로 보여준다".
자주 묻는 것
무료판과 클라우드는 뭐가 다른가요?
기능은 같습니다. 다른 것은 그래프가 어디 사느냐입니다. 셀프호스트는 그 기계 안에, 클라우드는 기계를 넘어 남아서 claude.ai 와 폰에서도 같은 답을 받습니다.
왜 월 $19 인가요?
같은 종류의 오픈소스+호스팅 도구(Plausible · Umami · n8n · Ghost)가 서 있는 자리입니다. 연납이면 월 $15 입니다.
제 노트가 서버에 올라가나요?
클라우드를 쓰면 예 —— 엔티티·관계·검색용 청크 본문이 올라갑니다. 서버가 검색하려면 읽어야 해서 종단간 암호화는 불가능합니다. 프라이버시가 이유라면 셀프호스트를 쓰십시오. 기능이 같습니다.
서버가 제 노트로 LLM 을 돌리나요?
아니요. 엔티티 추출은 당신 기계에서 당신의 Claude 구독으로 돌고, 서버는 그 결과를 저장하고 검색만 합니다.
회사 법무팀이 AGPL 을 막습니다
같은 코드를 다른 라이선스로 드립니다. 메일로 문의하십시오 —— 가격은 문의가 오면 정합니다.
한국어 검색이 되나요?
됩니다. multilingual-e5-small 임베딩과 2·3-gram 전문 색인을 겹쳐서, 한국어 vault 에서 실측으로 검색됩니다.
내 지식을 아는 Claude 를, 어느 기기에서나.
무료로 시작해서, 폰에서도 쓰고 싶어질 때 클라우드로.