VS Code

MCP를 통해 AstroWay API를 VS Code에 연결합니다. 설정 파일은 Agent 모드의 Copilot Chat이 읽습니다.

사전 요구 사항

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

연결

프로젝트 루트에 .vscode/mcp.json을 만드세요. 참고: VS Code에서는 키가 mcpServers가 아니라 servers이며, 각 서버에 type 필드가 필요합니다. 아래 블록 중 하나를 붙여 넣고 VS Code를 재시작하세요.

Hosted (HTTP): 설치가 필요 없으며, Bearer 토큰으로 인증합니다:

.vscode/mcp.json

{
"servers": {
  "astroway": {
    "type": "http",
    "url": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx): 로컬 하위 프로세스로 실행되며, 환경 변수로 인증하고, 오프라인에서도 작동합니다:

.vscode/mcp.json

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

확인

Copilot Chat(Agent mode)에서 “Astroway 도구 목록을 보여 줘”라고 입력하거나, 무료 reference 도구 호출을 요청해 보세요(예: 황도 12궁 목록 가져오기). 결과가 응답으로 돌아오면 연결이 정상입니다.

문제 해결

• 401 / invalid key: 키의 접두사가 aw_live_* 또는 aw_test_*인지, 키가 폐기되지 않았는지 확인하세요. 대시보드에서 확인할 수 있습니다.
• 도구가 나타나지 않음: VS Code를 완전히 재시작하고 .vscode/mcp.json 경로를 확인하세요(servers 키, type 필드).
• 유효성 검사 오류 -32602 (stdio의 경우): 패키지를 업데이트하세요: npm i @astroway/mcp@latest. 스키마는 최신 사양에서 다시 생성됩니다.

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