Pular para o conteúdo principal
Background Agents e o Bugbot precisam do app do Cursor para o GitHub para clonar repositórios e enviar alterações.

Instalação

  1. Vai em Integrações no Dashboard
  2. Clica em Connect ao lado de GitHub
  3. Escolhe o escopo do repositório: All repositories ou Selected repositories
Pra desconectar tua conta do GitHub, volta pro dashboard de integrações e clica em Disconnect Account.

Usando o Agent no GitHub

A integração com o GitHub permite executar fluxos de trabalho do agente em segundo plano diretamente de pull requests e issues. Dá pra acionar um agente para ler o contexto, implementar correções e enviar commits comentando @cursor [prompt] em qualquer PR ou issue. Se você tiver o Bugbot habilitado, comenta @cursor fix para ler 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 para funcionar com agentes em segundo plano:
PermissãoFinalidade
Acesso ao repositórioClonar seu código e criar branches de trabalho
Pull requestsCriar PRs com mudanças dos agentes para você revisar
IssuesAcompanhar bugs e tarefas que os agentes descobrirem ou corrigirem
Checks e statusesInformar sobre qualidade do código e resultados de testes
Actions e workflowsMonitorar pipelines de CI/CD e status de deployment
Todas as permissões seguem o princípio do menor privilégio necessário para a funcionalidade dos agentes em segundo plano.

Configuração de lista de IPs permitidos

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

Falar com o suporte

Antes de configurar allowlists de IP, entra em contato com hi@cursor.com para ativar esse recurso pro teu time. Isso é obrigatório para ambos os métodos de configuração abaixo. O app do GitHub do Cursor já tem a lista de IPs pré-configurada. Tu podes ativar a allowlist para apps instalados pra herdar automaticamente essa lista. Essa é a abordagem recomendada, pois nos permite atualizar a lista e tua organização recebe as atualizações automaticamente. Pra ativar:
  1. Vai nas configurações de Segurança da tua organização
  2. Abre as configurações de lista de IPs permitidos
  3. Marca “Allow access by GitHub Apps”
Pra instruções detalhadas, vê a documentação do GitHub.

Adicionar IPs diretamente à tua allowlist

Se tua organização usa allowlists definidas por IdP no GitHub ou não pode usar a allowlist pré-configurada, tu podes 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. Equipes que usam listas de permissão de IP receberão aviso prévio antes que endereços IP sejam adicionados ou removidos.

Solução de problemas

  • 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
  • Concede acesso de escrita do app para pull requests
  • Confere as regras de proteção de branches
  • Reinstala se a instalação do app tiver expirado
  • Confere 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
I