# ainote

> AI 네이티브 태스크 + 메모리 + Vault + 다중 디바이스 동기화. MCP 서버.

## 페이지 색인

### 소개

- [docs.ainote.dev](https://docs.ainote.dev/README): ainote 의 공식 개발자 문서. VitePress 기반.
- [ainote — AI 네이티브 태스크 + 메모리 + 동기화](https://docs.ainote.dev/index): - AI 가 직접 호출 — createtask, createdevdoc 같은 MCP 도구로 Claude 가 너의 노트를 직접 편집. - 계정 없이 시작 — signupandgetkey 한 번이면 Claude 안에서 가입 → 바로 사용. - CLAUDE.md 중앙 관리 — 17개 프로젝트의 CLAUDE.md, Cursor rules, Windsurf rule

### CLI

- [환경변수 / .env 동기화](https://docs.ainote.dev/cli/env-sync): 여러 프로젝트의 .env 파일을 ainote + macOS Keychain 으로 안전 동기화.
- [ainote 커맨드라인](https://docs.ainote.dev/cli/): ainote 는 별도의 ainote CLI 명령을 제공하지 않습니다 — 대신 두 가지 방법으로 터미널에서 사용:
- [설치](https://docs.ainote.dev/cli/install): @ainote/mcp 패키지는 두 개의 바이너리를 설치합니다:
- [shell 함수 (curl wrapper)](https://docs.ainote.dev/cli/shell-function): Node 설치 없이 ainote 호출하는 가장 간단한 방법.

### 예시

- [Claude Code 자연어 사용](https://docs.ainote.dev/examples/claude-code): ainote MCP 등록 후 일상 워크플로우.
- [CLAUDE.md 멀티프로젝트 관리](https://docs.ainote.dev/examples/claude-md-multi): 17개+ 프로젝트의 CLAUDE.md 를 일관성 있게 유지.
- [.env 보안 동기화 패턴](https://docs.ainote.dev/examples/env-sync):  ┌─────────────────────────────────────────────────┐ │  값 (secret)  →  macOS Keychain                  │ │                  + iCloud Keychain (자동 sync)    │ │                                          
- [맥미니 ↔ 맥북 메모리 동기화](https://docs.ainote.dev/examples/multi-device): 실전 시나리오: 두 Mac 에서 같은 메모리/CLAUDE.md 사용.
- [새 디바이스 셋업 (5분)](https://docs.ainote.dev/examples/new-device): 새 Mac 받았다. ainote 모든 데이터 + 17개 프로젝트 CLAUDE.md + 메모리 + .env 복원.
- [Telegram 으로 외부에서 태스크 추가](https://docs.ainote.dev/examples/telegram): 집에서 출근길 — 지하철에서 빠르게 메모/태스크. Telegram 봇이 가장 빠름.

### 가이드

- [API Key 인증](https://docs.ainote.dev/guide/auth): ainote 는 두 종류의 키를 지원합니다.
- [데이터 내보내기 / 삭제](https://docs.ainote.dev/guide/data-export): ainote 의 모든 데이터는 너의 것. 언제든 가져갈 수 있고 삭제할 수 있습니다.
- [FAQ](https://docs.ainote.dev/guide/faq): | | ainote | Notion | Obsidian | |---|---|---|---| | AI 직접 호출 | ✅ MCP 17개 도구 | ❌ | △ 플러그인 | | 자연어 태스크 | ✅ | △ AI Add | ❌ | | Git backend | ✅ | ❌ | △ Sync 플러그인 | | 셀프호스팅 | ✅ | ❌ | ✅ | | 다중 디바이스 sync | 
- [5분 Quickstart](https://docs.ainote.dev/guide/quickstart): 계정 없이 바로 시작. Claude Code 기준 (다른 클라이언트는 MCP 섹션(/mcp/overview) 참고).
- [계정 만들기 (MCP 안에서)](https://docs.ainote.dev/guide/signup): ainote 의 가장 흥미로운 기능 — 웹사이트 방문 없이 Claude/Cursor 안에서 바로 가입.
- [Troubleshooting](https://docs.ainote.dev/guide/troubleshooting): 증상: Claude Code /mcp 에 ainote 보이지 않음.
- [ainote 란?](https://docs.ainote.dev/guide/what-is-ainote):  한 줄: AI 가 직접 쓰는 노트 앱. 태스크 + 메모리 + Dev Docs 를 MCP 도구로 노출해서 Claude/Cursor/ChatGPT 가 자연어로 조작합니다.

### MCP 통합

- [ChatGPT 연결 (SSE)](https://docs.ainote.dev/mcp/chatgpt): ChatGPT (Plus/Pro/Team) 의 MCP connector 로 ainote 사용.
- [Claude Code 연결](https://docs.ainote.dev/mcp/claude-code): Claude Code (CLI) 에서 ainote 를 MCP 서버로 등록.
- [Claude Desktop 연결](https://docs.ainote.dev/mcp/claude-desktop): Claude Desktop (macOS / Windows 데스크톱 앱) 에서 ainote 사용.
- [Cursor / Windsurf 연결](https://docs.ainote.dev/mcp/cursor): Cursor 와 Windsurf 는 hosted HTTP transport 를 1급 지원. Claude Code 와 거의 동일.
- [MCP 란? (30초 정리)](https://docs.ainote.dev/mcp/overview): MCP (Model Context Protocol) = Anthropic 이 만든 "AI ↔ 도구" 표준 프로토콜.
- [Telegram 연결 (Clawdbot)](https://docs.ainote.dev/mcp/telegram): ainote 의 Telegram 봇 — 모바일에서 자연어로 태스크/메모 외부에서 추가.
- [3가지 transport 비교](https://docs.ainote.dev/mcp/transports): ainote 는 같은 17개 도구 카탈로그를 3가지 transport 로 제공.

### 메모리 / Dev Docs

- [카테고리 / 폴더 구조](https://docs.ainote.dev/memory/categories): Dev Docs 의 category 는 ainote vault 의 디렉토리 결정.
- [CLAUDE.md 통합 관리](https://docs.ainote.dev/memory/claude-md): 17개+ 프로젝트의 CLAUDE.md 를 ainote 한 곳에서.
- [Cursor / Windsurf 룰](https://docs.ainote.dev/memory/cursor-windsurf): .cursorrules, .windsurfrules, .github/copilot-instructions.md 도 CLAUDE.md 와 같은 패턴(/memory/claude-md) 으로 ainote 에 통합 관리.
- [메모리 / Dev Docs 개요](https://docs.ainote.dev/memory/overview): ainote 의 두 번째 1급 시민 — Claude/Cursor/Windsurf 가 공유하는 마크다운 메모리.
- [4가지 메모리 타입](https://docs.ainote.dev/memory/types): ainote 의 토픽 메모리는 type 필드로 분류. Claude 가 자동으로 적절한 타입 선택.

### API 레퍼런스

- [인증 헤더](https://docs.ainote.dev/reference/auth): http Authorization: McpKey <KEY 
- [변경 로그](https://docs.ainote.dev/reference/changelog): semver 비슷하지만 v1 이전이라 minor breaking 가능.
- [create_dev_doc](https://docs.ainote.dev/reference/create-dev-doc): 새 devdoc / 메모리 등록.
- [create_task](https://docs.ainote.dev/reference/create-task): 새 태스크 생성. 필수 필드: content.
- [delete_dev_doc](https://docs.ainote.dev/reference/delete-dev-doc): devdoc soft delete.
- [delete_task](https://docs.ainote.dev/reference/delete-task): 태스크 삭제 — soft delete (서버에서 30일 후 영구 정리).
- [에러 코드](https://docs.ainote.dev/reference/errors): JSON-RPC 표준 + ainote 확장.
- [get_dev_doc](https://docs.ainote.dev/reference/get-dev-doc): 단일 devdoc 조회 (전체 본문 포함).
- [API 레퍼런스](https://docs.ainote.dev/reference/): ainote MCP 서버의 전체 도구 카탈로그.
- [JSON-RPC 호출 형식](https://docs.ainote.dev/reference/json-rpc): ainote 의 모든 MCP 도구는 JSON-RPC 2.0(https://www.jsonrpc.org/specification) over HTTP POST.
- [list_categories](https://docs.ainote.dev/reference/list-categories): 태스크 카테고리 목록.
- [list_dev_categories](https://docs.ainote.dev/reference/list-dev-categories): dev/ 아래 사용 중인 모든 카테고리 목록.
- [list_dev_docs](https://docs.ainote.dev/reference/list-dev-docs): devdocs 검색 + 필터.
- [list_tasks](https://docs.ainote.dev/reference/list-tasks): 태스크 조회 — 자연어 + 18개 필터 지원.
- [login_and_get_key](https://docs.ainote.dev/reference/login): 기존 계정 로그인 + 새 MCP 키 발급. 인증 헤더 불필요.
- [pull_dev_docs](https://docs.ainote.dev/reference/pull-dev-docs): devdocs 일괄 복원 — localpath 기준으로 로컬 파일 생성/덮어쓰기.
- [get_setup_guide](https://docs.ainote.dev/reference/setup-guide): 클라이언트별 설정 가이드 반환. 인증 헤더 불필요.
- [signup_and_get_key](https://docs.ainote.dev/reference/signup): 신규 가입 + MCP 키 발급. 인증 헤더 불필요.
- [sync_list](https://docs.ainote.dev/reference/sync-list): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: ainote hub 의 sync 대상 파일 메타데이터 조회 (co
- [sync_pull](https://docs.ainote.dev/reference/sync-pull): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: ainote hub → 로컬. 변경된 파일 받기.
- [sync_push](https://docs.ainote.dev/reference/sync-push): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: 로컬 파일 → ainote hub. sync 시스템(/sync/o
- [update_dev_doc](https://docs.ainote.dev/reference/update-dev-doc): 기존 devdoc 수정.
- [update_task](https://docs.ainote.dev/reference/update-task): 기존 태스크 수정. id 필수, 변경할 필드만 지정.
- [vault_clone](https://docs.ainote.dev/reference/vault-clone): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: vault 를 로컬에 git clone. 자세한 가이드: vaul
- [vault_connect_status](https://docs.ainote.dev/reference/vault-connect-status): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: vault 의 git 연결 상태 진단.
- [vault_create](https://docs.ainote.dev/reference/vault-create): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: 새 vault 생성. 자세한 가이드: vault/create(/v
- [vault_list](https://docs.ainote.dev/reference/vault-list): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: 사용자의 모든 vault 목록.
- [vault_sync](https://docs.ainote.dev/reference/vault-sync): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: vault 양방향 동기화. 자세한 가이드: vault/sync(/

### 동기화

- [sync-now 알고리즘](https://docs.ainote.dev/sync/algorithm): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: ~/.claude/ainote-sync/tools/sync-now
- [아키텍처 — Star Topology](https://docs.ainote.dev/sync/architecture): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: ainote sync 는 hub-and-spoke (별 모양). 
- [충돌 해결 (LWW + 5분 임계)](https://docs.ainote.dev/sync/conflicts): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. :::  핵심: 5분 안에 양쪽 변경 → 양쪽 보존 + 사용자 선택. 5
- [폴더 구조 권장](https://docs.ainote.dev/sync/folder-structure): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: ainote vault 안의 디렉토리 구조 베스트 프랙티스.
- [HLC 시간 모델](https://docs.ainote.dev/sync/hlc): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: Hybrid Logical Clock — wall clock + 
- [manifest.yml 작성](https://docs.ainote.dev/sync/manifest): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: 각 디바이스의 sync 매핑 정책. 로컬 파일 ↔ ainote p
- [다중 디바이스 동기화 개요](https://docs.ainote.dev/sync/overview): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: ainote 는 Star topology + HLC + LWW 모
- [왜 별도 sync 시스템 (vs Dropbox)](https://docs.ainote.dev/sync/why): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. :::  짧은 답: Dropbox 는 파일을 sync 하지만, ainot

### 태스크

- [카테고리](https://docs.ainote.dev/tasks/categories): 태스크 분류 라벨.
- [날짜 / 위치 / 알림](https://docs.ainote.dev/tasks/due-date): createtask 의 content 안에 시간 표현 → 자동 파싱:
- [필터링 (18개 옵션)](https://docs.ainote.dev/tasks/filtering): listtasks 의 모든 필터.
- [태스크 개요](https://docs.ainote.dev/tasks/overview): ainote 의 첫 번째 1급 시민 — AI 가 직접 추가/수정/삭제하는 할 일.

### Vault

- [vault_clone](https://docs.ainote.dev/vault/clone): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: 기존 vault 를 로컬에 git clone. 또는 외부 git 
- [vault_create](https://docs.ainote.dev/vault/create): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: 새 vault 생성 — 빈 git repo 가 백엔드.
- [Git backend](https://docs.ainote.dev/vault/git-backend): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: ainote 의 vault 는 모두 git 저장소. 데이터는 너의
- [Vault 개요](https://docs.ainote.dev/vault/overview): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: ainote 의 세 번째 1급 시민 — Obsidian 호환 마크
- [vault_sync](https://docs.ainote.dev/vault/sync): ::: warning 🚧 설계 단계 — 아직 구현 안 됨 이 페이지는 ainote 의 향후 기능을 미리 문서화한 것입니다. 현재 @ainote/mcp v1.1.x 에는 vault / sync 도구가 포함돼 있지 않습니다. 도구 호출 시 Tool not found 에러를 받게 됩니다. ::: vault 양방향 동기화 — pull 후 push.