VS Code

AstroWay API를 VS Code에 연결하는 방법을 설명합니다. MCP를 사용하여 API를 연결하고, Copilot Chat을 Agent 모드에서 읽습니다.

선행조건

API 키를 얻으려면 AstroWay API 대시보드로 이동하세요. 무료 테스트를 위해 sandbox 키 aw_test_*를 사용하세요. 이 키는 비용을 부과하지 않습니다.

연결

프로젝트의 루트 디렉토리에 .vscode/mcp.json 파일을 생성하세요. 주의: VS Code의 키는 servers (아니면 mcpServers)이고, 각 서버에는 type 필드가 필요합니다. 아래의 블록 중 하나를 삽입하고, VS Code를 재시작하세요.

호스팅 (HTTP): 설치 없이, Bearer 토큰을 사용하여 인증합니다.

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

stdio (npx): 로컬 프로세스, 환경 변수를 사용하여 인증합니다. 오프라인에서 작동합니다.

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

확인

Copilot Chat (Agent 모드)에서 “AstroWay 도구 목록을 표시하세요”라고 입력하세요. 또는 무료 reference 도구를 호출하세요. 예를 들어, 제자리에서 태양의 위치를 얻는 방법을 알려주세요. 결과가 나타나면, 연결이 성공적으로 작동한 것입니다.

문제 해결

401 / 유효하지 않은 키: 키가 aw_live_* 또는 aw_test_*의 형식인지 확인하세요. 또한, 키가 취소되지 않았는지 확인하세요. 대시보드에서 확인할 수 있습니다: 대시보드.
도구 목록이 나타나지 않음: VS Code를 완전히 재시작하고, .vscode/mcp.json 파일의 경로를 확인하세요 (키 servers, 필드 type).
유효성 검사 오류 -32602 (stdio): 패키지를 업데이트하세요: npm i @astroway/mcp@latest. 스키마는 최신 스펙에 따라 재생성됩니다.

모든 클라이언트 - Agent 설정.

도움이 되었나요?

Запропонувати правку

마지막 업데이트: 2026. 9. 7.