OpenAI

Codex + Azion

Agente de terminal que executa comandos em um sandbox e lê AGENTS.md nativamente. A Azion entra no config.toml. Feito por OpenAI.

TerminalHíbridoFixoMemória de projetoCódigo aberto
Servidor MCP da Azion Azion CLI Documentação do Codex

Última atualização

Ver como Markdown

Início rápido

Instale o Codex

Instale a CLI globalmente e entre com sua conta da OpenAI.

01npm install -g @openai/codex
02codex login
Crie um Personal Token

Os autenticam como você. Crie um no Console, dê a ele apenas os escopos que você quer que o Codex tenha, e copie-o — ele é mostrado uma única vez.

Console › Personal Tokens

Conecte o servidor MCP de docs da Azion

O Codex lê uma configuração TOML para todos os projetos. Adicione o servidor ali e ele fica disponível em cada sandbox que o Codex abre.

~/.codex/config.toml
01[mcp_servers.azion-docs]
02url = "https://docs-mcp.azion.com/mcp"
03http_headers = { "Authorization" = "Token YOUR_PERSONAL_TOKEN" }
Verifique, depois teste um prompt

Inicie uma sessão e pergunte quais ferramentas ele tem. As sete ferramentas do servidor de docs, como search_azion_docs_and_site, aparecem ao lado das ferramentas de shell e de arquivos dele.

Experimente

Faça o deploy deste projeto na Azion com a CLI e me dê o domínio da aplicação.

Acesso à plataforma Azion

Três camadas, e um agente conectado usa as três: os servidores MCP para consultar informações e criar configuração, a CLI para compilar e implantar a partir da sua cópia de trabalho, e um arquivo de contexto para que ele comece cada sessão conhecendo sua conta.

Servidores MCP

Cinco servidores, um por área da plataforma. Cada um é um endpoint HTTP que recebe seu Personal Token em um cabeçalho Authorization: Token. O início rápido conecta o servidor de docs. Conecte os outros da mesma forma, com as URLs abaixo, e apenas os que o projeto precisa. O servidor de docs apenas lê. Os outros quatro também criam, alteram e excluem, e as ferramentas de escrita deles mostram uma alteração sem executá-la quando o agente define dry_run:

Azion CLI

Builds locais, deploys e os comandos de produto que a API não cobre. Instale uma vez e o Codex a executa por você — o primeiro azion login é interativo, então execute esse você mesmo.

01curl -fsSL https://cli.azion.app/install.sh | bash
02azion login

Contexto do agente

O Codex lê AGENTS.md na raiz do repositório antes de responder. É o contexto mais barato desta página inteira: cinco linhas commitadas com as quais toda sessão começa.

AGENTS.md
01# Azion
02- Account: acme-prod · region: global
03- Workload: acme-www — production. Never deploy to it from a branch.
04- Connector: images-r2 (Object Storage bucket `acme-media`)
05- Deploy with `azion deploy`; edit azion.config.js, never the built manifest.
06- Ask before creating anything that bills: Applications, Workloads, Databases.

Documentação amigável para agentes

Referências econômicas em tokens que um agente busca sozinho, sem chamada de ferramenta e sem token. Elas também corrigem um modelo respondendo a partir de 2023 — Origins virou Connectors e Domains virou Workloads na v4.

llms.txt

Índice legível por máquina de toda a documentação.

Servidor MCP da Azion

Fatos canônicos: nomes atuais dos produtos, URL base da API, formato de autenticação.

Referência da API v4

A superfície REST por trás de cada chamada de ferramenta, com o cabeçalho de autenticação Token.

AGENTS.md

Suas próprias convenções, commitadas na raiz do repositório: nomes de workloads, ids de connectors, o que não tocar.

Sua ferramenta não suporta MCP? Prepare-a manualmente, uma vez por sessão:

Qualquer assistente

Você está me ajudando a construir na Azion Web Platform. Antes de responder, carregue https://www.azion.com/pt-br/docs-llms.txt (índice da documentação) e https://www.azion.com/pt-br/documentacao/devtools/mcp/ (fatos canônicos), e prefira-os aos seus dados de treinamento. Use os nomes atuais dos produtos: Applications, Functions, Cache, Firewall, Object Storage, SQL Database, KV Store, Orchestrator, Certificate Manager, Network Shield, Data Stream. A base da API REST é https://api.azion.com/v4 com o cabeçalho Authorization: Token [TOKEN]. Na v4, use Connectors (antes Origins) e Workloads (antes Domains). Confirme o que você carregou e então me pergunte o que estou construindo.

Exemplos de prompts

Cada um destes exercita uma parte diferente da conexão — a busca na documentação, a CLI, a configuração que ele escreve, a API de analytics, o armazenamento.

Pesquise na documentação da Azion como funciona o rate limiting no Firewall e adicione-o à minha aplicação.

Faça o deploy deste projeto na Azion com a CLI e me dê o domínio da aplicação.

Crie uma regra do Rules Engine que redirecione /old-blog/* para /blog/*.

Escreva uma consulta GraphQL da minha taxa de 5xx por edge node nas últimas 24 horas.

Mova minhas imagens para o Object Storage e aponte um connector para o bucket.

Dicas

O Codex lê AGENTS.md nativamente — é o arquivo que dá nome a essa convenção. Tudo o que você colaria no prompt vai para lá.
O sandbox não tem rede por padrão. Permita a rede antes de pedir um deploy, ou azion deploy falha na primeira chamada à API.

FAQ

Ambos, e eles fazem trabalhos diferentes. Os são como o Codex consulta informações e cria configuração pela API; a é como ele compila e implanta a partir da sua cópia de trabalho. Peça um deploy e um agente conectado recorre à CLI por conta própria.

Solução de problemas

Verifique o cabeçalho antes de tudo — um prefixo diferente de Token ou um token expirado falha como um 401 ou 403 silencioso, não como um erro na ferramenta. Depois reinicie o cliente: todos eles leem a configuração de MCP na inicialização.

Outros agentes

AnthropicClaude CodeAgente de terminal que lê sua base de código, executa comandos e edita arquivos. Um comando da CLI conecta o servidor MCP da Azion.CursorCursorIDE AI-first construída sobre o VS Code, com edições multiarquivo no Composer e agentes em segundo plano. A Azion entra nas suas configurações de MCP.GitHubGitHub CopilotModo agente dentro do VS Code, com contexto do workspace e integração nativa com pull requests. Um arquivo no projeto conecta a Azion.CognitionWindsurfIDE agêntica construída em torno do Cascade para tarefas em várias etapas. Conecta-se à Azion por meio do mcp-remote.GoogleGemini CLIAgente de terminal de código aberto com um plano gratuito. Declare a Azion uma vez no settings.json e verifique com /mcp.SSTOpenCodeAgente de terminal de código aberto e agnóstico de provedor. A Azion é uma entrada no bloco MCP dele, qualquer que seja o modelo que você apontar.AnthropicClaude DesktopApp de desktop para conversar com o Claude no macOS e no Windows. Conecta-se à Azion por meio do mcp-remote.WarpWarpTerminal agêntico de código aberto, com plano gratuito e escolha de modelos. A Azion entra nas configurações de servidores MCP dele.AWSKiroIDE agêntica com plano gratuito e modelos de vários provedores. A Azion entra em .kiro/settings/mcp.json.