GitHub

App oficial do Cursor no GitHub para agentes em segundo plano

Agentes em segundo plano e o Bugbot precisam do app do Cursor no GitHub para clonar repositórios e enviar alterações.

Instalação

1. Vai para Integrations in Dashboard
2. Clica em Connect ao lado de GitHub
3. Escolhe o repositório: All repositories ou Selected repositories

Para desconectar tua conta do GitHub, volta ao painel de integrações e clica em Disconnect Account.

Usando o Agent no GitHub

A integração com o GitHub permite fluxos de trabalho do agente em segundo plano diretamente em pull requests e issues. Você pode acionar um agente para ler o contexto, aplicar correções e enviar commits comentando @cursor [prompt] em qualquer PR ou issue.

Se você tiver o Bugbot habilitado, pode comentar @cursor fix para usar a correção sugerida pelo Bugbot e acionar um agente em segundo plano para resolver o problema.

Permissões

O app do GitHub precisa de permissões específicas pra funcionar com agentes em segundo plano:

Permissão	Finalidade
Acesso ao repositório	Clonar teu código e criar branches de trabalho
Pull requests	Criar PRs com mudanças do agente pra tua revisão
Issues	Acompanhar bugs e tarefas que os agentes descobrem ou corrigem
Checks e statuses	Informar sobre qualidade do código e resultados de testes
Actions e workflows	Monitorar pipelines de CI/CD e status de deploy

Todas as permissões seguem o princípio do menor privilégio necessário para o funcionamento dos agentes em segundo plano.

Configuração de lista de IPs permitidos

Se a tua organização usa o recurso de lista de IPs permitidos do GitHub para restringir o acesso aos repositórios, primeiro fala com o suporte para habilitar a funcionalidade de allowlist de IP para o teu time.

Falar com o suporte

Antes de configurar allowlists de IP, entra em contato com [e-mail] para habilitar esse recurso pro teu time. Isso é necessário para ambos os métodos de configuração abaixo.

Habilitar a configuração de allowlist de IP para GitHub Apps instalados (Recomendado)

O app do GitHub do Cursor já vem com a lista de IPs pré-configurada. Tu pode habilitar a allowlist para apps instalados pra herdar essa lista automaticamente. Essa é a abordagem recomendada, porque permite que a gente atualize a lista e a tua organização receba as atualizações automaticamente.

Pra habilitar:

1. Vai nas configurações de Security da tua organização
2. Abre as configurações de IP allow list
3. Marca “Allow access by GitHub Apps”

Pra instruções detalhadas, vê a documentação do GitHub.

Adicionar IPs diretamente à tua allowlist

Se a tua organização usa allowlists definidas por IdP no GitHub ou não consegue usar a allowlist pré-configurada, tu pode adicionar manualmente os endereços IP:

184.73.225.134
3.209.66.12
52.44.113.131

A lista de endereços IP pode mudar ocasionalmente. Times que usam allowlists de IP vão receber aviso com antecedência antes de endereços IP serem adicionados ou removidos.

Solução de problemas

Agente não consegue acessar o repositório

• Instala o app do GitHub com acesso ao repositório
• Confere as permissões do repositório para repos privados
• Verifica as permissões da tua conta do GitHub

Permissão negada para pull requests

• Concede acesso de escrita ao app para pull requests
• Confere as regras de proteção de branch
• Reinstala se a instalação do app tiver expirado

App não aparece nas configurações do GitHub

• Vê se foi instalado no nível da organização
• Reinstala em github.com/apps/cursor
• Fala com o suporte se a instalação estiver corrompida