5분 Quickstart

계정 없이 바로 시작. Claude Code 기준 (다른 클라이언트는 MCP 섹션 참고).

1. MCP 서버 등록 (1분)

~/.claude.json 에 추가:

{
  "mcpServers": {
    "ainote": {
      "type": "http",
      "url": "https://api.ainote.dev/api/mcp"
    }
  }
}

type: "http" 필수

원격 MCP 서버는 반드시 type 명시. 빠지면 ~/.claude.json 전체 mcpServers 블록이 스키마 검증 실패해서 모든 user-level MCP 가 미로드됩니다.

Claude Code 재시작.

2. 가입 (1분)

Claude 에서:

ainote 가입 시켜줘 — 이메일 you@example.com / 비번 안전한패스워드123

Claude 가 signup_and_get_key 도구를 호출합니다. 응답에 API 키가 옵니다 (64자):

Mcp Key: h7Axq9XPsDTD2qr5yqtcCSaQ...

3. API Key 등록 (30초)

~/.claude.json 에 헤더 추가:

{
  "mcpServers": {
    "ainote": {
      "type": "http",
      "url": "https://api.ainote.dev/api/mcp",
      "headers": {
        "Authorization": "McpKey h7Axq9XPsDTD2qr5yqtcCSaQ..."
      }
    }
  }
}

Claude Code 재시작.

4. 첫 태스크 (30초)

내일 오전 10시 회의 준비 추가해줘

Claude 가 create_task 호출:

{
  "title": "회의 준비",
  "due_at": "2026-05-08T10:00:00+09:00",
  "important": false
}

5. 첫 메모리 저장 (1분)

이거 메모리에 저장해줘:
- 우리 회사는 Stripe 방식 따라서 API 응답 snake_case 유지함
- 절대 camelCase 로 변환하지 말 것

Claude 가 create_dev_doc 호출:

{
  "title": "api-naming-convention.md",
  "category": "feedback",
  "content": "# API Naming\n\n우리는 Stripe 방식으로 snake_case..."
}

6. 다른 기기에서 가져오기 (1분)

다른 기기 Claude:

ainote 에서 내 메모리 다 가져와

pull_dev_docs 가 모든 메모리를 local_path 기준으로 복원합니다.

다음 단계

하고 싶은 것	어디로
태스크 18+ 필터	태스크 필터링
CLAUDE.md 동기화	메모리 / CLAUDE.md
Obsidian 마이그	Vault 시작
다중 기기 sync	동기화 개요
ChatGPT 에서 쓰기	ChatGPT 연결
Telegram 봇	Telegram 연결

안 되면

• Troubleshooting
• GitHub Issues: https://github.com/seunghan91/ainote/issues