Codex CLI

Connecte l’API AstroWay à Codex CLI via MCP. Codex utilise un paquet stdio local, configuré dans un fichier TOML.

Prérequis

Obtiens une clé API depuis le tableau de bord. Pour les tests gratuits, utilise la clé sandbox aw_test_* - elle ne déduit pas de crédits.

Connexion

Modifie ~/.codex/config.toml. Ajoute le bloc ci-dessous et redémarre Codex CLI. L’authentification via une variable d’environnement fonctionne hors ligne :

~/.codex/config.toml

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

Vérification

Écris à Codex dans le chat : « Liste les outils AstroWay » - ou demande-lui d’appeler un outil de référence gratuit, par exemple pour obtenir la liste des signes du zodiaque. Si une réponse est reçue, la connexion fonctionne.

Dépannage

• 401 / invalid key : assure-toi que la clé a le préfixe aw_live_* ou aw_test_* et qu’elle n’a pas été révoquée. Tu peux vérifier cela dans le tableau de bord.
• Les outils n’apparaissent pas : redémarre complètement Codex CLI et vérifie le chemin vers ~/.codex/config.toml.
• Erreurs de validation -32602 : mets à jour le paquet : npm i @astroway/mcp@latest. Les schémas sont régénérés à partir de la spécification actuelle.

Tous les clients - Configuration de l’agent.