Azure DevOps
La integración de Azure DevOps conecta repositorios de Azure DevOps Services con agentes en la nube y Bugbot.
La integración de Azure DevOps está en beta pública. Es compatible con Azure DevOps Services en dev.azure.com. Azure DevOps Server no es compatible.
Funciones compatibles
Los agentes en la nube clonan tu código, trabajan en ramas y abren pull requests. Bugbot revisa pull requests y publica sus hallazgos como comentarios.
Las siguientes funciones aún no son compatibles con Azure DevOps:
- Automatizaciones
- Bugbot Autofix
- Agentes de seguridad, incluidos Revisor de seguridad y Escáner de vulnerabilidades
Estas funciones funcionan actualmente con GitHub. La compatibilidad con Azure DevOps está en la hoja de ruta.
Configuración
Requiere acceso a las organizaciones y los repositorios de Azure DevOps que quieras usar con Cursor.
- Ve a Integraciones en el panel de control
- Haz clic en Conectar junto a Azure DevOps
- Inicia sesión con la cuenta de Microsoft que usas para Azure DevOps
- Revisa la pantalla de consentimiento de OAuth de Microsoft Entra y aprueba el acceso
- Vuelve a Cursor y selecciona repositorios de tus organizaciones de Azure DevOps
- Configura agentes en la nube en los repositorios que quieras que use Cursor
Para desconectar tu cuenta de Azure DevOps, vuelve al panel de control de integraciones y haz clic en Desconectar cuenta.
Configurar Bugbot
Bugbot para Azure DevOps está disponible de forma limitada. La configuración requiere que un administrador de Microsoft Entra ID conceda el consentimiento de administrador del inquilino. Te guiaremos en este paso. Contáctanos para comenzar.
Bugbot revisa pull requests de Azure DevOps mediante una entidad de servicio de Microsoft Entra que Cursor aprovisiona en tu inquilino. Esta entidad instala los hooks de servicio que Bugbot supervisa, lee los diffs de los pull requests y publica comentarios de revisión y estados de compilación. La configuración se realiza una vez por organización de Azure DevOps, en este orden:
- Un Project Collection Administrator conecta Azure DevOps desde Integraciones en el Panel de control y activa Bugbot para un repositorio en Bugbot en Automatizaciones. Esto detecta el inquilino de Entra de tu organización y aprovisiona automáticamente la entidad de servicio de Cursor. El aprovisionamiento requiere el consentimiento de administrador de Microsoft Entra de una sola vez.
- Un administrador del proyecto añade la entidad de servicio de Cursor al grupo Project Administrators de cada proyecto que quieras revisar. Bugbot necesita administración del proyecto para gestionar sus hooks de servicio.
- Azure DevOps aplica los cambios de permisos con un retraso de unos minutos. Un interruptor que falla justo después de un cambio de permisos puede funcionar sin cambios unos minutos más tarde.
Cuando falta un paso, el interruptor del repositorio falla con un error que indica el paso faltante. Corrígelo y vuelve a activar el repositorio.
Bugbot para Azure DevOps funciona con repositorios de equipo. No se admiten repositorios de ámbito personal.
Otorgar el consentimiento de administrador de Microsoft Entra
Antes de que pueda crearse la entidad de servicio de Cursor en tu directorio, un administrador de Microsoft Entra ID debe otorgar una vez el consentimiento de administrador para todo el inquilino. Se requiere el rol de administrador global, administrador de aplicaciones o administrador de aplicaciones en la nube. Se aplica a todo el inquilino, por lo que un administrador de repositorios por sí solo no puede completarlo.
El error de activación indica cuándo falta el consentimiento. También puedes crear tú mismo el enlace de consentimiento:
https://login.microsoftonline.com/{your-tenant-id}/v2.0/adminconsent?client_id=29df4809-337a-4255-bd57-d4a1476b0e65&redirect_uri=https://cursor.com/azure-devops-connected&scope=499b84ac-1321-427f-aa17-267ca6975798/.default%20offline_access%20openid%20profileSustituya {your-tenant-id} por el ID de su inquilino en el centro de administración de Microsoft Entra. El client_id es el ID de aplicación de Cursor. El scope incluye la API de Azure DevOps (499b84ac-1321-427f-aa17-267ca6975798 es el identificador de Microsoft para esta API), además de los ámbitos estándar de inicio de sesión. Cursor no solicita datos de Microsoft Graph. Su inquilino conserva la entidad de servicio y puede revocarla en Entra en cualquier momento.
Después de que el administrador dé su consentimiento, Microsoft lo redirige a cursor.com/azure-devops-connected y la página confirma la concesión. La concesión permanece en su inquilino, por lo que al activar el siguiente repositorio se completa la configuración.
Un consentimiento anterior solo cubre los permisos que Cursor solicitó en ese momento. Si Cursor ha añadido algún permiso desde que su inquilino dio su consentimiento, la configuración falla a mitad del proceso y volver a conectarse no lo soluciona. Abra de nuevo el enlace de consentimiento para actualizar la concesión.
Las organizaciones de Azure DevOps respaldadas por una cuenta personal de Microsoft no pueden alojar la entidad de servicio. Primero conecte la organización a Microsoft Entra ID.
Concede acceso a la entidad de servicio a tu organización
Tras otorgar el consentimiento, Cursor añade la entidad de servicio a tu organización de Azure DevOps y solicita para ella un nivel de acceso Basic. Ambas acciones se realizan automáticamente mediante la cuenta de administrador que conectó Azure DevOps. La entidad de servicio aparecerá en Organization settings → Users.
Hay dos motivos que pueden impedirlo:
- La cuenta conectada no puede añadir usuarios a la organización. Vuelve a conectar Azure DevOps como administrador de la organización.
- No hay ningún nivel de acceso Basic disponible. Libera un puesto Basic o asígnale uno a la entidad de servicio en Organization settings → Users.
Añade la entidad de servicio a tus proyectos
Los hooks de servicio permiten que Azure DevOps notifique a Bugbot sobre los pull requests, y solo los administradores del proyecto pueden gestionarlos. Añade la entidad de servicio de Cursor al grupo Project Administrators de cada proyecto que quieras revisar, en ajuste del proyecto → Permisos. El acceso de lectura al repositorio no es suficiente.
Los cambios de permisos pueden tardar unos minutos en aplicarse, por lo que un interruptor que falle justo después de concederlos puede funcionar sin cambios unos minutos más tarde.
Activa Bugbot en los repositorios
- Abre Bugbot en Automatizaciones
- Busca tus repositorios de Azure DevOps en la lista de instalaciones
- Activa Bugbot en cada repositorio que quieras que revise
Bugbot instala sus hooks de servicio al activar un repositorio y los elimina al desactivarlo. Desactivar Bugbot en un repositorio o desconectar Azure DevOps detiene de inmediato las revisiones de ese repositorio.
Cómo se activan las revisiones
Bugbot revisa cada pull request cuando se abre y se actualiza. También se puede solicitar una revisión bajo demanda comentando cursor review o bugbot run.
Los activadores por comentario tienen una limitación en Azure DevOps. Solo funcionan para las personas cuya dirección de inicio de sesión de Azure DevOps coincide con la de una cuenta de Cursor del equipo propietario del repositorio. Un comentario de cualquier otra persona no inicia una revisión. Las revisiones automáticas no tienen esta limitación y cubren a todos los autores.
Filtrar los autores que se revisan
De forma predeterminada, Bugbot revisa a todos los autores. Para limitarlo, desactiva Run for All Authors en los ajustes de Bugbot del repositorio y, después, selecciona Only Review PRs by... o Skip PRs by....
Esa lista usa direcciones de inicio de sesión de Azure DevOps, no nombres de usuario, y el campo está etiquetado así. Una dirección de inicio de sesión tiene un formato como taylor@contoso.com y es el valor que el administrador de tu organización consulta en Organization settings → Users. Un nombre de usuario no coincide con nadie, por lo que Bugbot no revisa los PR de ese autor.
Diferencias con otros proveedores
Los ajustes y las reglas del repositorio funcionan en Azure DevOps. Estas funciones no:
- Activación automática para repositorios nuevos. Activa Bugbot manualmente en cada repositorio nuevo.
- Aprendizaje automático de reglas. Las reglas del repositorio que escribas manualmente seguirán aplicándose.
- Ajustes personales de Bugbot. En su lugar, los ajustes del repositorio se aplican a todos.
- Autofix. Bugbot informa de sus hallazgos sin abrir commits con soluciones.
Estados de compilación y políticas de rama
Bugbot publica un estado de compilación en cada pull request revisada con el contexto cursor-bugbot/review. Consulta los estados de las comprobaciones de CI para conocer el significado de cada resultado.
Si configuras ese contexto como una política de rama de estado obligatorio, establece las Condiciones de restablecimiento de la política en Restablecer el estado cuando haya cambios nuevos. De lo contrario, un estado de un push anterior seguirá cumpliendo la política después de integrar nuevos commits.
Migración desde la configuración anterior de Bugbot
Las organizaciones que activaron Bugbot para Azure DevOps antes de agosto de 2026 usaban una configuración anterior por repositorio. Un repositorio que aún usa esa configuración muestra "Este repositorio de Azure DevOps aún usa la configuración anterior de Bugbot." al activarlo.
La migración es automática. Conecta Azure DevOps como administrador de la organización y vuelve a activar el repositorio en Bugbot en Automatizaciones. Cursor elimina los hooks de servicio anteriores y completa la nueva configuración en un solo paso.
Si Cursor indica que no pudo eliminar la configuración anterior, elimínala manualmente:
- En Azure DevOps, abre ajuste del proyecto → hooks de servicio
- Elimina las suscripciones de Web Hooks de Cursor que envían eventos a
https://api2.cursor.sh/azure_devops_webhook - Vuelve a activar el repositorio en Bugbot en Automatizaciones
Los requisitos previos de la nueva configuración se aplican después de la migración. Tu inquilino necesita el consentimiento único del administrador de Microsoft Entra y la entidad de servicio necesita un nivel de acceso Basic en tu organización y pertenecer al grupo Project Administrators de cada proyecto.
URL de repositorios
Cursor admite URL de repositorios de Azure DevOps Services con este formato:
https://dev.azure.com/{organization}/{project}/_git/{repository}Azure DevOps utiliza una jerarquía de organización, proyecto y repositorio. Cursor muestra los repositorios como {project}/{repository} dentro de la organización de Azure DevOps.
Si tu organización aún utiliza una URL de *.visualstudio.com, abre el repositorio en Azure DevOps y copia la URL de dev.azure.com antes de añadirla a Cursor.
Permisos
Cursor se conecta a Azure DevOps mediante OAuth de Microsoft Entra. La conexión permite a Cursor:
| Acceso | Finalidad |
|---|---|
| Organizaciones y proyectos | Ver las organizaciones, los proyectos y los repositorios de Azure DevOps a los que tienes acceso |
| Repositorios de código | Clonar repositorios y crear ramas de trabajo |
| Pull requests | Abrir, actualizar y fusionar pull requests creadas por agentes en la nube |
Bugbot añade una segunda identidad. Cursor aprovisiona una entidad de servicio de Microsoft Entra en tu inquilino y la usa para cada acción de Bugbot, de modo que las revisiones sigan ejecutándose cuando la persona que configuró la integración cambie de rol o se vaya.
| Acción | Identidad de Azure DevOps |
|---|---|
| Comentarios de revisión de Bugbot, comentarios en línea y estados de compilación | Entidad de servicio de Cursor |
| Instalación y eliminación del hook de servicio de Bugbot | Entidad de servicio de Cursor |
| Clonación de Git, push de ramas, commits y creación de pull requests por agentes en la nube | El usuario conectado de Azure DevOps |
Solución de problemas
- Confirma que el repositorio esté alojado en Azure DevOps Services, en
dev.azure.com. - Confirma que la cuenta de Microsoft que conectaste tenga acceso a la organización, el proyecto y el repositorio.
- Vuelve a conectar Azure DevOps desde el panel de control de integraciones si cambió tu acceso a Microsoft.
- Confirma que el repositorio de Azure DevOps seleccionado esté conectado a Cursor.
- Comprueba que tu cuenta de Azure DevOps pueda crear ramas y pull requests en el repositorio de destino.
- Comprueba las políticas de rama si la rama de destino bloquea la creación o actualización de pull requests.
Usa la URL del repositorio de Azure DevOps en dev.azure.com. Cursor no acepta URL de Azure DevOps Server para esta integración.
- Confirma que el repositorio esté activado en Bugbot en Automatizaciones.
- Confirma que el repositorio pertenezca a un equipo de Cursor. Bugbot en Azure DevOps no revisa repositorios de ámbito personal.
- Confirma que la entidad de servicio de Cursor esté en el grupo Project Administrators en ajuste del proyecto → permiso.
- Si filtras por autores, confirma que el autor del pull request figure con su dirección de inicio de sesión de Azure DevOps en lugar de con su nombre de usuario.
Un desencadenador por comentario solo funciona cuando tu dirección de inicio de sesión de Azure DevOps coincide con la de una cuenta de Cursor del equipo propietario del repositorio. Dos direcciones que pertenecen a la misma persona siguen contando como dos personas distintas aquí.
Compara la dirección de inicio de sesión de tu perfil de Azure DevOps con el correo electrónico de tu cuenta de Cursor y pide a un administrador de equipo que invite esa dirección si no está incluida. Las revisiones automáticas seguirán ejecutándose de todos modos.
Los ajustes personales de Bugbot aún no se aplican a los repositorios de Azure DevOps. Los ajustes del repositorio sí. Configura el comportamiento que quieras a nivel de repositorio en Bugbot en Automatizaciones.
Abre la política de rama para el estado cursor-bugbot/review y establece condiciones de restablecimiento en Restablecer el estado siempre que haya cambios nuevos. De lo contrario, Azure DevOps conserva el estado anterior, por lo que la política se aprueba en commits que Bugbot no ha revisado.
Próximos pasos
Una vez conectada la integración de Azure DevOps, configura las funciones que la utilizan:
- Bugbot - revisiones de PR automatizadas que detectan errores y vulnerabilidades de seguridad
- Agentes en la nube - agentes de IA que se ejecutan en la nube en tus repositorios
- Configuración del agente en la nube - entornos guardados, configuración multirrepositorio, secretos y archivos Docker