Azure DevOps
Интеграция с Azure DevOps подключает репозитории Azure DevOps Services к Cloud Agents и Bugbot.
Интеграция с Azure DevOps доступна в публичной бета-версии. Она поддерживает Azure DevOps Services на dev.azure.com. Azure DevOps Server не поддерживается.
Поддерживаемые функции
Cloud Agents клонируют ваш код, работают с ветками и открывают pull request. Bugbot выполняет ревью pull request и публикует результаты в комментариях.
Следующие функции пока не поддерживают Azure DevOps:
- Автоматизация
- Bugbot Autofix
- Security Agents, включая Security Reviewer и Vulnerability Scanner
Сейчас эти функции работают с GitHub. Поддержка Azure DevOps есть в планах.
Настройка
Требуется доступ к организациям и репозиториям Azure DevOps, которые вы хотите использовать в Cursor.
- Перейдите в раздел Integrations в дашборде
- Нажмите Connect рядом с Azure DevOps
- Войдите в систему с помощью аккаунта Microsoft, который вы используете для Azure DevOps
- Ознакомьтесь с экраном согласия OAuth Microsoft Entra и подтвердите доступ
- Вернитесь в Cursor и выберите репозитории из ваших организаций Azure DevOps
- Настройте Cloud Agents для репозиториев, которые Cursor должен использовать
Чтобы отключить аккаунт Azure DevOps, вернитесь в дашборд интеграций и нажмите Disconnect Account.
Настройка Bugbot
Bugbot для Azure DevOps доступен в ограниченном режиме. Для настройки администратор Microsoft Entra ID должен предоставить согласие администратора тенанта; мы поможем выполнить этот шаг. Свяжитесь с нами, чтобы начать.
Bugbot выполняет ревью pull request в Azure DevOps через субъект-службу Microsoft Entra, который Cursor создаёт в вашем тенанте. Этот субъект-служба устанавливает сервисные хуки, которые прослушивает Bugbot, читает диффы pull request и публикует комментарии ревью и статусы сборки. Настройка выполняется один раз для каждой организации Azure DevOps в следующем порядке:
- Администратор коллекции проектов подключает Azure DevOps в разделе Integrations в дашборде и включает Bugbot для репозитория в разделе Bugbot в Автоматизациях. При этом определяется тенант Entra вашей организации и автоматически создаётся субъект-служба Cursor. Для создания требуется однократное согласие администратора Microsoft Entra.
- Администратор проекта добавляет субъект-службу Cursor в группу Администраторы проекта каждого проекта, для которого требуется ревью. Bugbot нужны права администратора проекта, чтобы управлять своими сервисными хуками.
- Azure DevOps применяет изменения прав доступа с задержкой в несколько минут. Переключатель, не сработавший сразу после изменения прав доступа, может сработать через несколько минут без каких-либо изменений.
Если какой-либо шаг пропущен, переключатель репозитория выдаёт ошибку с указанием пропущенного шага. Выполните его, затем снова включите репозиторий.
Bugbot для Azure DevOps работает с репозиториями команд. Репозитории в личной области не поддерживаются.
Предоставление согласия администратора Microsoft Entra
Чтобы субъект-служба Cursor был создан в вашем каталоге, администратор Microsoft Entra ID должен один раз предоставить согласие администратора для всего тенанта. Для этого требуется роль глобального администратора, администратора приложений или администратора облачных приложений. Согласие действует для всего тенанта, поэтому администратор репозитория не может предоставить его самостоятельно.
Ошибка при включении сообщает об отсутствии согласия. Вы также можете создать ссылку для предоставления согласия самостоятельно:
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%20profileЗамените {your-tenant-id} идентификатором своего тенанта из центра администрирования Microsoft Entra. client_id — это идентификатор приложения Cursor. scope включает API Azure DevOps (499b84ac-1321-427f-aa17-267ca6975798 — идентификатор Microsoft для него) и стандартные области входа. Cursor не запрашивает данные Microsoft Graph. Субъект-служба сохраняется в вашем тенанте, и вы можете отозвать его в Entra в любое время.
После того как администратор даст согласие, Microsoft перенаправит его на cursor.com/azure-devops-connected, где страница подтвердит предоставление прав. Предоставленные права хранятся в вашем тенанте, поэтому при включении следующего репозитория настройка будет завершена.
Ранее данное согласие распространяется только на права доступа, которые Cursor запрашивал на тот момент. Если Cursor добавил право доступа после того, как ваш тенант дал согласие, настройка завершится с ошибкой, и повторное подключение не поможет. Снова откройте ссылку согласия, чтобы обновить предоставленные права.
Организации Azure DevOps, использующие личный аккаунт Microsoft, не могут размещать субъект-службу. Сначала подключите организацию к Microsoft Entra ID.
Предоставьте субъекту-службе доступ к организации
После предоставления согласия Cursor добавляет субъект-службу в вашу организацию Azure DevOps и запрашивает для неё уровень доступа Basic. Оба действия выполняются автоматически с помощью аккаунта администратора, подключившего Azure DevOps. Затем субъект-служба появится в разделе Organization settings → Users.
Этому могут помешать две причины:
- Подключённый аккаунт не может добавлять пользователей в организацию. Повторно подключите Azure DevOps от имени администратора организации.
- Нет доступных мест Basic. Освободите место Basic или назначьте его субъекту-службе в разделе Organization settings → Users.
Добавьте субъект-службу в свои проекты
Сервисные хуки позволяют Azure DevOps уведомлять Bugbot о pull request, и управлять ими могут только администраторы проектов. Добавьте субъект-службу Cursor в группу Администраторы проекта каждого проекта, для которого вы хотите проводить ревью, в разделе Параметры проекта → Права доступа. Доступа к репозиторию на чтение недостаточно.
Применение изменений прав доступа может занять несколько минут, поэтому переключатель, который не сработал сразу после предоставления права доступа, может сработать через несколько минут без каких-либо изменений.
Включите Bugbot для репозиториев
- Откройте Bugbot в разделе «Автоматизация»
- Найдите свои репозитории Azure DevOps в списке установок
- Включите Bugbot для каждого репозитория, который хотите отправлять на ревью
Bugbot устанавливает сервисные хуки при включении репозитория и удаляет их при выключении. Отключение Bugbot для репозитория или отключение Azure DevOps сразу же прекращает ревью этого репозитория.
Как запускаются ревью
Bugbot выполняет ревью каждого pull request при его открытии и обновлении. Также можно запросить ревью вручную, оставив комментарий cursor review или bugbot run.
Для триггеров через комментарии есть одно ограничение Azure DevOps. Они работают только для пользователей, чей адрес для входа в Azure DevOps соответствует аккаунту Cursor в команде, которой принадлежит репозиторий. Комментарий от любого другого пользователя не запускает ревью. Для автоматических ревью такого ограничения нет: они охватывают всех авторов.
Настройка авторов для ревью
По умолчанию Bugbot выполняет ревью PR всех авторов. Чтобы ограничить список, отключите Run for All Authors в настройках Bugbot для репозитория, затем выберите Only Review PRs by... или Skip PRs by....
В этом списке указываются адреса для входа в Azure DevOps, а не имена пользователей — так и называется поле. Адрес для входа выглядит так: taylor@contoso.com. Это значение администратор вашей организации видит в разделе Organization settings → Users. Имя пользователя ни с кем не совпадёт, поэтому Bugbot не будет выполнять ��евью PR этого автора.
Отличия от других провайдеров
Настройки и правила репозитория работают в Azure DevOps. Следующие функции не поддерживаются:
- Автоматическое включение для новых репозиториев. Включайте Bugbot для каждого нового репозитория вручную.
- Автоматическое изучение правил. Правила репозитория, заданные вручную, по-прежнему применяются.
- Личные настройки Bugbot. Вместо них используются настройки репозитория, общие для всех.
- Autofix. Bugbot сообщает о найденных проблемах, не создавая коммиты с исправлениями.
Статусы сборки и политики веток
Bugbot публикует статус сборки для каждого pull request, прошедшего ревью, в контексте cursor-bugbot/review. Значения результатов см. в разделе Статусы проверок CI.
Если настроить для этого контекста обязательную политику статуса ветки, задайте для неё Условия сброса: Сбрасывать статус при появлении новых изменений. Иначе статус от предыдущего push продолжит удовлетворять требованиям политики даже после добавления новых коммитов.
Переход с прежней настройки Bugbot
Организации, включившие Bugbot для Azure DevOps до августа 2026 года, использовали прежнюю настройку для отдельных репозиториев. При включении репозитория, который всё ещё использует эту настройку, отображается сообщение «Этот репозиторий Azure DevOps всё ещё использует прежнюю настройку Bugbot».
Переход выполняется автоматически. Подключите Azure DevOps как администратор организации, затем снова включите репозиторий в Bugbot in автоматизация. Cursor удалит прежние сервисные хуки и выполнит новую настройку за один шаг.
Если Cursor сообщает, что не удалось удалить прежнюю настройку, удалите её вручную:
- В Azure DevOps откройте параметры проекта → сервисные хуки
- Удалите подписки Cursor Web Hooks, отправляющие данные на
https://api2.cursor.sh/azure_devops_webhook - Снова включите репозиторий в Bugbot in автоматизация
После перехода применяются требования новой настройки. Для вашего тенанта требуется однократное согласие администратора Microsoft Entra, а для субъекта-службы нужен уровень доступа Basic в вашей организации и членство в группе администраторов проекта каждого проекта.
URL-адреса репозиториев
Cursor поддерживает URL-адреса репозиториев Azure DevOps Services следующего формата:
https://dev.azure.com/{organization}/{project}/_git/{repository}Azure DevOps использует иерархию «организация — проект — репозиторий». Cursor отображает репозитории Azure DevOps в формате {project}/{repository}.
Если ваша организация всё ещё использует URL вида *.visualstudio.com, откройте репозиторий в Azure DevOps и скопируйте URL dev.azure.com, прежде чем добавить его в Cursor.
Права доступа
Cursor подключается к Azure DevOps через Microsoft Entra OAuth. Это подключение позволяет Cursor:
| Доступ | Назначение |
|---|---|
| Организации и проекты | Просматривать доступные вам организации, проекты и репозитории Azure DevOps |
| Репозитории кода | Клонировать репозитории и создавать рабочие ветки |
| Pull requests | Открывать, обновлять и объединять pull requests, созданные Cloud Agents |
Bugbot добавляет второе удостоверение. Cursor создает субъект-службу Microsoft Entra в вашем тенанте и использует ее для всех действий Bugbot, поэтому ревью продолжают выполняться, даже если пользователь, настроивший интеграцию, меняет роль или уходит.
| Действие | Удостоверение Azure DevOps |
|---|---|
| Комментарии к ревью Bugbot, inline-комментарии и статусы сборки | Субъект-служба Cursor |
| Установка и удаление service hook Bugbot | Субъект-служба Cursor |
| Git-клонирование, отправка веток, коммиты и создание pull request облачными агентами | Подключенный пользователь Azure DevOps |
Устранение неполадок
- Убедитесь, что репозиторий размещён в Azure DevOps Services на
dev.azure.com. - Убедитесь, что подключённый аккаунт Microsoft имеет доступ к организации, проекту и репозиторию.
- Если ваш доступ к аккаунту Microsoft изменился, повторно подключите Azure DevOps на дашборде интеграций.
- Убедитесь, что выбранный репозиторий Azure DevOps подключён к Cursor.
- Проверьте, может ли ваш аккаунт Azure DevOps создавать ветки и pull request в целевом репозитории.
- Проверьте политики ветки: возможно, целевая ветка блокирует создание или обновление pull request.
Используйте URL-адрес репозитория на dev.azure.com из Azure DevOps. Cursor не поддерживает URL Azure DevOps Server для этой интеграции.
- Убедитесь, что репозиторий включён в Bugbot in автоматизация.
- Убедитесь, что репозиторий принадлежит команде Cursor. Bugbot в Azure DevOps не выполняет ревью репозиториев в личной области.
- Убедитесь, что субъект-служба Cursor входит в группу Администраторы проекта проекта в разделе Параметры проекта → Право доступа.
- Если вы фильтруете авторов, убедитесь, что автор pull request указан по адресу для входа в Azure DevOps, а не по имени пользователя.
Триггер комментария работает, только если ваш адрес для входа в Azure DevOps соответствует аккаунту Cursor в команде, которой принадлежит репозиторий. Два адреса, принадлежащие одному человеку, всё равно считаются здесь двумя разными людьми.
Сравните адрес входа в профиле Azure DevOps с адресом электронной почты в аккаунте Cursor и попросите администратора команды пригласить этот адрес, если его нет. Автоматические ревью продолжают выполняться в любом случае.
Личные настройки Bugbot пока не применяются к репозиториям Azure DevOps. Настройки репозитория применяются. Задайте нужное поведение на уровне репозитория в Bugbot in автоматизация.
Откройте политику ветки для статуса cursor-bugbot/review и задайте для Условия сброса значение Сбрасывать статус при появлении новых изменений. В противном случае Azure DevOps сохраняет предыдущий статус, поэтому политика проходит для коммитов, которые Bugbot не проверял.
Дальнейшие действия
После подключения интеграции с Azure DevOps настройте функции, которые её используют:
- Bugbot — автоматизированные ревью PR, выявляющие баги и уязвимости
- Cloud Agents — ИИ-агенты, работающие в облаке с вашими репозиториями
- Настройка Cloud Agent — сохранённые инфраструктуры, настройка работы с несколькими репозиториями, секреты и Dockerfiles