ainote

테마

Claude Code 연결 ​

Claude Code (CLI) 에서 ainote 를 MCP 서버로 등록.

권장: hosted HTTP transport ​

가장 간단. 별도 설치 없음.

~/.claude.json 편집:

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

저장 후 Claude Code 재시작 (또는 /mcp 슬래시커맨드로 reload).

type 필드 누락 사고 주의

원격 MCP 서버는 반드시 "type": "http" (또는 "sse") 명시. 빠지면 스키마 검증 실패로 mcpServers 블록 전체 미로드 — ainote 뿐 아니라 hyperbrowser, perplexity, render 등 다른 모든 MCP 도 같이 안 됩니다. 2026-04-15 이걸로 10개 동시 미로드 사고 발생.

키 없이 시작 (가입 우선) ​

처음이라 키가 없으면 headers 빼고 등록:

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

Claude 에서:

ainote 가입 시켜줘 — 이메일 X / 비번 Y

키 받은 뒤 headers 추가하고 재시작.

대안: stdio (로컬 npm 패키지) ​

MCP 트래픽을 외부로 안 보내고 싶을 때:

bash
npm install -g @ainote/mcp
json
{
  "mcpServers": {
    "ainote": {
      "command": "npx",
      "args": ["-y", "@ainote/mcp"],
      "env": {
        "AINOTE_API_KEY": "YOUR_KEY"
      }
    }
  }
}

이 경우에도 결국 api.ainote.dev 로 HTTPS 호출은 갑니다 — 차이는 stdio process 가 로컬에서 한 번 wrap 한다는 것뿐.

검증 ​

Claude Code 안에서:

/mcp

ainote 가 connected 로 나오면 성공. 도구 목록 17개 보임.

테스트:

ainote 에 "테스트 태스크" 추가해줘

Project-level 등록 (한 프로젝트만) ​

~/.claude.json 대신 프로젝트 루트의 .mcp.json:

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

⚠️ .mcp.json 은 git 에 커밋하지 마세요 — 키가 들어있음.

Troubleshooting ​

증상원인해결
도구 목록에 안 나옴type 필드 누락"type": "http" 추가
401 Unauthorized키 누락/오타Authorization 헤더 확인
다른 MCP 도 다 안 됨json schema 깨짐~/.claude.json JSON 검증
시그널 끊김Render cold start재호출 시 정상 (5초 wait)

다음 ​

MIT License · ainote.dev

Built by Dcode Labs