Fazer deploy do seu app Codex na Hostman App Platform

Você criou algo no Codex. Agora vamos colocar no ar.

Este guia cobre o caminho completo — do código gerado até uma URL pública: enviar o projeto para o GitHub, conectar à Hostman App Platform e fazer o deploy. Vamos também configurar o GitHub MCP para que o Codex possa criar repositórios e fazer push do código por conta própria — sem precisar rodar git manualmente.

Antes de começar

Você vai precisar de:

• Um projeto criado no Codex
• Uma conta na Hostman

Passo 1. Criar uma conta no GitHub

Você precisa de uma conta no GitHub para hospedar o código e conectá-lo à plataforma.

1. Acesse github.com e clique em Sign up.
2. Cadastre-se com Google, Apple ou um e-mail.
3. Após entrar, você vai cair no seu painel principal.

Passo 2. Gerar um token de acesso do GitHub

O Codex precisa de um token para interagir com sua conta do GitHub — criar repositórios, fazer push de arquivos e por aí vai.

1. Clique na sua foto de perfil (canto superior direito) → Settings.
2. Role a barra lateral esquerda até o final → Developer settings → Personal access tokens → Tokens (classic).
3. Clique em Generate new token → Generate new token (classic).
4. O GitHub pode pedir sua senha aqui — é normal.
5. Preencha os detalhes do token:

6. Selecione os escopos:

• • repo: acesso completo a repositórios (criar, editar, fazer push)
  • admin:org: só necessário se você trabalha com repositórios de uma organização

Isso é suficiente para tudo neste guia. Não marque todos os escopos — não há motivo para conceder mais acesso do que o necessário.

7. Clique em Generate token.

8. Copie o token agora — você não vai conseguir ver ele de novo.

Trate esse token como uma senha. Se ele for exposto, revogue em github.com/settings/tokens e gere um novo.

Passo 3. Conectar o GitHub ao Codex via MCP

O MCP permite que o Codex aja diretamente na sua conta do GitHub pela interface de chat. Veja como configurar.

No Codex:

1. Abra Settings → MCP Servers → Add Server.
2. Preencha os dados de conexão:

3. Salve e reinicie o Codex completamente.

4. Configure a variável de ambiente:

Agora exponha seu token para o sistema. Escolha a opção que se encaixa no seu caso:

macOS

Abra o Terminal e execute:

Só para a sessão atual:

launchctl setenv GITHUB_TOKEN 'seu-token-aqui'

Para persistir entre reinicializações:

echo 'export GITHUB_TOKEN="seu-token-aqui"' >> ~/.zshrc && source ~/.zshrc

Substitua seu-token-aqui pelo token gerado no Passo 2.

Windows

Abra o PowerShell e execute:

Só para a sessão atual:

set GITHUB_TOKEN=seu-token-aqui

Para persistir:

setx GITHUB_TOKEN "seu-token-aqui"

Substitua seu-token-aqui pelo token gerado no Passo 2.

Após rodar o comando, reinicie o Codex para que ele reconheça a variável.

5. Verifique se está funcionando:

No chat do Codex, pergunte: Quais ferramentas MCP você tem para o GitHub? Lista todas. 

Se você receber uma lista de ferramentas — está tudo certo.

Algo não funcionou? Peça ao Codex para verificar o arquivo de configuração:

• macOS: ~/.codex/config.toml
• Windows: C:\Users\<seu-usuário>\.codex\config.toml

Passo 4. Fazer push do projeto para o GitHub

Com o MCP conectado, você pode criar um repositório e fazer push do código direto pelo chat.

1. Criar o repositório.

No chat do seu projeto no Codex, digite: Cria um novo repositório público no GitHub chamado my-app

O Codex vai pedir permissão para executar a ação — confirme. Você pode verificar se o repositório foi criado em github.com.

2. Fazer push do código:

Faz o push do projeto do diretório atual para esse repositório usando o GitHub MCP.

Mencione o GitHub MCP explicitamente — caso contrário, o Codex pode tentar usar o git local, o que pode falhar se o git não estiver instalado ou configurado na sua máquina.

3. Confirme a ação quando solicitado.

Quando terminar, abra o repositório no GitHub e confira se os arquivos estão lá.

Passo 5. Fazer deploy na Hostman App Platform

Agora vamos colocar seu app para rodar.

1. Acesse o painel da Hostman → Plataforma de Apps → Criar aplicativo.
2. Escolha o tipo do seu app: selecione Frontend, Backend ou Docker — e o framework que seu app usa.

Não sabe qual framework? Pergunte ao Codex: "Qual framework esse app usa?"

3. Conecte seu repositório. Isso dá acesso a todos os seus repositórios e ativa o deploy automático — seu app fará redeploy automaticamente sempre que você fizer push de mudanças.

• • Clique no ícone do GitHub na etapa Repositório.
  • Entre na sua conta e autorize o acesso.
  • Selecione seu repositório na lista.

Se o repositório não aparecer, clique em Adicionar conta, re-autorize e tente de novo.

Mantenha a opção Compilação pelo último commit executado ativada para que a Hostman faça o redeploy automaticamente a cada push.

4. Escolha a região de deploy.

5. Configure as opções do app. Consulte o Codex se tiver dúvida. Documentação por plataforma: Frontend · Backend · Dockerfile · Docker Compose.

6. Clique em Pedido e aguarde o deploy terminar.

Seu app está no ar!

Assim que o deploy for concluído, vá para a aba Painel de Controle  → procure o campo Domínio. Esse é o endereço público do seu app.

Quer usar seu próprio domínio? Acesse Configurações para configurar. 

Com o MCP configurado, enviar atualizações é só uma mensagem no chat.

 

Sempre que você fizer mudanças no projeto, é só pedir ao Codex para fazer o push — a Hostman detecta o novo commit e faz o redeploy automaticamente.