Codex CLI

Conecta a API AstroWay ao Codex CLI via MCP. O Codex usa um pacote stdio local, configurado no ficheiro TOML.

Pré-requisitos

Obtém a chave API no dashboard. Para testes gratuitos usa a chave sandbox aw_test_* - não consome créditos.

Conexão

Edita ~/.codex/config.toml. Adiciona o bloco abaixo e reinicia o Codex CLI. A autenticação via variável de ambiente funciona offline:

~/.codex/config.toml

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

Verificação

Escreve ao Codex no chat: “Lista as ferramentas Astroway” - ou pede para chamar uma ferramenta de referência gratuita, por exemplo obter a lista dos signos do zodíaco. Se a resposta contiver um resultado, a conexão está a funcionar.

Resolução de problemas

• 401 / invalid key: certifica‑te de que a chave tem o prefixo aw_live_* ou aw_test_* e não está revogada. Podes verificar no dashboard.
• Ferramentas não aparecem: reinicia completamente o Codex CLI e verifica o caminho para ~/.codex/config.toml.
• Erros de validação -32602: atualiza o pacote: npm i @astroway/mcp@latest. Os esquemas são regenerados a partir da especificação atual.

Todos os clientes - Configuração do agente.