Windsurf

MCP를 통해 AstroWay API를 Windsurf에 연결합니다. 서버는 Cascade 어시스턴트가 사용합니다.

사전 요구 사항

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

연결

~/.codeium/windsurf/mcp_config.json을 편집하세요. Settings → Cascade → MCP에서도 설정할 수 있습니다. 참고: 원격 서버의 경우 Windsurf는 url이 아니라 serverUrl 키를 사용합니다. 아래 블록 중 하나를 붙여 넣고 Windsurf를 재시작하세요.

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

~/.codeium/windsurf/mcp_config.json

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

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

~/.codeium/windsurf/mcp_config.json

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

확인

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

문제 해결

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

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