Bitbucket
Conecta repositorios de Bitbucket Cloud con agentes en la nube y Bugbot. Conecta repositorios de Bitbucket Data Center con Bugbot.
Configuración
La integración de Bitbucket Cloud está en beta pública. Es compatible con repositorios en bitbucket.org.
La configuración de Bitbucket Cloud consta de dos partes, cada una con un rol distinto:
- Cada desarrollador conecta su cuenta de Bitbucket para que Cursor pueda clonar repositorios, enviar ramas y abrir pull requests en su nombre.
- Un administrador del espacio de trabajo de Bitbucket instala la aplicación de Cursor para que Bugbot y los comentarios de estado de los agentes en la nube aparezcan como Cursor. Para vincular la aplicación instalada a tu equipo de Cursor, se necesita un administrador de equipo de Cursor con acceso al espacio de trabajo de Bitbucket.
Conecta tu cuenta de Bitbucket
Requiere acceso a los repositorios del espacio de trabajo de Bitbucket que quieras usar.
- Ve a Integraciones en el panel de control
- Haz clic en Conectar junto a Bitbucket
- Autoriza Cursor en Bitbucket
- Vuelve al panel de control y confirma que la integración aparezca como Conectado
Todas las personas que inicien agentes en la nube o abran pull requests desde Cursor deben conectar su propia cuenta de Bitbucket.
Instala la aplicación de Cursor en Bitbucket
Un administrador del espacio de trabajo de Bitbucket debe instalar la aplicación de Cursor en el espacio de trabajo. Esto proporciona a Cursor una identidad de aplicación estable para eventos de repositorios, comentarios de revisión de Bugbot, comentarios en línea y actualizaciones de estado.
Los pasos del 1 al 4 requieren un administrador del espacio de trabajo de Bitbucket. Los pasos 5 y 6 requieren un administrador de equipo de Cursor con acceso al espacio de trabajo de Bitbucket. Si una misma persona realiza toda la configuración, necesitará ambos roles.
- Ve a Integraciones en el panel de control
- Busca Bitbucket y abre el menú de administración
- Haz clic en Instalar aplicación de Cursor
- Instala la aplicación en tu espacio de trabajo de Bitbucket
- En los ajustes del espacio de trabajo de Bitbucket, en Forge Apps, selecciona Cursor
- Haz clic en Conectar con Cursor y elige el equipo de Cursor que quieres vincular
Cuando el espacio de trabajo esté vinculado, el panel de control mostrará la aplicación de Cursor instalada para ese espacio de trabajo de Bitbucket.
Bitbucket puede tardar unos minutos en notificar a Cursor después de instalar la aplicación. Si Cursor no encuentra el espacio de trabajo de inmediato, espera e intenta de nuevo el paso de vinculación.
Cómo usa Cursor las identidades de Bitbucket Cloud
Cursor usa distintas identidades de Bitbucket según la acción:
| Acción | Identidad de Bitbucket |
|---|---|
| Comentarios de resumen de Bugbot, comentarios en línea y estados de compilación | Aplicación de Cursor |
| Comentarios de progreso de los agentes en la nube en pull requests | Aplicación de Cursor |
| Clonación de Git, envío de ramas, commits y creación de pull requests | Usuario de Bitbucket conectado |
Los pull requests abiertos por agentes en la nube se atribuyen a la persona que inició el agente. Los resultados de Bugbot aparecen como Cursor cuando la aplicación del espacio de trabajo está instalada.
Permisos
La integración de Bitbucket Cloud solicita los permisos necesarios para admitir agentes en la nube y Bugbot:
| Permiso | Finalidad |
|---|---|
| Cuenta | Identificar al usuario de Bitbucket conectado |
| Repositorios | Enumerar, clonar y leer el contenido de los repositorios |
| Pull requests | Leer diffs y metadatos de pull requests |
| Escritura de pull requests | Crear pull requests y publicar comentarios |
| Webhooks | Recibir eventos de repositorios y pull requests |
Desconecta Bitbucket Cloud
Desconectar Bitbucket Cloud tiene dos efectos independientes:
- Desconectar cuenta elimina de Cursor tu conexión personal de OAuth con Bitbucket.
- Desconectar aplicación de Cursor desvincula el espacio de trabajo de Bitbucket de tu equipo de Cursor. La aplicación puede permanecer instalada en Bitbucket hasta que un administrador del espacio de trabajo la elimine allí.
Para detener por completo los eventos de la aplicación procedentes del espacio de trabajo, desinstala la aplicación de Cursor desde los ajustes del espacio de trabajo de Bitbucket.
Redes avanzadas
Bitbucket Data Center admite métodos de conexión privada para instancias que no pueden aceptar tráfico de la internet pública.
Disponible para clientes Enterprise. Permite que Cursor acceda a tu instancia a través de una conexión de red privada. Consulta Conectividad privada o contacta con tu representante de Cursor para la configuración.
Ideal para: Instancias detrás de un firewall, incluidas las alojadas en AWS y entornos que pueden ejecutar cloudflared
Seguridad: Cifrado HTTPS, AWS PrivateLink, Cloudflare Tunnel, lista de permitidos de VPC, tokens de acceso de cuentas de servicio
Desventajas: Requiere coordinación con Cursor. Google Private Service Connect no es compatible actualmente.
Disponible para clientes Enterprise. Ejecuta un túnel de proxy inverso en tus instalaciones que establezca una conexión saliente con Cursor. Las solicitudes de red se reenvían a través del túnel, por lo que la instancia de Bitbucket no necesita acceso público entrante. Contacta con tu representante de Cursor para la configuración.
Ideal para: Entornos sin acceso de red entrante
Seguridad: Cifrado HTTPS, tokens de acceso de cuentas de servicio
Desventajas: Añade complejidad, requisitos de mantenimiento y posibles consideraciones de seguridad en comparación con métodos de conexión más directos
Solución de problemas
Los eventos de instalación de la app de Bitbucket pueden tardar unos minutos en sincronizarse. Espera y vuelve a intentar el paso Conectar a Cursor desde los ajustes del espacio de trabajo de Bitbucket.
- Confirma que eres administrador de equipo de Cursor. Para instalar la app, debes ser administrador del espacio de trabajo de Bitbucket, pero para vincular el espacio de trabajo a un equipo de Cursor, debes ser administrador de equipo de Cursor.
- Confirma que tu usuario de Bitbucket tiene acceso al espacio de trabajo que estás vinculando.
Instala la app de Cursor en el espacio de trabajo de Bitbucket y vincúlala a tu equipo de Cursor. Una conexión personal de Bitbucket no es suficiente para que aparezcan los comentarios de la app de Cursor.
- Conecta tu cuenta personal de Bitbucket desde el panel de control de integraciones.
- Confirma que tu usuario de Bitbucket tiene acceso de lectura y escritura al repositorio.
- Confirma que el repositorio está en Bitbucket Cloud, en
bitbucket.org.
- Confirma que el token de la cuenta de servicio está activo.
- Confirma que la cuenta de servicio puede acceder a los repositorios.
- Confirma que Cursor puede conectarse mediante HTTPS al nombre de host de la instancia o al host externo configurado.
- Confirma que eres administrador de equipo de Cursor.
- Confirma que la instancia registrada tiene un token de cuenta de servicio.
- Confirma que la cuenta de servicio tiene acceso de administrador al repositorio.
Próximos pasos
Una vez que hayas conectado Bitbucket, configura las funciones que lo utilizan:
- Bugbot - revisiones automatizadas de PR que detectan errores y vulnerabilidades de seguridad
- Agentes en la nube - agentes de IA para repositorios de Bitbucket Cloud