Como conectar o GitHub de cada usuário em um app Lovable

Aprenda a usar o App user connector do GitHub na Lovable para que cada usuário conecte a própria conta com OAuth e permissões isoladas.

Por Guilherme Carvalho - LovAcademyAtualizado em 09 de outubro de 20266 min de leitura
Como conectar o GitHub de cada usuário em um app Lovable

Se você está criando um SaaS, dashboard para desenvolvedores, painel de issues ou ferramenta de automação na Lovable, o novo App user connector do GitHub resolve um problema importante de arquitetura: você não precisa compartilhar uma única credencial entre todos os usuários. Cada pessoa faz login com o próprio GitHub e o conector mantém as credenciais isoladas.

O que mudou no GitHub dentro da Lovable

A atualização publicada pela Lovable em 24 de agosto de 2026 adicionou suporte a acesso por usuário no conector GitHub API. Como criador do app, você configura uma aplicação OAuth do GitHub uma vez. Depois, cada usuário do seu app publicado conecta a própria conta quando precisar usar a integração.

Na prática, isso abre espaço para produtos multiusuário de verdade. Um usuário pode visualizar apenas os seus repositórios; outro pode trabalhar com os próprios pull requests; e nenhum deles precisa receber ou conhecer o token do outro. A Lovable informa que os tokens ficam armazenados de forma segura no connector gateway e não ficam expostos no código do projeto.

Git sync, conector padrão ou App user connector: qual usar?

  • Use Git sync quando o objetivo for sincronizar o código do seu projeto Lovable com um repositório.
  • Use o conector GitHub padrão quando todos os visitantes do app devem operar usando uma mesma conta ou conexão compartilhada.
  • Use o App user connector quando cada usuário precisa conectar o próprio GitHub e trabalhar apenas com os próprios dados.

Veja o guia de GitHub e Git sync da LovAcademy

Quando esse recurso faz sentido

O App user connector é especialmente útil quando o produto precisa saber quem é o usuário e usar as permissões individuais dele. Isso é comum em SaaS B2B, ferramentas internas distribuídas para vários clientes, dashboards de engenharia e produtos que trabalham com dados privados do GitHub.

  • Dashboard que lista issues abertas dos repositórios do próprio usuário.
  • Painel de pull requests com status de revisão e tempo em aberto.
  • Ferramenta que cria issues em nome do usuário a partir de um formulário.
  • Central de releases e workflows dos repositórios autorizados.
  • Painel de atividade de commits para equipes que usam contas diferentes.

Como configurar o GitHub por usuário na Lovable

1. Crie uma aplicação OAuth no GitHub

O primeiro passo é registrar uma aplicação OAuth no GitHub. Diferentemente do conector padrão baseado em personal access token, o acesso por usuário depende de OAuth para que cada pessoa possa autorizar a própria conta. Defina apenas os escopos realmente necessários para o seu produto.

2. Adicione o GitHub como App user connector

No catálogo de Connectors da Lovable, adicione uma conexão do tipo App user connector para GitHub. Esse é o tipo que separa as credenciais por usuário. O conector padrão continua sendo útil quando uma única conta deve atender todo o app, mas não é a opção indicada para um produto multi-tenant.

3. Configure o client uma única vez

Como builder, você informa os dados da aplicação OAuth criada no GitHub. Essa configuração é reutilizada pelos usuários que conectarem suas contas depois. Os dados individuais de cada usuário não ficam dentro desse client compartilhado; eles são associados à autorização feita por cada pessoa.

4. Crie a experiência de Conectar GitHub no app

No seu app, adicione uma ação clara como Conectar GitHub. Na primeira vez que o usuário precisar da integração, ele deve ser enviado para a tela oficial de consentimento do GitHub. Após autorizar, a Lovable troca o código de autorização pelos tokens e associa a conexão àquele usuário.

Criar meu app na Lovable

5. Faça chamadas usando o contexto do usuário autenticado

Depois da conexão, seu app pode pedir dados como repositórios, issues, commits e pull requests através do connector gateway. A Lovable resolve qual conta pertence ao usuário atual e injeta as credenciais corretas na chamada. O token de terceiros não precisa aparecer no frontend nem no código do projeto.

Como funciona a segurança dos tokens

Segundo a documentação oficial, as credenciais dos usuários ficam no connector gateway da Lovable. O gateway verifica a relação entre usuário, workspace e projeto antes de encaminhar a requisição ao GitHub. Ele também pode atualizar tokens expirando automaticamente e retornar um sinal de reconexão quando uma autorização deixa de ser válida.

Esse desenho é importante porque evita armazenar tokens de terceiros em tabelas comuns do seu banco ou enviá-los para o navegador. Para um SaaS com vários clientes, manter o isolamento das credenciais por usuário é uma das partes mais sensíveis da integração.

Problemas comuns e como corrigir

O usuário conectou o GitHub, mas não vê um repositório

Verifique se o repositório foi incluído nas permissões concedidas à aplicação OAuth e se os escopos solicitados permitem ler aquele recurso. Organizações também podem aplicar políticas próprias de autorização.

A chamada retorna erro de permissão

Um erro de permissão normalmente indica que o usuário autorizou a integração, mas o token não possui o escopo necessário para a operação pedida. Revise os escopos e evite simplesmente ampliar tudo; ajuste apenas a permissão relacionada ao endpoint que o app precisa usar.

A integração pede para reconectar

Isso pode acontecer quando a autorização foi revogada, quando um refresh token deixou de ser válido ou quando a conta perdeu acesso ao recurso. O comportamento ideal do app é mostrar uma mensagem clara e oferecer um botão de reconexão, sem expor detalhes sensíveis.

Boas práticas para um SaaS com GitHub na Lovable

  • Exija autenticação no seu app antes de iniciar a conexão com o GitHub.
  • Solicite somente os escopos necessários.
  • Mostre claramente quais dados serão usados.
  • Trate o estado desconectado e ofereça reconexão.
  • Não armazene tokens manualmente se o connector gateway já faz esse gerenciamento.
  • Registre erros de integração sem salvar segredos nos logs.
  • Teste com duas contas diferentes para confirmar que os dados não se misturam.

Esse recurso substitui o Git sync?

Não. Git sync continua sendo o recurso para sincronizar o código do projeto Lovable com um repositório. O App user connector serve para o app que você construiu acessar o GitHub de cada usuário em tempo de uso. É a diferença entre integrar o código do seu projeto e integrar os dados GitHub dos clientes do seu produto.

Conclusão

O GitHub por usuário aproxima a Lovable de casos de uso SaaS mais completos. Em vez de criar uma integração baseada em uma conta compartilhada, você pode entregar um produto em que cada cliente conecta o próprio GitHub, mantém suas permissões e trabalha apenas com seus repositórios e atividades. Para produtos B2B e ferramentas de desenvolvimento, essa separação torna a arquitetura muito mais adequada para múltiplos usuários.

Perguntas frequentes

Cada usuário pode conectar a própria conta GitHub em um app Lovable?
Sim. O App user connector do GitHub permite que cada usuário autorize a própria conta e trabalhe com os recursos disponíveis para ela.
É a mesma coisa que Git sync?
Não. Git sync sincroniza o código do projeto Lovable com um repositório. O App user connector permite que o app publicado acesse dados do GitHub de cada usuário.
Os tokens do GitHub ficam no meu frontend?
Segundo a documentação da Lovable, não. As credenciais ficam no connector gateway e são associadas ao usuário que autorizou a conexão.
Preciso criar uma aplicação OAuth no GitHub?
Sim. Para o fluxo por usuário, o builder configura uma aplicação OAuth que será usada nas autorizações individuais.
Posso usar esse recurso em um SaaS multi-tenant?
Esse é um dos cenários mais adequados, porque cada usuário conecta a própria conta e o gateway mantém as credenciais isoladas.

Fontes oficiais

  • Lovable Changelog — atualização de 24 de agosto de 2026 sobre GitHub API com acesso por usuário: https://docs.lovable.dev/changelog
  • Documentação de App user connectors: https://docs.lovable.dev/integrations/app-user-connectors
  • Documentação do conector GitHub API: https://docs.lovable.dev/integrations/github-api

Receba os novos artigos por e-mail

Continue lendo

Lovable - Como definir o domínio principal na Lovable e configurar o www corretamente
Deploy e Infraestrutura

Como definir o domínio principal na Lovable e configurar o www corretamente

Aprenda a definir o domínio principal na Lovable, conectar a versão www e evitar URLs concorrentes, DNS duplicado e redirecionamentos inesperados.

8 min de leitura
Lovable - Lovable Workspace Insights: como acompanhar adoção e uso dos seus apps
Novidades da Lovable

Lovable Workspace Insights: como acompanhar adoção e uso dos seus apps

O Workspace Insights da Lovable mostra visitas aos apps publicados, apps e builders ativos, conexões adicionadas e os projetos mais usados do workspace em uma visão de 30 dias.

8 min de leitura
Lovable - Como usar subdomínio na Lovable sem mexer no domínio principal
Deploy e Infraestrutura

Como usar subdomínio na Lovable sem mexer no domínio principal

Aprenda a conectar um subdomínio à Lovable sem alterar o site que já funciona no domínio principal, com DNS, SSL e troubleshooting prático.

7 min de leitura