Codex CLI

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

Prérequis

Obtenez une clé API sur le tableau de bord. Pour les tests gratuits, utilisez la clé sandbox aw_test_* - elle ne consomme pas de crédits.

Connexion

Modifiez ~/.codex/config.toml. Ajoutez le bloc ci-dessous et redémarrez le CLI Codex. L’authentification via la 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

Écrivez dans le chat Codex : “Lister les outils AstroWay” - ou demandez d’appeler un outil de référence gratuit, par exemple pour obtenir la liste des signes du zodiaque. Si vous recevez un résultat en réponse, la connexion fonctionne.

Dépannage

• 401 / clé invalide : assurez-vous que la clé a le préfixe aw_live_* ou aw_test_* et n’a pas été révoquée. Vous pouvez vérifier dans le tableau de bord.
• Les outils n’apparaissent pas : redémarrez complètement le CLI Codex et vérifiez le chemin vers ~/.codex/config.toml.
• Erreurs de validation -32602 : mettez à jour le package : 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.