vault_create

🚧 설계 단계 — 아직 구현 안 됨

이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다.

새 vault 생성 — 빈 git repo 가 백엔드.

시그니처

{
  "name": "personal",
  "description": "개인 노트",
  "private": true,
  "init_files": ["README.md"]
}

파라미터	타입	필수	설명
name	string	✅	URL-safe 영소문자 + -
description	string		사람용 설명
private	boolean		기본 true (혼자만 보임)
init_files	array		초기 생성 파일 목록

응답

{
  "id": 42,
  "name": "personal",
  "git_url": "https://api.ainote.dev/vaults/me/personal.git",
  "clone_command": "git clone https://api.ainote.dev/vaults/me/personal.git",
  "web_url": "https://ainote.dev/vaults/personal",
  "size_bytes": 0,
  "file_count": 1
}

Claude 사용

ainote 에 "personal" vault 만들어줘

또는 더 명시적:

ainote vault_create — name: work, description: 회사 노트, private: true

생성 직후

ainote 가 자동으로:

1. PostgreSQL 에 vault row 생성
2. git bare repo 초기화 (vaults/<user_id>/<name>.git)
3. init_files 있으면 placeholder 파일 commit
4. SSH/HTTPS 인증 설정 (사용자 키 기반)

로컬 클론

만든 vault 를 로컬에서 쓰려면:

git clone https://api.ainote.dev/vaults/me/personal.git ~/notes/personal

또는 MCP 로:

ainote vault_clone personal 을 ~/notes/personal 에

이름 규칙

• 영소문자, 숫자, - 만
• 1~50자
• 숫자로 시작 X
• 예약어: git, api, system, admin

유효성 위반 시:

{ "error": "invalid name: must match ^[a-z][a-z0-9-]{0,49}$" }

권한

• private: true (기본) — 본인만 (MCP key 인증)
• private: false — 공개 read (git clone 인증 없이)
• 공유 (계획됨, v0.5): 다른 사용자 collaborator 추가

에러

코드	메시지	해결
-32602	invalid name	이름 규칙 확인
-32603	name already exists	다른 이름
-32004	quota exceeded	vault 100개 한도

다음

• vault_clone — 다른 기기에서 가져오기
• vault_sync — 양방향
• Vault 개요