# ainote

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

## 페이지 색인

### agents

- [Anthropic Claude API 에 ainote 붙이기 (tool use)](https://docs.ainote.dev/agents/anthropic-api): Anthropic Claude API 의 tool use 파라미터로 ainote OpenAPI 3.1 mirror 의 26 도구를 변환·사용.
- [Claude Code 에 ainote 붙이기 (HTTP MCP)](https://docs.ainote.dev/agents/claude-code): Claude Code의 HTTP MCP 설정과 키 발급 방법, 연결 확인 및 오류 해결 가이드. npm 패키지 설치 없이 ainote의 태스크·메모리·Vault 도구 사용.
- [Claude Desktop 에 ainote 붙이기 (stdio MCP)](https://docs.ainote.dev/agents/claude-desktop): npm @ainote/mcp 패키지로 Claude Desktop 에 ainote 26 도구를 stdio transport 로 연결.
- [Cursor 에 ainote 붙이기](https://docs.ainote.dev/agents/cursor): Cursor IDE에서 ainote MCP 도구를 연결하는 가이드. HTTP 연결과 npm 기반 stdio 설정, MCP 키 등록 및 재시작 후 태스크 조회로 동작 확인.
- [에이전트 진영별 가이드 — ainote 어디서든](https://docs.ainote.dev/agents/): Claude / Cursor / Windsurf / ChatGPT / LangChain / AutoGen 등 5개 에이전트 진영에서 ainote 26 도구를 어떻게 쓰는지.
- [LangChain · LangGraph · AutoGen 에 ainote 붙이기](https://docs.ainote.dev/agents/langchain): ainote OpenAPI 3.1 mirror를 Python 에이전트의 remote tool로 등록하는 가이드. LangChain 설정, LangGraph 도구 래핑과 AutoGen·CrewAI 연동 예시.
- [OpenAI Custom GPT 에 ainote 붙이기 (OpenAPI 3.1 Actions)](https://docs.ainote.dev/agents/openai-custom-gpt): ChatGPT Custom GPT Actions 의 'Import from URL' 로 ainote 26 도구를 OpenAPI 3.1 mirror 를 통해 즉시 사용.
- [Windsurf 에 ainote 붙이기](https://docs.ainote.dev/agents/windsurf): Codeium Windsurf에서 ainote MCP 도구를 사용하는 가이드. npm 패키지 기반 stdio 설정과 API URL·키 등록, Cascade 채팅에서 태스크 생성으로 연결 확인.

### 빌더 / SDK

- [빌더 인증 (키 / Sign in with logi)](https://docs.ainote.dev/build/auth): ainote를 백엔드로 쓸 때의 인증 — BYO MCP 키와 Sign in with logi 자동 프로비저닝, 표면별 헤더 규칙.
- [ainote 위에 빌드하기](https://docs.ainote.dev/build/): ainote를 백엔드로 사용하는 앱 개발자 가이드. API와 SDK로 태스크·노트에 접근하는 REST 방식, Vault·파일 동기화용 MCP 미러와 키 인증 규칙 안내.
- [빌더 Quickstart (5분)](https://docs.ainote.dev/build/quickstart): @ainote/sdk 설치부터 키 발급과 첫 REST·MCP 호출까지의 5분 가이드. 태스크 생성·수정·삭제, 노트 조회와 Vault·동기화 호출 및 에러 처리 예시.
- [@ainote/sdk 레퍼런스](https://docs.ainote.dev/build/sdk): @ainote/sdk의 클라이언트 옵션, REST 리소스(tasks/categories/papers), MCP 미러(mcp/vault/sync), 에러 클래스 레퍼런스.
- [ainote를 동기화 백엔드로 쓰기](https://docs.ainote.dev/build/sync-backend): 사용자가 ainote 키 하나로 다른 앱에서 ainote 동기화를 사용하는 법 — 태스크 DB 동기화와 vault 파일 동기화.

### cert-mirror

- [Cert Mirror — API 레퍼런스](https://docs.ainote.dev/cert-mirror/api): Cert Mirror API의 인증과 자격증명 발급·폐기 레퍼런스. 인증서 tarball 업로드, 목록·최신 항목 조회와 다운로드 요청, HMAC 검증 및 HTTP 에러 안내.
- [ainote-cert-mirror — CLI 레퍼런스](https://docs.ainote.dev/cert-mirror/cli): macOS 용 zsh 스크립트. cert mirror credential 관리 + endpoint 호출 + Keychain 통합을 한 줄로 묶음.
- [Cert Mirror — fastlane 통합](https://docs.ainote.dev/cert-mirror/fastlane): fastlane match 워크플로우 끝에 ainote certmirror 업로드를 붙이는 drop-in 패턴. 검증된 production 코드 (ainote 의 iosnative).
- [Cert Mirror — 무엇이고 왜 있나](https://docs.ainote.dev/cert-mirror/overview): ainote 계정에 fastlane match 의 cert + provisioning profile 묶음을 암호화 백업으로 저장할 수 있는 dev-facing API. iOS/macOS 빌드 자동화를 운영하는 사람이 GitHub 외에 두 번째 안전망을 원할 때 씁니다.
- [Cert Mirror — 5분 셋업 가이드](https://docs.ainote.dev/cert-mirror/setup-guide): 신규 user 가 0 에서 cert mirror 백업이 동작하기까지의 끝-to-끝 절차. CLI 스크립트 ainote-cert-mirror(/cert-mirror/cli) 가 거의 모든 작업을 자동화하므로 실제 명령은 3-4 줄이면 끝납니다.

### CLI

- [환경변수 / .env 동기화](https://docs.ainote.dev/cli/env-sync): 여러 프로젝트의 .env 값을 macOS Keychain에 보관하고 키 목록만 ainote에 저장하는 동기화 가이드. 스크립트의 push·pull 사용법과 새 기기 복원 절차.
- [ainote 커맨드라인](https://docs.ainote.dev/cli/): 터미널에서 ainote를 사용하는 두 가지 방법 안내. curl 기반 shell 함수와 @ainote/mcp의 stdio·SSE 바이너리, 환경변수 설정 및 태스크·메모리 호출 예시.
- [설치](https://docs.ainote.dev/cli/install): @ainote/mcp 패키지의 stdio 서버와 SSE 브리지 설치 가이드. Node 요구사항, API URL·키 환경변수와 브리지 포트 설정, 업데이트 및 제거 방법 안내.
- [shell 함수 (curl wrapper)](https://docs.ainote.dev/cli/shell-function): Node 설치 없이 curl로 ainote MCP 도구를 호출하는 shell 함수 가이드. 환경변수 설정, 태스크·메모리 호출, 파일 업로드 헬퍼와 원시 응답 디버깅 예시.

### 예시

- [Claude Code 자연어 사용](https://docs.ainote.dev/examples/claude-code): ainote MCP 등록 후 일상 워크플로우.
- [CLAUDE.md 멀티프로젝트 관리](https://docs.ainote.dev/examples/claude-md-multi): 여러 프로젝트의 CLAUDE.md를 전역 규칙과 프로젝트별 규칙으로 나누는 관리 예시. ainote 일괄 등록, 기기 간 동기화와 새 프로젝트 추가 및 일관성 검증 방법.
- [.env 보안 동기화 패턴](https://docs.ainote.dev/examples/env-sync): .env의 실제 값은 macOS Keychain에 두고 키 이름과 참조만 ainote에 저장하는 보안 동기화 패턴. 프로젝트별 push·pull 스크립트 동작과 참조 문서 형식 예시.
- [맥미니 ↔ 맥북 메모리 동기화](https://docs.ainote.dev/examples/multi-device): 맥미니와 맥북에서 메모리·CLAUDE.md·Cursor 규칙을 공유하는 동기화 예시. 기기별 CLI 환경과 키 설정, 프로젝트 문서 일괄 등록 및 정기 동기화 구성.
- [새 디바이스 셋업 (5분)](https://docs.ainote.dev/examples/new-device): 새 Mac에서 ainote 개발 환경을 복원하는 셋업 가이드. shell 함수와 환경변수 설정, 키 발급, Dev Docs 일괄 복원 및 iCloud Keychain을 통한 .env 복원.
- [Telegram 으로 외부에서 태스크 추가](https://docs.ainote.dev/examples/telegram): 외부에서 Telegram 봇으로 ainote 태스크와 메모를 추가하는 사용 예시. 계정 연결 후 태스크 입력, 빠른 메모 저장과 오늘 할 일 확인, 알림 처리 패턴 안내.

### 가이드

- [API Key 인증](https://docs.ainote.dev/guide/auth): ainote의 User API Key와 MCP Key 인증 가이드. 가입·로그인·웹 설정을 통한 키 발급, Authorization 헤더 형식, 키 권한과 폐기 및 보관 방법 안내.
- [데이터 내보내기 / 삭제](https://docs.ainote.dev/guide/data-export): ainote 데이터 내보내기와 삭제 가이드. 웹 백업, 개별 MCP 도구와 Vault git 복제, 태스크·메모리 부분 삭제 및 계정 삭제 절차와 복구 기간 안내.
- [FAQ](https://docs.ainote.dev/guide/faq): | | ainote | Notion | Obsidian | |---|---|---|---| | AI 직접 호출 | ✅ MCP 50+개 도구 | ❌ | △ 플러그인 | | 자연어 태스크 | ✅ | △ AI Add | ❌ | | Git backend | ✅ | ❌ | △ Sync 플러그인 | | 다중 디바이스 sync | ✅ HLC | ✅ 클라우드 | △ Sy
- [5분 Quickstart](https://docs.ainote.dev/guide/quickstart): Claude Code에서 ainote를 시작하는 5분 가이드. HTTP MCP 서버 등록부터 가입과 API 키 설정, 첫 태스크 생성과 메모리 저장 및 다른 기기에서 문서 가져오기.
- [계정 만들기 (MCP 안에서)](https://docs.ainote.dev/guide/signup): 웹사이트 방문 없이 Claude나 Cursor 안에서 ainote 계정을 만드는 가이드. 키 없는 MCP 등록, 가입과 키 저장, 기존 계정 로그인 및 가입 오류 확인 방법.
- [Troubleshooting](https://docs.ainote.dev/guide/troubleshooting): ainote MCP 연결과 인증 오류를 확인하는 문제 해결 가이드. 도구 미노출, 태스크 날짜·알림, Dev Docs 복원, Vault 충돌과 동기화 및 문서 빌드 오류 점검.
- [ainote 란?](https://docs.ainote.dev/guide/what-is-ainote): AI가 MCP 도구로 태스크와 메모리·Dev Docs를 다루는 ainote 소개. 자연어 태스크 입력과 메모리 타입, 개발 문서 중앙 관리 및 클라이언트와 서버의 호출 흐름.

### handoff

- [Session Handoff](https://docs.ainote.dev/handoff/overview): 세션 간 작업 인수인계 도구. 컨텍스트가 차서 다른 세션·디바이스에서 이어가야 할 때, 자기완결 텍스트 한 장으로 작업 환경과 다음 STEP을 넘긴다.

### 소개

- [ainote — Agent-native notes, tasks, memory & sync](https://docs.ainote.dev/index): 26 MCP 도구 + OpenAPI 3.1 mirror. Claude / Cursor / Windsurf / ChatGPT / LangChain 가 같은 백엔드를 그대로 사용. 모든 플랫폼·다중 디바이스 동기화.
- [Backend Completeness Principle — ainote 설계 철학](https://docs.ainote.dev/philosophy): ainote 의 모든 결정은 한 줄을 따른다 — '백엔드는 철저하게, 사용자는 간단하게'. 이것이 어떻게 agent-native 노트의 토대가 되는가.

### legal

- [계정 삭제 안내 — ainote](https://docs.ainote.dev/legal/account-deletion): ainote 앱·웹 설정 또는 이메일로 계정과 데이터 삭제를 요청하는 방법. 삭제 대상, 법적 의무로 보존되는 항목과 기간, 삭제 유예 중 계정 복구 및 관련 문의 안내.
- [OpenAPI / Domain Verification Log](https://docs.ainote.dev/legal/openapi-verification): OpenAI Custom GPT Store, marketplace 등록 시 사용한 도메인 인증 / OpenAPI surface 변경 이력.
- [Privacy Policy — ainote](https://docs.ainote.dev/legal/privacy): ainote의 계정·사용자 콘텐츠·외부 연동 데이터 수집과 이용 목적 안내. 저장 위치, AI 기능 실행 시 제3자 공유, 보존과 삭제, 사용자 권리 및 보안 정책.
- [Security Disclosure — ainote](https://docs.ainote.dev/legal/security): ainote 보안 취약점 보고 채널과 책임 있는 공개 정책 안내. 심각도별 응답·패치 목표, 전송·저장 암호화와 MCP 설정의 클라이언트 암호화 모델 및 사용자 격리 설명.
- [Terms of Service — ainote](https://docs.ainote.dev/legal/terms): ainote 호스팅 서비스 이용 약관과 MCP 클라이언트 코드 라이선스 안내. 계정 조건, 허용·금지 행위, 데이터 소유권과 서비스 가용성, 이용 종료 및 분쟁 해결 기준.

### MCP 통합

- [ChatGPT 연결 (SSE)](https://docs.ainote.dev/mcp/chatgpt): ChatGPT MCP 커넥터에 ainote를 연결하는 SSE 브리지 가이드. npm 패키지 설치, API URL·키·포트 환경변수 설정, 브리지 실행과 커넥터 등록 및 호출 확인.
- [Claude Code 연결](https://docs.ainote.dev/mcp/claude-code): Claude Code CLI에 ainote MCP 서버를 등록하는 연결 가이드. hosted HTTP 설정, type 필드와 인증 헤더, 키 없이 가입하는 절차 및 stdio 패키지 대안.
- [Claude Desktop 연결](https://docs.ainote.dev/mcp/claude-desktop): macOS와 Windows의 Claude Desktop에 ainote를 연결하는 가이드. stdio 패키지 설치, 설정 파일 위치와 API URL·키 환경변수, 재시작 후 연결 확인.
- [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가 AI 모델과 외부 도구를 연결하는 방식과 ainote 서버의 역할 소개. 태스크·메모리·Vault 도구 호출부터 결과 반환까지의 흐름 및 세 가지 transport 안내.
- [Telegram 연결 (Clawdbot)](https://docs.ainote.dev/mcp/telegram): Telegram의 Clawdbot과 ainote 계정을 연결하는 가이드. 봇 시작과 연동 코드 입력, 태스크 추가·완료·삭제 및 메모 저장·검색에 사용하는 명령어 안내.
- [3가지 transport 비교](https://docs.ainote.dev/mcp/transports): ainote MCP의 stdio·SSE·hosted HTTP transport 비교. 클라이언트별 설치와 로컬 프로세스 필요 여부, 인증 방식 및 각 연결 방식의 설정 예시.

### 메모리 / Dev Docs

- [카테고리 / 폴더 구조](https://docs.ainote.dev/memory/categories): ainote Dev Docs의 카테고리와 Vault 디렉토리 대응 안내. Claude·Cursor·Windsurf 규칙 분류, 프로젝트별 파일 명명 규칙 및 메모리 인덱스 예산 관리.
- [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): Claude·Cursor·Windsurf가 공유하는 ainote 마크다운 메모리와 Dev Docs 소개. 토픽 메모리 분류, 프로젝트 규칙의 중앙 관리 및 문서 등록·수정·로컬 복원 흐름.
- [4가지 메모리 타입](https://docs.ainote.dev/memory/types): ainote 토픽 메모리의 user·feedback·project·reference 네 가지 타입 안내. 사용자 정체성, 작업 가이드, 진행 중인 맥락과 외부 시스템 포인터의 구분 및 작성 예시.

### API 레퍼런스

- [인증 헤더](https://docs.ainote.dev/reference/auth): ainote MCP 인증 헤더 레퍼런스. McpKey·Bearer 형식과 키 종류, 인증 없이 호출하는 도구, 발급 직후 키 표시와 마스킹 및 인증 오류 응답 안내.
- [변경 로그](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): delete_dev_doc으로 문서를 제목 또는 UUID로 지정해 삭제하는 API 레퍼런스. 동명 문서의 카테고리 구분, soft delete와 30일 후 정리 및 오류 응답 안내.
- [delete_task](https://docs.ainote.dev/reference/delete-task): delete_task로 태스크 ID를 지정해 삭제하는 API 레퍼런스. 목록에서 제외되는 soft delete 동작, 30일 후 영구 정리와 관련 데이터 삭제 및 에러 응답 안내.
- [에러 코드](https://docs.ainote.dev/reference/errors): ainote MCP의 JSON-RPC 표준 에러와 확장 코드 레퍼런스. 인증 실패, 요청 파라미터 오류, 사용량 한도와 충돌의 원인 및 HTTP 상태 코드별 확인 방법.
- [get_dev_doc](https://docs.ainote.dev/reference/get-dev-doc): 단일 devdoc 조회 (전체 본문 포함).
- [API 레퍼런스](https://docs.ainote.dev/reference/): ainote MCP 서버의 도구 카탈로그와 API 공통 규칙. 온보딩·태스크·Dev Docs·Vault·동기화 도구별 문서, JSON-RPC 호출 형식과 인증 및 에러 코드 안내.
- [JSON-RPC 호출 형식](https://docs.ainote.dev/reference/json-rpc): ainote MCP 도구를 HTTP POST로 호출하는 JSON-RPC 2.0 레퍼런스. 엔드포인트와 인증 헤더, 요청 필드 및 성공·에러 응답 형식과 도구 목록 조회 예시.
- [list_categories](https://docs.ainote.dev/reference/list-categories): list_categories로 태스크 카테고리 목록을 조회하는 API 레퍼런스. 파라미터 없는 호출 형식과 텍스트 응답, 카테고리 ID·이름·색상을 담은 JSON 리소스 예시.
- [list_dev_categories](https://docs.ainote.dev/reference/list-dev-categories): list_dev_categories로 Dev Docs의 사용 중인 카테고리를 조회하는 API 레퍼런스. 표준·사용자 정의 카테고리와 문서 개수 응답, 디렉토리별 용도 안내.
- [list_dev_docs](https://docs.ainote.dev/reference/list-dev-docs): list_dev_docs의 문서 검색과 필터 API 레퍼런스. 카테고리·제목 키워드·콘텐츠 타입 파라미터와 목록 응답, 본문 조회 도구의 구분 및 자주 쓰는 호출 예시.
- [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): pull_dev_docs로 local_path가 있는 Dev Docs를 로컬 파일로 복원하는 API 레퍼런스. 카테고리 필터, 플랫폼별 경로 매핑과 덮어쓰기 동작 및 부분 실패 확인.
- [get_setup_guide](https://docs.ainote.dev/reference/setup-guide): 클라이언트별 설정 가이드 반환. 인증 헤더 불필요.
- [signup_and_get_key](https://docs.ainote.dev/reference/signup): signup_and_get_key의 인증 헤더 없는 신규 가입과 MCP 키 발급 API 레퍼런스. 이메일·비밀번호·이름 파라미터, 한 번만 표시되는 키 응답 및 가입 오류 안내.
- [sync_list](https://docs.ainote.dev/reference/sync-list): ::: tip ✅ 라이브 (서버) vault / sync 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk(/build/sdk) (ai.vault. / ai.sync.)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp
- [sync_pull](https://docs.ainote.dev/reference/sync-pull): sync_pull로 ainote hub에서 파일 내용을 받는 API 레퍼런스. 경로별 조회와 변경 시각 필터, 커서 기반 페이지 처리 및 누락 경로·내용 해시를 활용한 증분 동기화.
- [sync_push](https://docs.ainote.dev/reference/sync-push): sync_push로 로컬 파일을 ainote hub에 보내는 API 레퍼런스. 경로·본문·SHA-256·HLC·디바이스 파라미터와 응답, 해시 검증 및 서버 변경과의 충돌 처리.
- [update_dev_doc](https://docs.ainote.dev/reference/update-dev-doc): update_dev_doc으로 기존 문서를 수정하는 API 레퍼런스. 제목·UUID와 카테고리 지정, 본문 교체·끝에 추가·앞에 추가 모드 및 로컬 경로 갱신과 오류 응답.
- [update_task](https://docs.ainote.dev/reference/update-task): update_task로 태스크 ID에 해당하는 필드만 변경하는 API 레퍼런스. 완료·미완료 전환, 마감·중요도·카테고리·알림 수정과 지정하지 않은 필드 유지 및 오류 응답.
- [vault_clone](https://docs.ainote.dev/reference/vault-clone): ::: tip ✅ 라이브 (서버) vault / sync 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk(/build/sdk) (ai.vault. / ai.sync.)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp
- [vault_connect_status](https://docs.ainote.dev/reference/vault-connect-status): ::: tip ✅ 라이브 (서버) vault / sync 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk(/build/sdk) (ai.vault. / ai.sync.)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp
- [vault_create](https://docs.ainote.dev/reference/vault-create): ::: tip ✅ 라이브 (서버) vault / sync 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk(/build/sdk) (ai.vault. / ai.sync.)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp
- [vault_list](https://docs.ainote.dev/reference/vault-list): ::: tip ✅ 라이브 (서버) vault / sync 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk(/build/sdk) (ai.vault. / ai.sync.)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp
- [vault_sync](https://docs.ainote.dev/reference/vault-sync): vault_sync의 Vault 양방향 동기화 API 레퍼런스. Vault 이름과 자동 커밋·메시지·충돌 전략 설정, 변경 파일 응답 및 충돌 파일의 수동 해결 후 재실행 절차.

### 동기화

- [sync-now 알고리즘](https://docs.ainote.dev/sync/algorithm): ainote sync-now 스크립트의 한 사이클을 설명하는 의사코드. 로컬 스캔과 원격 목록 비교, push·pull·충돌 판단, 대량 삭제 안전장치 및 로그·상태 갱신 흐름.
- [아키텍처 — Star Topology](https://docs.ainote.dev/sync/architecture): ainote hub와 각 디바이스가 연결되는 Star Topology 동기화 구조. 기기 간 직접 동기화와의 차이, hub·spoke 역할 및 manifest·상태 파일과 변경 전송 흐름.
- [충돌 해결 (LWW + 5분 임계)](https://docs.ainote.dev/sync/conflicts): ainote 동기화의 LWW와 5분 임계 기반 충돌 해결 정책. 로컬·원격 변경 조합별 처리, 동시 변경 시 양쪽 보존과 수동 선택 및 대량 삭제·덮어쓰기 안전장치.
- [폴더 구조 권장](https://docs.ainote.dev/sync/folder-structure): ainote Vault의 전역·프로젝트별·도구별 디렉토리 구성 가이드. 메모리와 스킬, 환경변수 참조의 배치 및 카테고리 우선·프로젝트 우선 구조의 장단점과 혼합 예시.
- [HLC 시간 모델](https://docs.ainote.dev/sync/hlc): ainote 동기화의 Hybrid Logical Clock 시간 모델. wall clock과 counter·device_id 조합, 로컬 쓰기와 원격 이벤트 수신 시 갱신 알고리즘 및 비교 규칙.
- [manifest.yml 작성](https://docs.ainote.dev/sync/manifest): 각 디바이스의 로컬 파일과 ainote 경로를 매핑하는 manifest.yml 작성 가이드. 단일 파일과 glob 설정, 제외·폐기 경로 및 삭제·덮어쓰기 안전장치 예시.
- [다중 디바이스 동기화 개요](https://docs.ainote.dev/sync/overview): ainote의 다중 디바이스 동기화 개요. Star topology·HLC·LWW 모델, 로컬과 원격 변경에 따른 push·pull·충돌 처리 및 dry-run·로그·충돌 보관 안내.
- [왜 별도 sync 시스템 (vs Dropbox)](https://docs.ainote.dev/sync/why): ainote 별도 동기화 시스템의 설계 이유와 Dropbox·iCloud·Syncthing·git 비교. 동시 편집 충돌 사례, HLC와 5분 임계 정책 및 디바이스 추적·부분 동기화 설명.

### 태스크

- [카테고리](https://docs.ainote.dev/tasks/categories): ainote 태스크 카테고리의 이름·색상·아이콘과 UUID 모델 안내. 목록 조회로 얻은 ID를 태스크 생성·수정·필터에 사용하는 방법 및 웹에서 카테고리 관리.
- [날짜 / 위치 / 알림](https://docs.ainote.dev/tasks/due-date): ainote 태스크의 날짜·위치·알림 설정 가이드. 자연어 시간과 ISO 8601 입력, 종일·다일 일정, 위치 텍스트·GPS 좌표 및 이동시간과 사전 알림 예시.
- [필터링 (18개 옵션)](https://docs.ainote.dev/tasks/filtering): listtasks 의 모든 필터.
- [태스크 개요](https://docs.ainote.dev/tasks/overview): AI가 ainote 태스크를 추가·수정·삭제하는 기본 모델과 MCP 도구 안내. 자연어 입력의 날짜·위치·알림 구조화, 완료 처리와 목록 필터 및 백그라운드 알림 작업.

### Vault

- [vault_clone](https://docs.ainote.dev/vault/clone): ::: tip ✅ 라이브 (서버) vault / sync 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk(/build/sdk) (ai.vault. / ai.sync.)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp
- [vault_create](https://docs.ainote.dev/vault/create): 사용자 GitHub 계정에 새 Vault를 private 저장소로 만드는 가이드. GitHub App 설치 확인, 이름·설명 파라미터와 응답 및 생성 후 인덱싱과 로컬 복제 절차.
- [Git backend](https://docs.ainote.dev/vault/git-backend): ::: tip ✅ 라이브 (서버) vault / sync 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk(/build/sdk) (ai.vault. / ai.sync.)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp
- [Vault 개요](https://docs.ainote.dev/vault/overview): Obsidian 호환 마크다운 저장소인 ainote Vault 소개. git 백엔드와 MCP 도구, wikilinks·YAML 지원 및 저장소 생성·기존 Vault 가져오기·다중 기기 동기화 예시.
- [vault_sync](https://docs.ainote.dev/vault/sync): ::: tip ✅ 라이브 (서버) vault / sync 도구는 api.ainote.dev 서버에서 동작합니다 — JSON-RPC POST /api/mcp 또는 @ainote/sdk(/build/sdk) (ai.vault. / ai.sync.)로 호출하세요. (일부 vault 도구는 연결된 git-backed vault가 필요. 참고: @ainote/mcp