Windsurf

AstroWay API를 Windsurf에 연결하세요. 서버는 Cascade 보조기능을 사용합니다.

선행 조건

AstroWay API 키를 대시보드에서 받으세요. 무료 테스트를 위해 sandbox 키 aw_test_*를 사용하세요. 이 키는 비용을 청구하지 않습니다.

연결

~/.codeium/windsurf/mcp_config.json을 편집하세요. 또한 Settings → Cascade → MCP를 통해 액세스할 수 있습니다. 주의: Windsurf의 원격 서버는 serverUrl 키를 사용합니다( url 키가 아닙니다). 아래 중 하나를 삽입하고 Windsurf를 다시 시작하세요.

호스트드 (HTTP): 설치를 생략하고, Bearer 토큰을 통해 인증:

{
"mcpServers": {
  "astroway": {
    "serverUrl": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

stdio (npx): 로컬 프로세스, 환경 변수를 통해 인증, 오프라인 작동:

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

확인

Cascade에서 “AstroWay 도구 목록”을 입력하세요. 또는 무료 reference 도구를 호출하세요(예: 천문학적 상징 목록을 얻으세요). 결과가 반환되면 연결이 성공적으로 작동한 것입니다.

문제 해결

401 / 유효하지 않은 키: 키가 aw_live_* 또는 aw_test_*로 시작하고 취소되지 않았는지 확인하세요. 대시보드에서 확인할 수 있습니다: 대시보드.
도구가 나타나지 않음: Windsurf를 완전히 다시 시작하고 ~/.codeium/windsurf/mcp_config.json 경로(호스트드 - 키 serverUrl)를 확인하세요.
유효성 검사 오류 -32602 (stdio): 패키지를 업데이트하세요: npm i @astroway/mcp@latest. 스키마는 최신 사양에 따라 재생성됩니다.

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

도움이 되었나요?

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

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