Codex CLI

Conecta la API de AstroWay a Codex CLI a través de MCP. Codex utiliza el paquete local stdio, configurado en el archivo TOML.

Prerrequisitos

Obtén tu clave API en el dashboard. Para pruebas gratuitas, utiliza la clave de sandbox aw_test_* - no consume créditos.

Conexión

Edita ~/.codex/config.toml. Agrega el bloque de abajo y reinicia Codex CLI. La autenticación a través de variable de entorno funciona sin conexión:

~/.codex/config.toml

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

Verificación

Escribe en el chat de Codex: “Enumera las herramientas de Astroway” - o pide que invoque una herramienta de referencia gratuita, por ejemplo, obtener una lista de signos del zodiaco. Si recibes una respuesta, la conexión funciona.

Solución de problemas

• 401 / clave inválida: asegúrate de que la clave tenga el prefijo aw_live_* o aw_test_* y no esté revocada. Puedes verificarlo en el dashboard.
• Las herramientas no aparecen: reinicia completamente Codex CLI y verifica la ruta a ~/.codex/config.toml.
• Errores de validación -32602: actualiza el paquete: npm i @astroway/mcp@latest. Los esquemas se regeneran con la especificación actual.

Todos los clientes - Configuración del agente.