Bitbucket
Подключите репозитории Bitbucket Cloud к Cloud Agents и Bugbot. Репозитории Bitbucket Data Center можно подключить к Bugbot.
Настройка
Интеграция с Bitbucket Cloud находится в публичной бета-версии. Она поддерживает репозитории на bitbucket.org.
Настройка Bitbucket Cloud состоит из двух частей, для каждой из которых требуется отдельная роль:
- Каждый разработчик подключает свой аккаунт Bitbucket, чтобы Cursor мог клонировать репозитории, отправлять ветки и открывать pull request от его имени.
- Администратор рабочей области Bitbucket устанавливает приложение Cursor, чтобы комментарии Bugbot и Cloud Agent о статусе отображались от имени Cursor. Чтобы привязать установленное приложение к вашей команде Cursor, нужен администратор команды Cursor с доступом к рабочей области Bitbucket.
Подключите аккаунт Bitbucket
Требуется доступ к репозиториям рабочей области Bitbucket, которые вы хотите использовать.
- Перейдите в Интеграции на дашборде
- Нажмите Подключить рядом с Bitbucket
- Авторизуйте Cursor в Bitbucket
- Вернитесь на дашборд и убедитесь, что интеграция отображается как Подключено
Каждый, кто запускает Cloud Agents или открывает pull request из Cursor, должен подключить свой аккаунт Bitbucket.
Установите приложение Cursor в Bitbucket
Администратор рабочей области Bitbucket должен установить приложение Cursor для рабочей области. Это даёт Cursor постоянную идентичность приложения для событий репозитория, комментариев Bugbot к ревью, inline-комментариев и обновлений статуса.
Для шагов 1–4 требуется администратор рабочей области Bitbucket. Для шагов 5 и 6 требуется администратор команды Cursor с доступом к рабочей области Bitbucket. Если всю настройку выполняет один человек, ему нужны обе роли.
- Перейдите в Интеграции на дашборде
- Найдите Bitbucket и откройте меню управления
- Нажмите Установить приложение Cursor
- Установите приложение в рабочую область Bitbucket
- В настройках рабочей области Bitbucket в разделе Forge Apps выберите Cursor
- Нажмите Подключиться к Cursor и выберите команду Cursor для привязки
После привязки рабочей области на дашборде будет указано, что приложение Cursor установлено для этой рабочей области Bitbucket.
Bitbucket может уведомить Cursor об установке приложения с задержкой в несколько минут. Если Cursor не удаётся сразу найти рабочую область, подождите и повторите шаг привязки.
Как Cursor использует идентичности Bitbucket Cloud
Cursor использует разные идентичности Bitbucket для разных действий:
| Действие | Идентичность Bitbucket |
|---|---|
| Сводные комментарии Bugbot, inline-комментарии и статусы сборки | Приложение Cursor |
| Комментарии о ходе работы Cloud Agent в pull request | Приложение Cursor |
| Клонирование Git, отправка веток, коммиты и создание pull request | Подключённый пользователь Bitbucket |
Pull request, открытые Cloud Agents, привязываются к пользователю, запустившему агента. Результаты Bugbot отображаются от имени Cursor, если приложение установлено для рабочей области.
Права доступа
Интеграция с Bitbucket Cloud запрашивает права доступа, необходимые для работы Cloud Agents и Bugbot:
| Право доступа | Назначение |
|---|---|
| Аккаунт | Идентификация подключённого пользователя Bitbucket |
| Репозитории | Просмотр списка, клонирование и чтение содержимого репозиториев |
| Pull request | Чтение диффов и метаданных pull request |
| Запись в pull request | Создание pull request и публикация комментариев |
| Вебхуки | Получение событий репозитория и pull request |
Отключение Bitbucket Cloud
Отключение Bitbucket Cloud имеет два отдельных эффекта:
- Отключить аккаунт удаляет ваше личное OAuth-подключение Bitbucket из Cursor.
- Отключить приложение Cursor отменяет привязку рабочей области Bitbucket к вашей команде Cursor. Приложение может оставаться установленным в Bitbucket, пока администратор рабочей области не удалит его там.
Чтобы полностью прекратить получение событий приложения из рабочей области, удалите приложение Cursor в настройках рабочей области Bitbucket.
Расширенная настройка сети
Bitbucket Data Center поддерживает методы приватного подключения для экземпляров, которые не могут принимать трафик из публичного интернета.
Доступно для клиентов Enterprise. Разрешите Cursor получить доступ к вашему экземпляру через приватное сетевое подключение. Инструкции по настройке см. в разделе Private Connectivity или обратитесь к представителю Cursor.
Лучше всего подходит для: экземпляров за брандмауэром, включая экземпляры, размещённые в AWS, и инфраструктур, где можно запускать cloudflared
Безопасность: шифрование HTTPS, AWS PrivateLink, Cloudflare Tunnel, allowlist VPC, токены доступа сервисного аккаунта
Недостатки: требует координации с Cursor. Google Private Service Connect пока не поддерживается.
Доступно для клиентов Enterprise. Разверните туннель обратного прокси в локальной инфраструктуре, который установит исходящее подключение к Cursor. Сетевые запросы перенаправляются через туннель, поэтому экземпляру Bitbucket не требуется публичный входящий доступ. Для настройки обратитесь к представителю Cursor.
Лучше всего подходит для: инфраструктур без входящего сетевого доступа
Безопасность: шифрование HTTPS, токены доступа сервисного аккаунта
Недостатки: по сравнению с более прямыми методами подключения требует дополнительной сложности, обслуживания и может создавать риски для безопасности
Устранение неполадок
Синхронизация событий установки приложения Bitbucket может занять несколько минут. Подождите и повторите шаг Подключиться к Cursor в настройках рабочей области Bitbucket.
- Убедитесь, что вы администратор команды Cursor. Для установки приложения нужны права администратора рабочей области Bitbucket, а для привязки рабочей области к команде Cursor — права администратора команды Cursor.
- Убедитесь, что у вашей учётной записи Bitbucket есть доступ к рабочей области, которую вы привязываете.
Установите приложение Cursor в рабочей области Bitbucket и свяжите его со своей командой Cursor. Одного личного подключения к Bitbucket недостаточно, чтобы комментарии отображались от имени приложения Cursor.
- Подключите личный аккаунт Bitbucket в дашборде интеграций.
- Убедитесь, что у вашей учётной записи Bitbucket есть доступ к репозиторию на чтение и запись.
- Убедитесь, что репозиторий размещён в Bitbucket Cloud по адресу
bitbucket.org.
- Убедитесь, что токен сервисного аккаунта активен.
- Убедитесь, что сервисный аккаунт имеет доступ к репозиториям.
- Убедитесь, что Cursor может подключиться по HTTPS к имени хоста экземпляра или настроенному внешнему хосту.
- Убедитесь, что вы администратор команды Cursor.
- Убедитесь, что у зарегистрированного экземпляра есть токен сервисного аккаунта.
- Убедитесь, что сервисный аккаунт имеет права администратора репозитория.
Следующие шаги
После подключения Bitbucket настройте функции, использующие его:
- Bugbot — автоматическое ревью PR, выявляющее баги и уязвимости
- Cloud Agents — ИИ-агенты для репозиториев Bitbucket Cloud