Vault 개요
✅ 라이브 (서버)
vault_* / sync_* 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk (ai.vault.* / ai.sync.*)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp npm 패키지 구버전엔 번들이 안 됐을 수 있으니 직접 JSON-RPC 또는 SDK 사용 권장.)
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가지 타입 자동 분류 가능.