Fazer deploy do seu app Windsurf na Hostman App Platform

O Windsurf e o Cascade AI permitem construir qualquer coisa rapidamente — de uma landing page simples até um serviço web completo. Mas, quando o projeto fica pronto, a pergunta é sempre a mesma: como colocar isso no ar?

Este guia mostra o fluxo completo de deploy: configuração do GitHub, conexão com o Windsurf via MCP, envio do projeto para um repositório e deploy na Hostman App Platform. No final, você terá uma URL pública funcionando e um setup onde futuras atualizações são publicadas automaticamente com um simples comando no Cascade.

Antes de começar

Copiar link

Certifique-se de ter:

• Um projeto no Windsurf (qualquer aplicação que você queira publicar)
• Uma conta na Hostman (crie em hostman.com, se necessário)

Etapa 1: Configurar sua conta no GitHub

Copiar link

O GitHub será usado para armazenar o código-fonte e integrar seu projeto com a Hostman. Se você já tiver conta, pode pular para a Etapa 2.

1. Acesse github.com e clique em Sign up.
2. Registre-se com Google, Apple ou e-mail.

Após o login, você verá o Dashboard do GitHub.

Etapa 2: Criar um Personal Access Token

Copiar link

Para permitir que o Cascade interaja com o GitHub, você precisa de um Personal Access Token. Com ele, o Windsurf pode criar repositórios, fazer commits, enviar código e gerenciar projetos diretamente pelo chat.

Para criar o token:

1. No GitHub, clique no seu avatar → Settings.
2. Vá em Developer settings → Personal access tokens → Tokens (classic).
3. Clique em Generate new token (classic).

4. Defina:
   • Note: nome descritivo (ex: windsurf-app)
   • Expiration: escolha ou use No expiration
5. Permissões necessárias:
   • repo (acesso completo a repositórios)
   • user (leitura do perfil)
   • admin:org (apenas para repositórios de organizações)
   • delete_repo (use para excluir repositórios via MCP)
6. Clique em Generate token.

Etapa 3: Configurar o MCP do GitHub no Windsurf

Copiar link

O MCP (Model Context Protocol) permite que o Cascade interaja diretamente com serviços externos.

Para conectar o GitHub:

1. No Windsurf, vá em Preferences → Windsurf Settings → Cascade → Open MCP Registry.

2. Clique em Add custom MCP e adicione a configuração:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Substitua SEU_TOKEN pelo token criado anteriormente.

3. Salve o arquivo.
4. Feche e reabra o Windsurf.

Depois disso, o GitHub MCP deve aparecer como Enabled.

Para testar, pergunte ao Cascade: Quais ferramentas do GitHub MCP estão disponíveis?

Etapa 4: Enviar o projeto para o GitHub

Copiar link

Com o MCP ativo, você pode fazer tudo via chat.

1. Criar repositório: Crie um repositório público chamado hostman-windsurf-app na minha conta GitHub.
2. Enviar código: Envie o projeto atual para esse repositório usando o GitHub MCP.

Se o projeto estiver em outra pasta, basta especificar o caminho.

Etapa 5: Fazer deploy na Hostman App Platform

Copiar link

Com o código no GitHub, você já pode fazer o deploy.

1. Abra o dashboard da Hostman → Plataforma de Apps → Criar aplicativo.
2. Selecione o tipo de aplicação (Frontend, Backend, Docker) e o framework do projeto.

3. Na etapa Repositório, clique no ícone do GitHub, faça login e autorize o acesso. 
4. Selecione o repositório. Se não aparecer, clique em Adicionar conta e reautorize o GitHub.
5. Mantenha ativado Compilação pelo último commit executado para permitir deploy automático a cada push.

6. Escolha a região de implantação.
7. Configure os parâmetros da aplicação. Se tiver dúvidas, peça ajuda ao Cascade. Documentação específica da plataforma: Frontend ·Backend ·Dockerfile ·Docker Compose.
8. Clique em Pedido e aguarde o processo.

Seu app está no ar!

Copiar link

Quando o deploy terminar, a Hostman vai gerar um domínio público. Você encontra ele em: Painel de Controle → Domínio. Esse é o link da sua aplicação.

Se quiser usar um domínio próprio, configure nas Configurações.