Claude Desktop

AstroWay API를 Claude Desktop에 MCP를 통해 연결해: 한 번 클릭 확장 또는 설정 파일을 수동으로, hosted 서버(HTTP) 또는 로컬 stdio 패키지와 함께.

전제조건

대시보드에서 API 키를 받아. 무료 테스트를 위해 sandbox 키 aw_test_*를 사용해 - 크레딧을 차감하지 않아.

한 번 클릭 확장

1. 다음 파일을 다운로드해 astroway.mcpb.
2. 파일을 열어. Claude Desktop이 설치 대화창을 보여줄 거야.
3. API 키를 입력하고, 도구 그룹을 선택해 (기본값은 출생 차트, 트랜짓, 진행, 반환, 시냅스, 캘린더) 그리고 확장을 활성화해.

설정 파일을 수정할 필요 없어. 이 확장은 npm 패키지 @astroway/mcp와 그 의존성으로, 같은 릴리즈에서 빌드됐어. 모든 700+ 도구를 로드하려면 그룹 필드를 비워.

수동 연결

Settings → Developer → Edit Config를 열어 - Claude Desktop이 claude_desktop_config.json 파일 경로를 보여줄 거야. 아래 블록 중 하나를 삽입하고 Claude Desktop을 다시 시작해.

Hosted (HTTP): 우리 패키지를 사용하지 않고, Bearer 토큰으로 인증해. Claude Desktop 설정은 로컬 명령만 실행하고 url 자체를 무시하므로, hosted 서버는 mcp-remote 브리지를 통해 연결돼:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

키는 args가 아니라 env에 있어, 왜냐면 Windows에서 Claude Desktop은 Bearer 뒤의 공백에서 인자를 잘라내거든. 전체 카탈로그 대신 하나의 테마만 로드하려면 /mcp를 도메인 서버로 바꿔, 예를 들어 /mcp/core 혹은 /mcp/vedic.

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

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "@astroway/mcp"],
    "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
  }
}
}

검증

Claude에게 채팅에서 “Astroway 도구 목록을 보여줘”라고 말하거나, 무료 레퍼런스 도구를 호출해 예를 들어 별자리 목록을 받아봐. 답으로 결과가 오면 연결이 정상 작동하는 거야.

문제 해결

• 401 / invalid key: 키가 aw_live_* 또는 aw_test_* 접두사를 가지고 있고, 취소되지 않았는지 확인해. 대시보드에서 확인할 수 있어.
• “Some MCP servers couldn’t be loaded”: url 항목에 command 대신 넣어. 위의 mcp-remote 블록을 사용해.
• 도구가 나타나지 않음: Claude Desktop을 완전히 다시 시작해(창을 닫는 게 아니라 완전히 종료하고) 그리고 claude_desktop_config.json 경로를 확인해.
• 검증 오류 -32602 (stdio용): 패키지를 업데이트해: npm i @astroway/mcp@latest. 스키마가 최신 사양으로 재생성돼.

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