Codex CLI

AstroWay API를 Codex CLI에 MCP를 통해 연결하세요. Codex는 TOML 파일에 설정된 로컬 stdio 패키지를 사용합니다.

사전 요구 사항

API 키를 대시보드에서 얻으세요. 무료 테스트를 위해 sandbox 키 aw_test_*를 사용하세요 - 이 키는 크레딧을 차지하지 않습니다.

~/.codex/config.toml를 편집하세요. 아래 블록을 추가하고 Codex CLI를 다시 시작하세요. env 변수를 통한 인증은 오프라인에서 작동합니다:

[mcp_servers.astroway]
command = "npx"
args = ["-y", "@astroway/mcp"]
env = { ASTROWAY_API_KEY = "aw_live_YOUR_KEY" }

채팅에서 Codex에 “Astroway 도구 목록을 나열해줘”라고 작성하거나, 무료 reference 도구를 호출하라고 요청하세요. 예를 들어, 황도대의 별자리 목록을 받아보세요. 응답으로 결과가 오면 연결이 제대로 작동하는 것입니다.

401 / invalid key: 키에 aw_live_* 또는 aw_test_* 접두사가 있고, 취소되지 않았는지 확인하세요. 대시보드에서 확인할 수 있습니다.
도구가 나타나지 않음: Codex CLI를 완전히 다시 시작하고 ~/.codex/config.toml 경로를 확인하세요.
유효성 검사 오류 -32602: 패키지를 업데이트하세요: npm i @astroway/mcp@latest. 스키마는 최신 사양에서 재생성됩니다.

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