Cognition

Windsurf + Azion

IDE agêntica construída em torno do Cascade para tarefas em várias etapas. Conecta-se à Azion por meio do mcp-remote. Feito por Cognition.

IDEAssinaturaMultiprovedorCodebase indexado
Servidor MCP da Azion Azion CLI Documentação do Windsurf

Última atualização

Ver como Markdown

Início rápido

Instale o Windsurf

Baixe o Windsurf, abra seu projeto e inicie uma conversa no Cascade.

Downloads do Windsurf

Crie um Personal Token

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

Console › Personal Tokens

Conecte o servidor MCP de docs da Azion

O Windsurf fala stdio, então alcança um servidor HTTP por meio do mcp-remote. O Node.js 18 ou mais novo precisa estar no seu PATH.

.codeium/windsurf/mcp_config.json
01{
02 "mcpServers": {
03 "azion-docs": {
04 "command": "npx",
05 "args": [
06 "mcp-remote",
07 "https://docs-mcp.azion.com/mcp",
08 "--header",
09 "Authorization: Token YOUR_PERSONAL_TOKEN"
10 ]
11 }
12 }
13}
Verifique, depois teste um prompt

Abra o painel MCP no Cascade e atualize. azion-docs deve reportar sete ferramentas; uma linha vermelha normalmente significa que o npx não alcançou a rede.

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 Windsurf 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 Windsurf lê .windsurfrules 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.

.windsurfrules
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 Cascade mantém um plano ao longo das etapas, o que serve bem a uma migração: peça para inventariar as origens primeiro e depois convertê-las em Connectors uma de cada vez.
Um servidor travado é quase sempre o mcp-remote esperando um proxy. Execute a linha do npx manualmente uma vez para ver a saída.

FAQ

Ambos, e eles fazem trabalhos diferentes. Os são como o Windsurf 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. O mcp-remote é uma ponte, não um pacote da Azion: ele converte o transporte stdio que o Windsurf fala no HTTP que o servidor fala. O Cascade o mostra como um processo local.

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.OpenAICodexAgente de terminal que executa comandos em um sandbox e lê AGENTS.md nativamente. A Azion entra no config.toml.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.