Codex CLI

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

Prerrequisitos

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

Conexión

Edita ~/.codex/config.toml. Añade el siguiente bloque y reinicia Codex CLI. La autenticación a través de una 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 a Codex en el chat: «Lista las herramientas de Astroway» - o pídele que invoque una herramienta de referencia gratuita, por ejemplo, para obtener una lista de los signos del zodiaco. Si recibes un resultado, la conexión funciona.

Solución de problemas

• 401 / invalid key: asegúrate de que la clave tiene el prefijo aw_live_* o aw_test_* y no ha sido revocada. Puedes verificarlo en el panel de control.
• 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 a partir de la especificación actual.

Todos los clientes - Configuración del agente.