Codex CLI

Liga a API AstroWay ao Codex CLI através do 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_* – ela não consome créditos.

Ligação

Edita ~/.codex/config.toml. Adiciona o bloco abaixo e reinicia o Codex CLI. A autenticação é feita através de uma 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 invocar uma ferramenta de referência gratuita, por exemplo obter a lista dos signos do zodíaco. Se receberes um resultado, a ligaçã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 mais recente.

Todos os clientes – Configuração do agente.