Claude Code

Claude Code에 MCP를 통해 AstroWay API를 연결해. 파일을 편집할 필요 없이 터미널에서 명령어 하나로 모든 설정이 완료돼.

사전 준비

대시보드에서 API 키를 발급받아. 무료 테스트에는 크레딧이 차감되지 않는 sandbox 키 aw_test_*를 사용해.

연결

터미널에서 다음 명령어 중 하나를 실행해. 그 후 Claude Code를 재시작해.

Hosted (HTTP): 설치 불필요, Bearer 토큰으로 인증:

terminal

claude mcp add --transport http astroway https://mcp.astroway.info/mcp \
--header "Authorization: Bearer aw_live_YOUR_KEY"

Stdio (npx): 로컬 하위 프로세스, env 변수로 인증, 오프라인에서도 동작:

terminal

claude mcp add astroway --env ASTROWAY_API_KEY=aw_live_YOUR_KEY -- npx -y @astroway/mcp

확인

Claude 채팅에 “Astroway 도구 목록을 보여줘”라고 입력하거나, 무료 reference 도구(예: 황도대 별자리 목록 가져오기)를 호출해 달라고 요청해 봐. 결과가 반환되면 연결이 정상적으로 작동하는 거야.

문제 해결

• 401 / invalid key: 키에 aw_live_* 또는 aw_test_* 접두사가 있고 취소되지 않았는지 확인해. 대시보드에서 확인할 수 있어.
• 도구가 나타나지 않음: Claude Code를 완전히 재시작하고 서버가 추가되었는지 확인해 (claude mcp list).
• -32602 유효성 검사 오류 (stdio의 경우): 패키지를 업데이트해: npm i @astroway/mcp@latest. 스키마는 최신 스펙에서 재생성돼.

모든 클라이언트 - 에이전트 설정.