ainote 위에 빌드하기 (개발자/SDK)

이 섹션은 ainote를 직접 쓰는 사용자가 아니라, ainote를 백엔드처럼 자기 앱에 통합하는 개발자를 위한 곳입니다.

이용자용 문서(앱·에이전트 연결, 기능 설명)는 상단 다른 메뉴를 보세요. 여기는 "ainote 위에 짓는" 트랙입니다.

두 종류의 빌더

앱 개발자 — ainote를 자기 앱의 태스크·노트 백엔드로 사용. 타입 있는 REST(ai.tasks / ai.categories / ai.papers).
동기화 도구 빌더 — vault·파일 동기화 프리미티브를 사용. MCP 미러(ai.vault / ai.sync / ai.mcp).

이미 동작하는 백엔드를 공짜로 얻습니다 — 멀티디바이스 동기화, 충돌 해결, MCP/AI 접근, 크로스플랫폼. iCloud(CloudKit)만 쓰던 앱이 못 주던 "내 데이터를 AI 에이전트·CLI에서 접근" 을 그대로 얹을 수 있어요.

SDK는 npm에 공개됨 — @ainote/sdk npm install @ainote/sdk 한 줄로 시작. 런타임 의존성 0, ESM+CJS+타입.
API는 이미 라이브 (https://api.ainote.dev) — 우리 Flutter·iOS·mac·watch 앱이 매일 쓰는 검증된 표면.
두 표면: 구조화된 JSON을 주는 REST(앱용)와, 텍스트를 주는 MCP JSON-RPC(에이전트용).
하나의 키, 두 헤더: 같은 ainote 키가 REST에선 Bearer, MCP에선 McpKey로 동작.