Claude Desktop 연결
Claude Desktop (macOS / Windows 데스크톱 앱) 에서 ainote 사용.
권장: stdio 패키지
Claude Desktop 은 stdio transport 만 안정적으로 지원.
1. 패키지 설치
bash
npm install -g @ainote/mcpNode 18+ 필요. 미설치 시:
bash
brew install node # macOS
# 또는 https://nodejs.org2. 설정 파일 편집
위치:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
json
{
"mcpServers": {
"ainote": {
"command": "npx",
"args": ["-y", "@ainote/mcp"],
"env": {
"AINOTE_API_KEY": "h7Axq9XPsDTD2qr5yqtcCSaQ..."
}
}
}
}3. Claude Desktop 재시작
완전 종료 (Cmd+Q) 후 다시 실행.
4. 검증
대화창 좌하단 🔌 아이콘 → "ainote" 가 connected 로 표시되어야 함.
테스트:
ainote 에 "데스크톱 테스트" 태스크 추가해줘키 없이 시작
env 빼고 등록:
json
{
"mcpServers": {
"ainote": {
"command": "npx",
"args": ["-y", "@ainote/mcp"]
}
}
}대화에서:
ainote 가입 시켜줘 — me@example.com / password123키 받으면 env 추가 후 재시작.
SSE 모드 (선택)
Claude Desktop 일부 버전은 SSE 도 지원. ChatGPT 처럼 브리지 사용:
bash
npx ainote-mcp-http --port 8765설정:
json
{
"mcpServers": {
"ainote": {
"transport": {
"type": "sse",
"url": "http://localhost:8765/sse"
}
}
}
}(브리지 프로세스는 항상 켜져 있어야 함)
Troubleshooting
"ainote" 가 안 뜸
체크:
- JSON 문법:
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq . - Node 설치:
which node - 패키지 설치:
npm list -g @ainote/mcp
"command not found: npx"
bash
which npx
# 없으면 Node 재설치설정에서 "command": "npx" 대신 절대경로 사용 가능:
json
"command": "/opt/homebrew/bin/npx"401 Unauthorized
env 의 AINOTE_API_KEY 확인. 키 prefix 안 붙음 — 그냥 64자 키만.
자세히: Troubleshooting.