API 레퍼런스
ainote MCP 서버의 전체 도구 카탈로그.
공통 사항
- Endpoint:
https://api.ainote.dev/api/mcp - Protocol: JSON-RPC 2.0 over HTTP POST
- Auth:
Authorization: McpKey <YOUR_KEY>헤더 - Content-Type:
application/json
자세히: JSON-RPC 호출 형식 · 인증 · 에러 코드.
도구 카탈로그 (17개)
온보딩 (3)
| 도구 | 인증 필요 | 설명 |
|---|---|---|
signup_and_get_key | ❌ | 가입 + MCP 키 발급 |
login_and_get_key | ❌ | 기존 계정 로그인 + 키 발급 |
get_setup_guide | ❌ | 클라이언트별 설정 가이드 |
태스크 (5)
| 도구 | 설명 |
|---|---|
create_task | 새 태스크 (자연어 파싱 포함) |
update_task | 수정 / 완료 처리 |
delete_task | 삭제 (soft, 30일) |
list_tasks | 18+ 필터 조회 |
list_categories | 카테고리 목록 |
메모리 / Dev Docs (7)
| 도구 | 설명 |
|---|---|
create_dev_doc | 새 문서 등록 |
update_dev_doc | 수정 (replace/append/prepend) |
delete_dev_doc | 삭제 |
get_dev_doc | 단일 조회 |
list_dev_docs | 검색 + 필터 |
list_dev_categories | 카테고리 목록 |
pull_dev_docs | local_path 일괄 복원 |
Vault (5)
| 도구 | 설명 |
|---|---|
vault_create | 새 vault |
vault_clone | git clone (다른 기기) |
vault_sync | pull + push |
vault_list | vault 목록 |
vault_connect_status | git 연결 상태 |
Sync (3)
| 도구 | 설명 |
|---|---|
sync_push | 로컬 파일 → ainote |
sync_pull | ainote → 로컬 (since 기준) |
sync_list | sync 대상 목록 |
Rate Limits
| 키 종류 | 분당 | 시간당 | 일당 |
|---|---|---|---|
| User API Key | 60 | 1,000 | 10,000 |
| MCP Key (free) | 120 | 2,000 | 20,000 |
| MCP Key (paid) | 600 | 10,000 | 무제한 |
429 응답 시 Retry-After 헤더 확인.
SDK / 라이브러리
| 언어 | 패키지 |
|---|---|
| Node.js (MCP) | @ainote/mcp |
| Ruby (Rails 통합) | @seunghan/rails-api-client |
| 직접 호출 | JSON-RPC 형식 |
OpenAPI
https://api.ainote.dev/openapi.yaml (계획됨, v0.x).
변경 로그
변경 로그 참고.