FAQ

일반

ainote 와 Notion / Obsidian 차이가 뭔가요?

	ainote	Notion	Obsidian
AI 직접 호출	✅ MCP 17개 도구	❌	△ 플러그인
자연어 태스크	✅	△ AI Add	❌
Git backend	✅	❌	△ Sync 플러그인
셀프호스팅	✅	❌	✅
다중 디바이스 sync	✅ HLC	✅ 클라우드	△ Sync 유료

ainote 는 AI 가 1급 시민이라는 점이 가장 다릅니다. Notion/Obsidian 은 AI 통합이 추가 기능이지만 ainote 는 시작부터 MCP 우선.

무료인가요?

현재 v0.x 는 전부 무료. 유료 플랜은 v1 이후 (저장량/MCP 호출 무제한 등).

데이터 어디 저장되나요?

호스팅 (api.ainote.dev): Render Singapore 리전, PostgreSQL + git 저장소. 셀프호스팅: 자체 인스턴스 가능 (도커 이미지 계획).

데이터 내보낼 수 있나요?

데이터 내보내기 / 삭제 참고. 모든 메모리/태스크/vault 를 ZIP 또는 git push 로 내보낼 수 있고, 계정 삭제 시 30일 안에 영구 삭제.

기능

Obsidian 사용 중인데 마이그레이션 가능?

네. vault_clone 으로 기존 Obsidian vault 를 git 으로 등록하면 됩니다. [[wikilinks]] 그대로 호환.

ainote 에 ~/Documents/MyObsidianVault 를 vault_clone 해줘

CLAUDE.md 17개 프로젝트 동기화 어떻게?

CLAUDE.md 통합 관리 참고. create_dev_doc 으로 한 번 등록 → 다른 기기에서 pull_dev_docs 한 번이면 전체 복원.

태스크 알림 어디로 오나요?

설정한 채널 모두:

• iOS / Android 푸시 (앱 설치 시)
• Telegram (봇 연동 시)
• Web Push (PWA 등록 시)
• Apple Watch (iOS 동기화)

반복 태스크 지원?

네. create_task 의 recurring 파라미터:

{
  "title": "주간 회고",
  "recurring": {
    "freq": "weekly",
    "by_day": ["FR"],
    "until": "2026-12-31"
  }
}

iCalendar RRULE 부분 지원.

MCP / AI 통합

Claude / GPT 가 내 모든 노트 다 보나요?

아니요. MCP 도구를 호출할 때만 그 도구가 반환하는 데이터만 봅니다. 예시:

• list_tasks → 필터에 매칭되는 태스크만
• get_dev_doc → 그 한 문서만
• vault_sync → 변경된 파일 목록 (내용 X)

도구 호출 단위로 Claude Code 에서 승인 가능.

ChatGPT 에서도 되나요?

네. SSE bridge (ainote-mcp-http) 로컬 실행 → ChatGPT MCP connector 등록. ChatGPT 연결 참고.

Telegram 에서 외부에서 쓸 수 있나요?

네. 봇 연동 후 /task 내일 회의 같은 식으로. Telegram 연결.

가격 / 제한

Rate limit 걸렸어요

키 종류	분당	일당
User API Key	60	10,000
MCP Key (free)	120	20,000

429 응답 시 Retry-After 헤더 보고 대기.

저장 용량 제한?

v0.x: 사용자당 100 MB (메모리 + dev_docs). Vault 는 별도 git 저장소 1 GB까지.

기술적

Rails 8 라는데 React Native 앱은?

ainote_server/ 가 Rails 8 (API + Inertia.js + Svelte 5 웹). 모바일은 별도:

• iOS/Android: Flutter (BLoC + Clean Architecture)
• macOS: 네이티브 SwiftUI
• Apple Watch: WatchKit
• Chrome/Safari: 확장 프로그램

오픈소스인가요?

코어는 MIT. https://github.com/seunghan91/ainote.

안 풀리면

• Troubleshooting
• GitHub Issues: https://github.com/seunghan91/ainote/issues
• Email: support@ainote.dev