Codex CLI

Collega l’API AstroWay a Codex CLI tramite MCP. Codex utilizza un pacchetto stdio locale, configurato in un file TOML.

Prerequisiti

Ottieni la tua chiave API nella dashboard. Per test gratuiti, usa la chiave sandbox aw_test_* - non consumerà crediti.

Connessione

Modifica ~/.codex/config.toml. Aggiungi il blocco seguente e riavvia Codex CLI. L’autenticazione tramite variabile d’ambiente, funziona offline:

~/.codex/config.toml

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

Verifica

Scrivi a Codex nella chat: «Elenca gli strumenti AstroWay» - oppure chiedigli di invocare uno strumento di riferimento gratuito, ad esempio per ottenere un elenco di segni zodiacali. Se ricevi una risposta, la connessione funziona.

Risoluzione dei problemi

• 401 / invalid key: assicurati che la chiave abbia il prefisso aw_live_* o aw_test_* e non sia stata revocata. Puoi verificarlo nella dashboard.
• Gli strumenti non appaiono: riavvia completamente Codex CLI e controlla il percorso di ~/.codex/config.toml.
• Errori di validazione -32602: aggiorna il pacchetto: npm i @astroway/mcp@latest. Gli schemi vengono rigenerati dalla specifica più recente.

Tutti i client - Configurazione dell’agente.