Cline

MCP를 통해 AstroWay API를 Cline에 연결합니다. Cline에서 가장 안정적인 전송 방식은 stdio입니다.

사전 요구 사항

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

연결

Cline → MCP Servers → Configure를 열어 cline_mcp_settings.json을 편집하세요. 아래 블록 중 하나를 붙여 넣고 Cline을 재시작하세요.

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

cline_mcp_settings.json

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

Hosted (HTTP): 사용 중인 Cline 버전이 원격 서버를 지원하는 경우:

cline_mcp_settings.json

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

확인

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

문제 해결

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

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