Codex CLI

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

Prerequisiti

Ottieni la chiave API nel dashboard. Per il test gratuito, usa la chiave sandbox aw_test_* - non addebita crediti.

Connessione

Modifica ~/.codex/config.toml. Aggiungi il blocco sottostante 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” - o chiedi di chiamare uno strumento di riferimento gratuito, ad esempio per ottenere l’elenco dei segni zodiacali. Se ricevi una risposta, la connessione funziona.

Risoluzione dei problemi

• 401 / chiave non valida: assicurati che la chiave abbia il prefisso aw_live_* o aw_test_* e non sia stata revocata. Puoi verificare nel dashboard.
• 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 aggiornata.

Tutti i client - Configurazione agente.