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ãoFinalidade
Acesso ao repositórioClonar teu código e criar branches de trabalho
Pull requestsCriar PRs com mudanças do agente pra tua revisão
IssuesAcompanhar bugs e tarefas que os agentes descobrem ou corrigem
Checks e statusesInformar sobre qualidade do código e resultados de testes
Actions e workflowsMonitorar 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 hi@cursor.com para habilitar esse recurso pro teu time. Isso é necessário para ambos os métodos de configuração abaixo. 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