Vault 개요
🚧 설계 단계 — 아직 구현 안 됨
이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다.
ainote 의 세 번째 1급 시민 — Obsidian 호환 마크다운 저장소, git 백엔드.
Vault 가 뭔가
Obsidian 의 vault 와 동일 개념:
- 폴더 1개 = vault 1개
- 안에 마크다운 파일들 자유롭게 (서브폴더 OK)
[[wikilinks]]호환- 프론트매터 YAML 지원
차이점:
- git 백엔드 — 모든 변경 자동 commit
- MCP 노출 — Claude 가 직접 read/write
- 다중 디바이스 — 여러 기기에서 같은 vault clone
5개 MCP 도구
| 도구 | 용도 |
|---|---|
vault_create | 새 vault (빈 git repo) |
vault_clone | 다른 기기/Obsidian vault 가져오기 |
vault_sync | pull → 변경사항 → push 양방향 |
vault_list | 등록된 vault 목록 |
vault_connect_status | git 상태 확인 |
사용 시나리오
A. 처음 시작 — 빈 vault
ainote 에 "personal" 이라는 vault 만들어줘→ vault_create → git repo 생성 → 다른 도구에서 사용 가능.
B. 기존 Obsidian 마이그레이션
~/Documents/Obsidian/MyVault 를 ainote 에 vault_clone 해줘→ git push → ainote 가 hosting → 다른 기기에서 vault_clone 으로 받기.
C. 다중 기기 동기화
맥미니에서 노트 작성 → vault_sync (자동 commit + push) → 맥북에서 vault_sync (pull) → 변경 도착.
폴더 구조 권장
my-vault/
├── daily/ # 일일 메모
│ └── 2026-05-07.md
├── projects/ # 프로젝트 노트
│ ├── ainote.md
│ └── tennis-bracket.md
├── reference/ # 참고 자료
│ ├── books/
│ └── articles/
├── meta/ # vault 자체 메타
│ └── README.md
└── .obsidian/ # Obsidian 설정 (선택)충돌 해결
vault_sync 시 Git 3-way merge:
- 같은 파일 같은 줄 양쪽 수정 → conflict marker → 수동 해결
- 다른 파일 / 다른 줄 → 자동 merge
자세히: 동기화 충돌 해결.
Obsidian 양방향
기존 Obsidian vault 를 ainote 에 등록하면:
- 로컬 파일 시스템 = ainote vault git working tree
- Obsidian 으로 편집 →
vault_sync→ ainote 반영 - Claude 가 ainote 로 편집 →
vault_sync(pull) → Obsidian 새로고침에 보임
Obsidian Sync 대체
Obsidian 의 유료 Sync 플러그인 ($5/mo) 대신 ainote vault 무료로 사용 가능.
Frontmatter 규칙
ainote 메모리는 frontmatter 표준:
markdown
---
name: my-note
description: 한 줄 요약
type: project | feedback | reference | user
ainote_sync: vault-name/path/in/vault.md # sync 대상이면
---
# 본문이 형식 따르면 메모리 4가지 타입 자동 분류 가능.