Codex CLI

AstroWay API를 Codex CLI에 MCP를 통해 연결해. Codex는 로컬 stdio 패키지를 사용하고, TOML 파일에 설정돼.

전제 조건

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 도구를 나열해’라고 입력하거나, 무료 레퍼런스 도구를 호출해 달라고 요청해. 예를 들어 별자리 목록을 받아볼 수 있어. 응답에 결과가 나오면 연결이 정상 작동하는 거야.

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

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

도움이 되었나요?

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