Claude Code

AstroWay API를 Claude Code에 MCP를 통해 연결하세요. 파일을 편집할 필요가 없습니다 - 모든 설정이 터미널의 한 명령으로 완료됩니다.

전제 조건

대시보드에서 API 키를 받으세요. 무료 테스트를 위해 sandbox 키 aw_test_*를 사용하세요 - 이 키는 크레딧을 차지하지 않습니다.

터미널에서 다음 명령 중 하나를 실행하세요. 그런 다음 Claude Code를 다시 시작하세요.

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

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

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

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

채팅에서 Claude에게 다음과 같이 말하세요: “Astroway 도구 목록을 나열해주세요” - 또는 무료 참조 도구를 호출하도록 요청하세요, 예를 들어 황도대의 별자리 목록을 받는 것입니다. 응답으로 결과가 오면 연결이 제대로 작동하는 것입니다.

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

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