GitHub
O app do Cursor para GitHub conecta seus repositórios para que você possa usar funcionalidades como agentes na nuvem e Bugbot.
Configuração
Requer acesso de administrador do Cursor e da organização no GitHub.
- Acesse Integrações no dashboard
- Clique em Conectar ao lado do GitHub (ou em Gerenciar conexões, se já estiver conectado)
- Escolha Todos os repositórios ou Repositórios selecionados
- Volte ao dashboard para configurar funcionalidades nos seus repositórios
Para desconectar sua conta do GitHub, volte ao dashboard de integrações e clique em Desconectar conta.
Configuração da lista de IPs permitidos
Se a sua organização usa o recurso de lista de IPs permitidos do GitHub para restringir o acesso aos seus repositórios, o Cursor pode ser configurado para usar um proxy de saída hospedado com um conjunto restrito de IPs.
Antes de configurar listas de IPs permitidos, entre em contato com hi@cursor.com para habilitar essa funcionalidade para sua equipe. Isso é necessário para usar qualquer um dos métodos de configuração abaixo.
Ative a configuração da lista de IPs permitidos para GitHub Apps instalados (recomendado)
O app do Cursor para GitHub já tem a lista de IPs pré-configurada. Você pode ativar a lista de permissão para que os apps instalados herdem essa lista automaticamente. Essa é a abordagem recomendada, pois nos permite atualizar a lista, e sua organização recebe as atualizações automaticamente.
Para ativar:
- Acesse as configurações de segurança da sua organização
- Vá para as configurações da lista de IPs permitidos
- Marque "Permitir acesso por GitHub Apps"
Para instruções detalhadas, consulte a documentação do GitHub.
Adicione IPs diretamente à sua lista de permissão
Se sua organização usa listas de permissão definidas pelo IdP no GitHub ou não pode usar a lista de permissão pré-configurada, adicione os IPs do proxy listados em Proxy de saída do Git e lista de IP permitido.
Rede avançada
As instâncias auto-hospedadas oferecem vários métodos de conexão além da lista de permissão de IPs. Para detalhes de configuração e opções de rede privada compatíveis, consulte Conectividade privada.
Disponível para clientes Enterprise. Use o AWS PrivateLink quando seu GitHub Enterprise Server estiver na AWS ou puder ficar atrás de um AWS Network Load Balancer. O PrivateLink permite que o Cursor acesse o GHES e, quando necessário, que o GHES envie webhooks de volta ao Cursor sem saída pela internet pública.
Ideal para: instâncias do GHES hospedadas na AWS e equipes que desejam conectividade privada com endpoints de VPC
Segurança: criptografia HTTPS, AWS PrivateLink, políticas de endpoint de VPC, tokens de acesso de conta de serviço
Desvantagens: requer coordenação com o Cursor e a configuração do serviço de endpoint da AWS.
Disponível para clientes Enterprise. Use o Cloudflare Tunnel quando o AWS PrivateLink não for viável ou quando precisar de um modelo de implantação somente de saída. Sua rede executa o cloudflared, e o Cursor fornece o hostname e o token do túnel.
Ideal para: ambientes sem acesso de rede de entrada
Segurança: criptografia HTTPS, Cloudflare Tunnel, tokens de acesso de conta de serviço
Desvantagens: requer executar e manter o cloudflared em seu ambiente.
Permissões
O app do GitHub solicita as seguintes permissões para oferecer suporte às funcionalidades do Cursor:
| Permissão | Finalidade |
|---|---|
| Acesso ao repositório | Clonar seu código e criar branches de trabalho |
| Pull requests | Criar PRs e deixar comentários de revisão |
| Issues | Rastrear bugs e tarefas identificados durante revisões |
| Verificações e status | Relatar a qualidade do código e os resultados dos testes |
| Ações e fluxos de trabalho | Monitorar pipelines de CI/CD e acionar novas execuções de CI em pull requests |
| Administração | Ler regras de proteção de branches e verificações obrigatórias para determinar se um PR pode receber merge |
| Funções personalizadas do repositório | Determinar os níveis de acesso dos usuários para exibir as opções corretas de merge e revisão |
| Propriedades personalizadas da organização | Exibir metadados de repositórios definidos pela organização nos filtros |
Todas as permissões seguem o princípio do menor privilégio.
Escopos Git protegidos
Restrinja sua organização do GitHub à sua organização do Cursor para que apenas suas equipes possam usar os repositórios dela com agentes na nuvem, automações e o Bugbot. Proteger um escopo exige acesso de proprietário ou administrador da organização do GitHub. Consulte Escopos Git protegidos.
Solução de problemas
- Instale o app do GitHub com acesso ao repositório
- Verifique as permissões para repositórios privados
- Verifique as permissões da sua conta do GitHub
- Conceda ao app acesso de gravação a pull requests
- Verifique as regras de proteção de branch
- Reinstale o app se a instalação tiver expirado
- Verifique se ele está instalado no nível da organização
- Reinstale-o em github.com/apps/cursor
- Entre em contato com o suporte se a instalação estiver corrompida
Próximas etapas
Depois de conectar sua integração com o GitHub, configure as funcionalidades que a utilizam:
- Bugbot — revisões automatizadas de PR que detectam bugs e problemas de segurança
- agentes na nuvem — agentes de IA executados na nuvem em seus repositórios