O que mudou na Lovable com o conector GitLab API
Em 28 de agosto de 2026, a Lovable anunciou oficialmente o conector GitLab API. A novidade amplia os App Connectors voltados a ferramentas de desenvolvimento e permite transformar dados do GitLab em funcionalidades do próprio aplicativo. Isso abre espaço para dashboards de entrega, filas de revisão de merge requests, painéis de issues, navegadores de repositório e automações ligadas ao fluxo de desenvolvimento.
O ponto mais importante é entender que o conector não é apenas uma forma de importar código. Ele dá ao app acesso controlado à GitLab REST API. Assim, você pode construir uma interface na Lovable que lê ou altera informações do GitLab conforme as permissões do token conectado.
O que você pode fazer com GitLab dentro de um app Lovable
- Listar projetos, branches, commits e arquivos de repositório
- Criar e atualizar issues
- Criar e atualizar merge requests
- Ler pipelines e seus status
- Montar dashboards de entrega e operação
- Criar filas de revisão de merge requests
- Transformar feedback recebido no app em issues do GitLab
- Permitir que cada usuário conecte sua própria conta com o app user connector
Conector GitLab API não é o mesmo que Git sync
Essa diferença evita muita confusão. O GitLab API connector serve para o aplicativo chamar a API do GitLab e trabalhar com dados como issues, pipelines e merge requests. Ele não exporta nem sincroniza automaticamente o código do seu projeto Lovable.
Se seu objetivo é manter sincronização de código entre um projeto Lovable e um repositório GitLab, use o recurso de GitLab Git sync. Se seu objetivo é construir uma aplicação que consulta ou modifica dados existentes no GitLab, use o conector GitLab API.
Pré-requisitos para conectar GitLab à Lovable
- Uma conta ou instância GitLab.com, GitLab Self-Managed ou GitLab Dedicated
- Permissão para criar conexões no workspace da Lovable
- Um token de acesso pessoal, de grupo ou de projeto com o menor escopo necessário
- Para instâncias restritas, regras de rede que permitam tráfego vindo do gateway de conectores da Lovable
- Um caso de uso claro para definir quais dados e operações o app realmente precisa acessar
Passo a passo para conectar o GitLab API na Lovable
1. Escolha o tipo de token correto
A documentação da Lovable informa que o conector aceita personal access token, group access token e project access token. A recomendação é escolher o tipo mais restrito que cubra seu caso de uso. Um token de projeto, por exemplo, pode ser melhor do que um token pessoal quando a aplicação precisa operar somente em um repositório específico.
2. Use o menor escopo necessário
Se o app apenas lê dados do GitLab, use read_api quando esse escopo for suficiente. Se a aplicação precisa criar ou alterar issues, merge requests, pipelines ou arquivos, o escopo api pode ser necessário. O escopo do token nunca deve ser mais amplo do que o necessário para a função planejada.
3. Defina validade e rotação do token
Configure uma data de expiração compatível com a política de segurança da sua operação. Antes do token expirar, planeje a rotação e atualize a conexão na Lovable. O conector não faz rotação automática de tokens pessoais, de grupo ou de projeto.
4. Abra Connectors e selecione GitLab API
Na Lovable, abra o catálogo de Connectors, selecione GitLab API e escolha Add connection. Para uma conexão compartilhada entre o chat e os apps publicados, use App + chat connector. A Lovable também oferece uma opção de app user connector quando cada usuário do aplicativo precisa autenticar sua própria conta GitLab.
5. Configure a instância e quem pode usar a conexão
Para GitLab.com, o campo de Instance URL pode ficar vazio. Em GitLab Self-Managed ou Dedicated, informe a URL HTTPS raiz da instância, sem adicionar /api/v4. Depois, escolha se a conexão ficará privada, disponível para membros específicos ou para todo o workspace.
6. Vincule a conexão ao projeto
Depois de salvar a conexão, vincule-a somente aos projetos que realmente precisam desse acesso. A partir daí, você pode implementar a funcionalidade que consome a API do GitLab. Um exemplo é um painel interno que mostra merge requests pendentes, reviewers, status da pipeline e tempo de espera de cada revisão.
Conexão compartilhada ou acesso por usuário?
No modelo App + chat connector, todos que usam aquela conexão atuam com a identidade, permissões e acesso do token configurado. Isso é útil para dashboards internos e automações de equipe. Já no app user connector, cada pessoa conecta sua própria conta GitLab e trabalha apenas com os recursos aos quais ela já tem acesso.
Para um SaaS multiusuário, essa distinção é crítica. Não use um token compartilhado para simular isolamento entre clientes. Quando cada usuário precisa ver apenas seus próprios projetos, prefira uma conexão individual por usuário.
Segurança: como evitar permissões excessivas
- Nunca cole tokens do GitLab em prompts ou em código exposto no frontend
- Use o tipo de token mais restrito possível
- Use read_api para fluxos somente de leitura quando for suficiente
- Defina expiração e processo de rotação
- Compartilhe a conexão apenas com membros e projetos que realmente precisam dela
- Separe conexões de desenvolvimento e produção quando fizer sentido
- Revise regularmente as permissões do usuário ou bot que é dono do token
