ainote

테마

vault_create ​

✅ 라이브 (서버)

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 를 사용자 계정 아래 private GitHub repository 로 생성한다.

전제 — GitHub App 설치

먼저 ainote GitHub App 을 설치해야 한다. vault_connect_status 로 확인하고, 미설치면 반환된 install_url 로 설치한다.

시그니처 ​

json
{
  "name": "personal",
  "description": "개인 노트"
}
파라미터타입필수설명
namestring✅vault 이름. slug 이 파생되어 GitHub repo 이름이 됨
descriptionstringGitHub repo 설명 (선택)

응답 ​

json
{
  "slug": "personal",
  "github_repo_full_name": "me/personal",
  "is_primary": false,
  "indexed_files_count": 0
}

repo 는 private 으로 생성된다 (GitHub repo 가시성 정책을 따름).

Claude 사용 ​

ainote 에 "personal" vault 만들어줘

생성 직후 ​

ainote 가:

  1. 사용자 GitHub 계정에 private repo (<owner>/<slug>) 생성
  2. FileIndex 로 인덱싱 시작 (파일이 push 되면 GitHub webhook 으로 재인덱싱)

이후 vault_clone 이 준 URL 로 로컬에 clone 한다:

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

이름 규칙 ​

  • 영소문자, 숫자, -
  • slug 은 GitHub repo 이름 규칙을 따름

다음 ​