Como publicar um app a partir do Cursor, do Claude Code ou do Windsurf
O caminho mais curto para publicar um app que você escreveu com o Cursor, o Claude Code ou o Windsurf é deixar a própria ferramenta fazer isso. Peça um servidor Next.js na Seturack, copie a linha Cole na sua ferramenta de IA da aba Visão geral do seu painel e cole na ferramenta com o seu projeto aberto. A ferramenta lê as instruções, conecta o código ao servidor pelo GitHub, executa o build e entrega um endereço HTTPS funcionando.
Isso funciona porque essas ferramentas conseguem executar comandos no seu computador e ler páginas web, como descrevem as documentações do Cursor Agent e do Claude Code. O Windsurf agora se chama Devin Desktop, que o próprio fabricante descreve como o mesmo editor com um novo nome, então os passos não mudam.
Passo a passo
- Escolha um tamanho na página do VPS Next.js e conclua o pagamento. O painel de publicação Coolify se instala sozinho no servidor.
- No seu painel da Seturack, abra o servidor em Meus servidores. Na aba Visão geral, confira se a linha App indica que está pronto.
- Copie a linha Cole na sua ferramenta de IA. Ela segue este padrão, com um endereço e uma chave que pertencem ao seu servidor:
Deploy this project to my Seturack server. Read and follow the instructions first: https://www.seturack.com/deploy.txt Panel: PANEL-ADDRESS API key: API-KEY - Abra a pasta do projeto na sua ferramenta. O Cursor e o Devin Desktop têm um painel de agente para isso, e no Claude Code você executa
claudedentro da pasta. - Cole o texto, envie e responda ao que a ferramenta perguntar.
- Quando receber o endereço, abra-o e teste as páginas que importam para você.
Em nossos testes, uma publicação levou de 1 a 6 minutos. Os tipos de projeto que já rodamos pelo Coolify são Next.js, TanStack Start, Vite (estático), HTML simples, Astro e Flask.
O que a ferramenta faz pelo caminho?
O texto aponta a ferramenta para um arquivo chamado deploy.txt, que não é específico de nenhuma ferramenta. Ele cobre estas etapas:
| Etapa | O que a ferramenta faz | O que ela precisa de você |
|---|---|---|
| Verificação do projeto | Descobre o framework, o comando de build e a porta, confirma que os arquivos .env estão no .gitignore e muda para 0.0.0.0 um app que escuta em localhost | Valores de variáveis que ela não encontra |
| Repositório | Usa um repositório público como está. Sem repositório, cria um privado depois que você aprova. Um repositório privado recebe uma deploy key que só consegue ler esse repositório | Aprovação e um login no GitHub |
| Aplicação | Cria o app pela API do Coolify e define as variáveis | Nada |
| Publicação | Inicia o build e espera. Se falhar, a ferramenta lê o log, corrige a causa e tenta de novo | Nada |
| Resultado | Abre o endereço HTTPS para confirmar que funciona e depois avisa você | Uma olhada final |
Para o GitHub, a ferramenta usa a ferramenta de linha de comando gh. Se você não estiver logado, ela pode pedir que execute gh auth login.
Como lidar com os pedidos de aprovação?
As três ferramentas executam comandos de acordo com as suas configurações de permissão. O Cursor as mantém em Settings, Agents, Approvals & Execution. O Claude Code tem modos de permissão, e o Devin Desktop tem regras Allow, Ask e Deny. Na primeira publicação, fique em um modo que pergunta, para ver cada comando antes de ele rodar.
Trate a chave de API desse texto como uma senha. As instruções dizem à ferramenta para nunca exibi-la nem colocá-la no projeto ou no repositório. Mesmo assim ela fica no histórico do seu chat, então cole-a só em uma ferramenta em que você confia e tome cuidado ao compartilhar a tela.
O que você pode pedir depois do lançamento?
- "Publique de novo a cada git push." A ferramenta adiciona um webhook assinado no GitHub, e cada push gera uma nova versão.
- "Sirva o app em app.example.com." Você primeiro vai apontar um registro A para o endereço IP do servidor. O certificado é emitido automaticamente.
- "Adicione o PostgreSQL a este app." O banco de dados roda no mesmo servidor, não pode ser acessado de fora, e o endereço dele entra no app como
DATABASE_URL.
E se travar?
| Sintoma | Causa | Solução |
|---|---|---|
| O build para com o código de saída 137 | Sem memória | Aumente pela aba Tamanho e publique de novo. O IP e os dados continuam os mesmos |
| A ferramenta não consegue ler as instruções | O acesso à web não foi aprovado | Aprove, ou cole você mesmo o conteúdo do arquivo |
| Os comandos do GitHub falham | Sem login no GitHub | Execute gh auth login |
| O site abre mas não mostra dados | Uma variável ausente | Dê o valor à ferramenta e publique de novo |
Você não precisa usar uma ferramenta. O endereço do painel, o e-mail e a senha estão na aba Visão geral, e você pode fazer o mesmo trabalho à mão no Coolify. Você tem acesso root e pode gerenciar tudo pelo painel, se preferir. Se outra ferramenta gerou o seu código, o guia geral traz um link para um artigo dela.
Perguntas frequentes
Com que tamanho devo começar?
A página de vendas recomenda pelo menos 4 GB de RAM, 2 vCores e 40 GB de disco, e o motivo é o build. Um projeto pequeno em Next.js foi compilado com 2 GB, enquanto um com 85 pacotes ficou sem memória com 2 GB e foi compilado com 4 GB. Você pode aumentar pelo seu painel depois.
Quanto custa por mês?
O tamanho mínimo recomendado custa cerca de $6 por mês (impostos incluídos), e fora da Turquia você paga em dólares americanos. Os backups diários estão incluídos no preço e o tráfego é ilimitado. A assinatura da sua ferramenta de código é separada. Nosso artigo sobre preço fixo ajuda você a fazer as contas.
Como conecto o meu próprio domínio?
Aponte um registro A para o endereço IP do servidor e depois diga o nome do domínio à ferramenta. Ela adiciona o domínio e publica de novo, e o certificado é emitido automaticamente. Nosso artigo de ajuda explica o registro DNS.
Como atualizo o app depois?
Com o webhook configurado, você envia o código com git push e o servidor o compila. Sem um, peça à ferramenta que publique de novo ou clique em Redeploy no Coolify.
Onde o banco de dados deve ficar?
Se o app guarda dados de usuários, a opção mais limpa é o PostgreSQL do mesmo painel. Com o SQLite, monte a pasta dele usando Persistent Storage, porque o contêiner é recriado a cada publicação e os arquivos gravados dentro dele desaparecem.
Isso funciona com outras ferramentas de código?
O mesmo texto funciona em qualquer ferramenta que consiga executar comandos e ler páginas web. Uma ferramenta que é só uma janela de chat não consegue chegar a um servidor, então siga o nosso guia para publicar um site feito com o ChatGPT ou o Claude.
Comentários0
Ainda não há comentários
Seja a primeira pessoa a compartilhar sua opinião.
Entre ou crie uma conta para deixar um comentário.