💡 Em uma frase: Sem GitHub, o seu app fica preso no seu computador. Com GitHub, ele vai pra nuvem, ganha histórico e pode ir pro ar em segundos.

🗺️ O que você vai ver

1. Por que isso vale o seu tempo

Antes de qualquer botão, entenda o que você ganha ao conectar:

• Backup na nuvem — se o seu computador morrer, o seu projeto não morre junto.
• Volta no tempo — quebrou o app numa alteração? Você volta pra versão que funcionava.
• Publicação (deploy) — ferramentas como Vercel e Netlify pegam o seu app direto do GitHub e colocam no ar. É assim que o projeto sai da sua máquina e vira um link que qualquer um acessa.

💡 Pense assim: O GitHub é o "Ctrl+Z infinito e datado" do seu código. Cada versão salva fica registrada, e você pode voltar pra qualquer uma delas.

2. Como conectar (o jeito fácil)

Existem dois caminhos. Você vai usar o primeiro — o segundo fica só como curiosidade.

O caminho recomendado: MCP

Com o GitHub conectado via MCP, você não precisa decorar nenhum comando. Basta escrever o pedido em linguagem natural na janela do agente, e ele cria o repositório, organiza e sobe tudo sozinho.

Exemplo de pedido que você pode escrever:

Cria um repositório privado chamado meu-projeto e sobe todos os arquivos com a mensagem "primeira versão".

Pronto. O agente faz o resto.

💡 Dica: Se quiser ver seus repositórios, é só pedir: "lista todos os meus repositórios do GitHub". Ele puxa direto, sem você abrir o navegador.

3. Como fazer o login dar certo

Essa é a parte onde a maioria empaca. Preste atenção aqui.

Opção 1: Login pelo navegador (use esta)

É o jeito mais simples. Você clica, autoriza no navegador e pronto. Comece sempre por aqui.

Opção 2: Token de acesso (o plano B)

Em alguns casos, a conexão vai pedir um token — uma espécie de senha gerada no GitHub. Você provavelmente vai esbarrar nisso em algum momento, então saiba que existe.

⚠️ Atenção: Nunca cole o token dentro de um arquivo do seu projeto que vai pro GitHub. Um token exposto pode dar acesso à sua conta inteira. E, ao gerar o token, marque apenas a permissão repo — nunca acesso total.

4. As 4 palavras que você precisa entender

Você vai ver esses termos o tempo todo. Guarde o significado simples de cada um:

5. O erro que você não pode cometer

Este é o ponto mais importante de todos: deixe o repositório privado e nunca suba suas chaves de API.

Você vai construir coisas com chaves de API, integrações de WhatsApp e, às vezes, informações sensíveis. Se criar um repositório público sem perceber, tudo isso fica exposto pra internet inteira.

Dois hábitos que resolvem isso:

• Sempre crie o repositório como privado quando houver qualquer coisa sensível.
• Use um arquivo .gitignore pra impedir que o arquivo .env (onde ficam suas chaves) seja enviado.

Pedido pronto pra você escrever no agente:

Cria um .gitignore que ignore o arquivo .env e qualquer arquivo de credencial.

⚠️ Atenção: Repositório público + arquivo .env esquecido = suas chaves de API expostas pro mundo todo. É o erro número 1 de quem está começando.

✅ Seu checklist

Antes de conectar

• Entendi por que vale a pena (backup, histórico, deploy)
• Vou usar o GitHub via MCP

Na hora de conectar

• Fiz o login pelo navegador
• Se usei token, marquei só a permissão repo
• O token não está dentro de nenhum arquivo do projeto

Segurança

• Criei o repositório como privado
• Coloquei o .env no .gitignore
• Confirmei que nenhuma chave de API foi enviada

IA para Médicos · Júlio Andrade