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

Você usa Cursor, Claude, Copilot, ou qualquer outra IA pra 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 pra ser usada por humanos e por IAs. Os comandos são simples, as mensagens são claras, e tudo funciona no terminal — exatamente onde sua IA já opera.

Setup inicial (uma vez só)

Pede pra sua IA:

"Instala a CLI da Veloz e faz login"

Ela vai rodar:

npm install -g onveloz
veloz login

O login abre o navegador. Confirme e pronto.

Fazendo deploy

Agora é só pedir:

"Faz deploy desse projeto na Veloz"

A IA vai rodar:

veloz deploy

A CLI detecta automaticamente:

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"

Configuração avançada com veloz.json

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

Se a detecção automática não pegou algo, rode veloz deploy primeiro e depois peça pra IA ajustar o veloz.json gerado:

"Muda a porta pra 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 ou pnpm workspaces? A CLI detecta automaticamente:

veloz deploy

A CLI lista os apps do monorepo e pergunta quais você quer deployar. Para deployar todos de uma vez:

veloz deploy --all

Dicas pro-gamer

1. Deixe a IA resolver os erros

Se o deploy falhar, cola o erro no chat:

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

A IA geralmente sabe exatamente o que fazer.

2. Health checks

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

A IA edita o veloz.json existente (gerado pelo veloz deploy):

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

3. 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 deploy`	Faz o deploy
`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

MCP — Model Context Protocol

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

Cursor

Adicione no seu .cursor/mcp.json:

{
  "mcpServers": {
    "veloz": {
      "command": "npx",
      "args": ["-y", "onveloz", "--mcp"],
      "env": {
        "VELOZ_API_KEY": "sua-api-key"
      }
    }
  }
}

Claude Desktop

Adicione no claude_desktop_config.json:

{
  "mcpServers": {
    "veloz": {
      "command": "npx",
      "args": ["-y", "onveloz", "--mcp"]
    }
  }
}

Qualquer ferramenta MCP-compatible

A CLI aceita VELOZ_MCP=true para rodar em modo MCP (stdout = JSON-RPC transport, logs vão para stderr).

Com MCP, a IA não precisa mais executar comandos no terminal — ela se conecta diretamente à API com type-safety completo.

O fluxo perfeito

Você coda com a IA
Terminou? Pede: "Faz deploy"
A IA roda veloz deploy
Em 2 minutos tá no ar
Deu erro? Cola o erro, a IA arruma

Sem sair do chat. Sem abrir dashboard. Sem complicação.

Começando agora

Se você ainda não tem conta:

npm install -g onveloz
veloz login
veloz deploy

Três comandos. Seu app no ar. Feito pra vibecoders que deixam a IA trabalhar.

Deploy com IA