# ainote > AI 네이티브 태스크 + 메모리 + Vault + 다중 디바이스 동기화. MCP 서버. ## 페이지 색인 ### 소개 - [docs.ainote.dev](https://docs.ainote.dev/README): ainote 의 공식 개발자 문서. VitePress 기반. - [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 노트의 토대가 되는가. ### 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 transport 로 ainote 26 도구를 5분 안에 사용 가능. - [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 의 MCP 지원으로 ainote 26 도구 사용. - [에이전트 진영별 가이드 — 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 로 등록. - [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 의 MCP 지원으로 ainote 26 도구 사용. ### 빌더 / 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를 백엔드로 — 다른 앱에서 ainote의 태스크·노트·동기화를 API/SDK로 사용하는 개발자 가이드. - [빌더 Quickstart (5분)](https://docs.ainote.dev/build/quickstart): @ainote/sdk 설치 → 키 발급 → 첫 REST/MCP 호출까지 5분 가이드. - [@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): base URL: https://api.ainote.dev - [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 파일을 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 50+개 도구 | ❌ | △ 플러그인 | | 자연어 태스크 | ✅ | △ 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 가 자연어로 조작합니다. ### handoff - [Session Handoff](https://docs.ainote.dev/handoff/overview): 세션 간 작업 인수인계 도구. 컨텍스트가 차서 다른 세션·디바이스에서 이어가야 할 때, 자기완결 텍스트 한 장으로 작업 환경과 다음 STEP을 넘긴다. ### 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 가 어떤 데이터를 수집·저장·사용하는지, 사용자가 보유한 권리. - [Security Disclosure — ainote](https://docs.ainote.dev/legal/security): ainote 보안 보고 채널, 취약점 처리 정책, 암호화 모델. - [Terms of Service — ainote](https://docs.ainote.dev/legal/terms): ainote 호스팅 서비스 이용 약관 + 코드 라이선스. ### 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 는 같은 50+개 도구 카탈로그를 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