Bitbucket
Conecte repositórios do Bitbucket Cloud aos agentes na nuvem e ao Bugbot. Conecte repositórios do Bitbucket Data Center ao Bugbot.
Configuração
A integração com o Bitbucket Cloud está em beta público. Ela é compatível com repositórios em bitbucket.org.
A configuração do Bitbucket Cloud tem duas partes, e cada uma exige uma função diferente:
- Cada desenvolvedor conecta sua conta do Bitbucket para que o Cursor possa clonar repositórios, enviar branches e abrir pull requests em nome desse usuário.
- Um administrador do espaço de trabalho do Bitbucket instala o app Cursor para que os comentários de status do Bugbot e do Cloud Agent possam aparecer como Cursor. Para vincular o app instalado à sua equipe do Cursor, é necessário um administrador da equipe do Cursor com acesso ao espaço de trabalho do Bitbucket.
Conecte sua conta do Bitbucket
É necessário ter acesso aos repositórios do espaço de trabalho do Bitbucket que você deseja usar.
- Acesse Integrações no dashboard
- Clique em Conectar ao lado de Bitbucket
- Autorize o Cursor no Bitbucket
- Volte ao dashboard e confirme que a integração aparece como Conectado
Todas as pessoas que iniciarem Cloud Agents ou abrirem pull requests pelo Cursor devem conectar suas próprias contas do Bitbucket.
Instale o app Cursor no Bitbucket
Um administrador do espaço de trabalho do Bitbucket deve instalar o app Cursor para o espaço de trabalho. Isso fornece ao Cursor uma identidade estável de app para eventos de repositório, comentários de revisão do Bugbot, comentários em linha e atualizações de status.
As etapas 1 a 4 exigem um administrador do espaço de trabalho do Bitbucket. As etapas 5 e 6 exigem um administrador da equipe do Cursor com acesso ao espaço de trabalho do Bitbucket. Se uma única pessoa fizer toda a configuração, ela precisará das duas funções.
- Acesse Integrações no dashboard
- Encontre Bitbucket e abra o menu de gerenciamento
- Clique em Instalar app Cursor
- Instale o app no seu espaço de trabalho do Bitbucket
- Nas configurações do espaço de trabalho do Bitbucket, em Forge Apps, selecione Cursor
- Clique em Conectar ao Cursor e escolha a equipe do Cursor a ser vinculada
Quando o espaço de trabalho estiver vinculado, o dashboard mostrará que o app Cursor está instalado nesse espaço de trabalho do Bitbucket.
O Bitbucket pode levar alguns minutos para notificar o Cursor após a instalação do app. Se o Cursor não encontrar o espaço de trabalho imediatamente, aguarde e tente novamente a etapa de vinculação.
Como o Cursor usa as identidades do Bitbucket Cloud
O Cursor usa identidades diferentes do Bitbucket para ações diferentes:
| Ação | Identidade do Bitbucket |
|---|---|
| Comentários de resumo do Bugbot, comentários em linha e status de build | App Cursor |
| Comentários de progresso do Cloud Agent em pull requests | App Cursor |
| Clone do Git, envio de branch, commits e criação de pull request | Usuário conectado do Bitbucket |
Pull requests abertos por Cloud Agents são atribuídos à pessoa que iniciou o agente. A saída do Bugbot aparece como Cursor quando o app do espaço de trabalho está instalado.
Permissões
A integração com o Bitbucket Cloud solicita as permissões necessárias para oferecer suporte a Cloud Agents e ao Bugbot:
| Permissão | Finalidade |
|---|---|
| Conta | Identificar o usuário conectado do Bitbucket |
| Repositórios | Listar, clonar e ler o conteúdo do repositório |
| Pull requests | Ler diffs e metadados de pull requests |
| Gravação de pull requests | Criar pull requests e publicar comentários |
| Webhooks | Receber eventos de repositório e pull request |
Desconectar o Bitbucket Cloud
Desconectar o Bitbucket Cloud tem dois efeitos distintos:
- Desconectar conta remove do Cursor sua conexão OAuth pessoal do Bitbucket.
- Desconectar app Cursor desvincula o espaço de trabalho do Bitbucket da sua equipe do Cursor. O app pode permanecer instalado no Bitbucket até que um administrador do espaço de trabalho o remova.
Para interromper completamente os eventos do app desse espaço de trabalho, desinstale o app Cursor nas configurações do espaço de trabalho do Bitbucket.
Rede avançada
O Bitbucket Data Center oferece suporte a métodos de conexão privada para instâncias que não podem receber tráfego da internet pública.
Disponível para clientes Enterprise. Permita que o Cursor acesse sua instância por uma conexão de rede privada. Consulte Conectividade privada ou entre em contato com seu representante do Cursor para realizar a configuração.
Ideal para: Instâncias protegidas por firewall, incluindo instâncias hospedadas na AWS e ambientes que podem executar cloudflared
Segurança: Criptografia HTTPS, AWS PrivateLink, Cloudflare Tunnel, lista de permissão de VPC, tokens de acesso de conta de serviço
Desvantagens: Requer coordenação com o Cursor. No momento, o Google Private Service Connect não é compatível.
Disponível para clientes Enterprise. Execute um túnel de proxy reverso no ambiente local que estabeleça uma conexão de saída com o Cursor. As solicitações de rede são encaminhadas pelo túnel, portanto, a instância do Bitbucket não precisa de acesso público de entrada. Entre em contato com seu representante do Cursor para realizar a configuração.
Ideal para: Ambientes sem acesso de rede de entrada
Segurança: Criptografia HTTPS, tokens de acesso de conta de serviço
Desvantagens: Introduz complexidade adicional, requisitos de manutenção e possíveis considerações de segurança em comparação com métodos de conexão mais diretos
Solução de problemas
Os eventos de instalação do app do Bitbucket podem levar alguns minutos para sincronizar. Aguarde e tente novamente a etapa Conectar ao Cursor nas configurações do espaço de trabalho do Bitbucket.
- Confirme que você é administrador da equipe do Cursor. A instalação do app exige um administrador do espaço de trabalho do Bitbucket, mas vincular o espaço de trabalho a uma equipe do Cursor exige um administrador da equipe do Cursor.
- Confirme que seu usuário do Bitbucket tem acesso ao espaço de trabalho que você está vinculando.
Instale o app Cursor no espaço de trabalho do Bitbucket e vincule-o à sua equipe do Cursor. Uma conexão pessoal com o Bitbucket, por si só, não é suficiente para comentários do app Cursor.
- Conecte sua conta pessoal do Bitbucket no dashboard de integrações.
- Confirme que seu usuário do Bitbucket tem acesso de leitura e gravação ao repositório.
- Confirme que o repositório está no Bitbucket Cloud em
bitbucket.org.
- Confirme que o token da conta de serviço está ativo.
- Confirme que a conta de serviço pode acessar os repositórios.
- Confirme que o Cursor consegue acessar o nome do host da instância ou o host externo configurado por HTTPS.
- Confirme que você é administrador da equipe do Cursor.
- Confirme que a instância registrada tem um token de conta de serviço.
- Confirme que a conta de serviço tem acesso de administrador ao repositório.
Próximas etapas
Depois de conectar o Bitbucket, configure as funcionalidades que o utilizam:
- Bugbot - revisões automatizadas de PR que detectam bugs e problemas de segurança
- Agentes na nuvem - agentes de IA para repositórios do Bitbucket Cloud