Google

Gemini CLI + Azion

Agente de terminal de código aberto com um plano gratuito. Declare a Azion uma vez no settings.json e verifique com /mcp. Feito por Google.

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

Última atualização

Ver como Markdown

Início rápido

Instale o Gemini CLI

Instale a CLI globalmente e execute gemini uma vez para autenticar com sua conta Google.

01npm install -g @google/gemini-cli
Crie um Personal Token

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

Console › Personal Tokens

Conecte o servidor MCP de docs da Azion

Declare o servidor no arquivo de configurações do usuário. httpUrl é o que diz à Gemini CLI para falar HTTP em vez de iniciar um processo.

~/.gemini/settings.json
01{
02 "mcpServers": {
03 "azion-docs": {
04 "httpUrl": "https://docs-mcp.azion.com/mcp",
05 "headers": {
06 "Authorization": "Token YOUR_PERSONAL_TOKEN"
07 }
08 }
09 }
10}
Verifique, depois teste um prompt

Digite /mcp em uma sessão. Ele imprime cada servidor com seu status e as ferramentas que expõe.

01/mcp

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 Gemini CLI 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 Gemini CLI lê GEMINI.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.

GEMINI.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 GEMINI.md na raiz do repositório é a memória de projeto deste agente. Ele é lido em toda execução, então é o lugar mais barato para as convenções da sua conta.
O plano gratuito tem limite de requisições por minuto. Uma migração longa anda mais rápido em menos prompts, maiores.

FAQ

Ambos, e eles fazem trabalhos diferentes. Os são como o Gemini CLI 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.OpenAICodexAgente de terminal que executa comandos em um sandbox e lê AGENTS.md nativamente. A Azion entra no config.toml.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.