ainote

테마

vault_clone ​

✅ 라이브 (서버)

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 사용 권장.)

기존 vault 의 GitHub clone URL 을 회수한다. ainote 는 git 트래픽을 proxy 하지 않으므로, 서버가 clone 을 대신 수행하지는 않고 URL 과 실행할 git 명령만 돌려준다. 사용자가 그 명령으로 직접 clone 한다.

시그니처 ​

인자필수설명
name✅vault 이름 또는 slug
target_path반환 안내에 쓸 로컬 clone 경로 (선호값)
json
{ "name": "personal", "target_path": "~/vaults/personal" }

응답 ​

vault 의 GitHub clone URL 과 실행할 git 명령을 돌려준다:

json
{
  "github_repo_full_name": "me/personal",
  "clone_url_https": "https://github.com/me/personal.git",
  "clone_url_ssh":   "git@github.com:me/personal.git",
  "target_path":     "~/vaults/personal",
  "command":         "git clone https://github.com/me/personal.git ~/vaults/personal"
}

새 기기 셋업 ​

반환된 command 로 직접 clone 한다 (GitHub 자격증명 사용):

bash
git clone https://github.com/me/personal.git ~/vaults/personal
cd ~/vaults/personal

이후 편집·commit·push 는 GitHub 표준 그대로. push 하면 GitHub webhook 이 ainote 를 깨워 재인덱싱한다.

전제 — GitHub 연결 ​

vault 가 GitHub 에 연결돼 있어야 clone URL 이 있다. vault_connect_status 로 설치를 확인하고, 미연결이면 GitHub App 설치 후 vault_create 로 repo 를 만든다.

인증 ​

GitHub 표준 자격증명 — ainote MCP 키는 clone 에 관여하지 않는다.

로컬 경로 권장 ​

  • 짧고 명시적 (~/vaults/personal 좋음, 깊게 중첩된 경로 나쁨)
  • iCloud Drive 비추 — git 과 충돌
  • TimeMachine 백업 대상 폴더 안 비추 — 백업이 무거워짐

Obsidian 호환 ​

vault 는 Obsidian 호환 마크다운 폴더다. clone 후 Obsidian 에서 "Open folder as vault" → 로컬 clone 경로 선택. 임시 캐시는 .gitignore 로 제외:

# .gitignore (vault root)
.obsidian/workspace*
.obsidian/cache
.obsidian/plugins/*/data.json

다음 ​