Fazer deploy ↗
docs

Deploy com IA

Como usar Cursor, Claude Code, Copilot ou qualquer agente IA para fazer deploy na Veloz sem sair do chat.

Você usa Cursor, Claude Code, Copilot ou qualquer outra IA para codar? Então você pode fazer deploy sem sair do chat. Literalmente: pede pra IA e ela faz.

Por que isso funciona

A Veloz CLI foi feita para ser usada por humanos e por agentes. Os comandos são simples, as mensagens são claras, e a CLI é também um servidor MCP. Sua IDE de IA pode chamar qualquer comando como ferramenta nativa.

Setup inicial (uma vez só)

npm i -g onveloz
veloz init

veloz init te guia: detecta o framework, faz o primeiro deploy e te oferece registrar a CLI como servidor MCP no agente que você já usa. Veja Quickstart com veloz init para detalhes.

Se você só quer conectar o MCP em um projeto já existente:

veloz mcp add

Veja MCP & Agentes IA para configuração detalhada por agente.

Fazendo deploy

Pede para o agente:

"Faz deploy desse projeto na Veloz."

Ele vai rodar veloz deploy (ou chamar a ferramenta MCP equivalente). A CLI detecta:

  • Framework (Next.js, Vite, Remix, etc.)
  • Comando de build
  • Comando de start
  • Porta

Exemplos de prompts que funcionam

Deploy básico

"Sobe isso pra produção."

Deploy com variáveis de ambiente

"Faz deploy e configura DATABASE_URL como postgres://..."

veloz env set DATABASE_URL "postgres://user:pass@host/db"
veloz deploy

Ver logs em tempo real

"Mostra os logs do meu app."

veloz logs show

Ver métricas

"Qual o status de performance do meu app?"

veloz metrics show

Pesquisar erros

"Mostra os erros recentes."

veloz logs search "error"

Simular sem subir

"Faz um dry-run do deploy para eu ver o que vai acontecer."

veloz deploy --dry-run

Configuração avançada com veloz.json

Importante: Nunca peça para a IA criar o veloz.json do zero. Esse arquivo é gerado pelo veloz deploy (ou veloz init) com IDs do servidor. Criar manualmente gera IDs inválidos e o deploy quebra.

Se a detecção automática não pegou algo, peça para a IA ajustar o veloz.json existente:

"Muda a porta para 8080 no veloz.json."

"Adiciona um preStartCommand de migration no veloz.json."

A IA pode editar campos como build.command, runtime.port, size, etc. Só não pode criar o arquivo do zero.

Monorepos

Usando Turborepo, pnpm workspaces ou Nx? A CLI detecta automaticamente:

veloz deploy           # interativo, lista os apps e pergunta quais subir
veloz deploy --all     # deploy de todos de uma vez

Dicas pro-gamer

Deixe a IA resolver os erros

Se o deploy falhar, cole o erro no chat:

"Deu esse erro no deploy: [erro]. Arruma?"

Como a IA tem acesso ao código e à CLI, geralmente sabe exatamente o que fazer.

Health checks

"Configura health check em /api/health no veloz.json."

A IA edita o veloz.json:

"runtime": {
  "healthCheck": {
    "path": "/api/health"
  }
}

Domínio customizado

"Configura meuapp.com.br como domínio."

veloz domains add meuapp.com.br

Comandos que sua IA precisa saber

Comando O que faz
veloz init Wizard guiado de setup
veloz deploy Faz o deploy
veloz deploy --dry-run Simula sem subir
veloz logs show Logs recentes
veloz logs show --follow Logs em tempo real
veloz logs show --tail 100 Últimas 100 linhas
veloz logs search "error" Pesquisar nos logs
veloz metrics show Métricas atuais
veloz metrics range Métricas com sparklines
veloz env set KEY value Define variável
veloz env list Lista variáveis
veloz domains add Adiciona domínio
veloz services list Lista serviços do projeto
veloz mcp add Conecta CLI ao seu agente
veloz skills add Gera skills para o agente

MCP, Model Context Protocol

A Veloz CLI funciona como servidor MCP, permitindo que ferramentas de IA se conectem diretamente à plataforma com acesso completo a todos os comandos.

A forma recomendada de conectar é:

veloz mcp add

A CLI detecta o agente instalado (Claude Code, Cursor, Windsurf, Claude Desktop, Codex CLI, Continue) e configura no lugar certo. Veja MCP & Agentes IA para configuração manual ou troubleshooting.

Com MCP, a IA não precisa executar comandos no terminal. Ela chama as ferramentas direto, com type-safety completo.

O fluxo perfeito

  1. Você coda com a IA
  2. Terminou? Pede: "Faz deploy."
  3. A IA chama veloz deploy (ou a ferramenta MCP)
  4. Em 2 minutos está no ar
  5. Deu erro? Cola o erro no chat e a IA arruma

Sem sair do editor. Sem abrir dashboard.

Começando agora

Se você ainda não tem conta:

npm i -g onveloz
veloz init

Dois comandos. Seu app no ar. Feito para fluxos agentic.

Próximos passos