Fazer deploy do seu app Codex na Hostman App Platform

Última atualização em 7 de maio de 2026

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
Copiar link

Você vai precisar de:

Passo 1. Criar uma conta no GitHub
Copiar link

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.

Após entrar, você vai cair no seu painel principal.

Passo 2. Gerar um token de acesso do GitHub
Copiar link

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:

Campo

Valor

Note

Algo como codex-access

Expiration

No expiration (pra não precisar refazer isso)

  1. 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.

  1. Clique em Generate token.

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

Passo 3. Conectar o GitHub ao Codex via MCP
Copiar link

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:

Campo

Valor

Name

GithubMCP

Type

HTTP Streaming

URL

https://api.githubcopilot.com/mcp/

Bearer token env var

GITHUB_TOKEN

  1. Salve e reinicie o Codex completamente.

  1. 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.

  1. 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
Copiar link

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.

  1. Fazer push do código:

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

  1. 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
Copiar link

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.

  1. 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.

  1. Escolha a região de deploy.

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

  3. Clique em Pedido e aguarde o deploy terminar.

Seu app está no ar!
Copiar link

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.