GitHub
Приложение Cursor для GitHub подключает ваши репозитории, чтобы вы могли использовать такие функции, как Cloud Agents и Bugbot.
Настройка
Требуются права администратора Cursor и организации GitHub.
- Перейдите в раздел Интеграции в дашборде
- Нажмите Подключить рядом с GitHub (или Управление подключениями, если GitHub уже подключён)
- Выберите Все репозитории или Выбранные репозитории
- Вернитесь в дашборд, чтобы настроить функции для своих репозиториев
Чтобы отключить аккаунт GitHub, вернитесь в дашборд интеграций и нажмите Отключить аккаунт.
Настройка списка разрешённых IP-адресов
Если ваша организация использует функцию GitHub «Список разрешённых IP-адресов» для ограничения доступа к репозиториям, Cursor можно настроить для использования размещённого egress-прокси с ограниченным набором IP-адресов.
Перед настройкой списка разрешённых IP-адресов свяжитесь с hi@cursor.com, чтобы включить эту функцию для вашей команды. Это необходимо для обоих описанных ниже способов настройки.
Включите список разрешённых IP-адресов для установленных GitHub-приложений (рекомендуется)
Для GitHub-приложения Cursor список IP-адресов уже заранее настроен. Вы можете включить allowlist для установленных приложений, чтобы они автоматически использовали этот список. Это рекомендуемый подход, поскольку он позволяет нам обновлять список, а ваша организация будет автоматически получать обновления.
Чтобы включить эту функцию:
- Перейдите в настройки безопасности вашей организации
- Откройте настройки списка разрешённых IP-адресов
- Установите флажок «Разрешить доступ GitHub-приложениям»
Подробные инструкции см. в документации GitHub.
Добавьте IP-адреса напрямую в список разрешённых IP-адресов
Если в вашей организации используются списки разрешённых IP-адресов, определяемые IdP в GitHub, или если она не может использовать заранее настроенный список разрешённых IP-адресов, добавьте IP-адреса прокси из раздела Прокси исходящего Git-трафика и список разрешённых IP-адресов.
Расширенная настройка сети
Self-hosted-инстансы поддерживают несколько способов подключения помимо allowlist IP-адресов. Подробнее о настройке и поддерживаемых вариантах приватного подключения см. в разделе Private Connectivity.
Доступно для корпоративных клиентов. Используйте AWS PrivateLink, если ваш GitHub Enterprise Server размещён в AWS или может работать за AWS Network Load Balancer. PrivateLink позволяет Cursor получать доступ к GHES и при необходимости отправлять вебхуки из GHES обратно в Cursor без исходящего трафика через публичный интернет.
Лучше всего подходит для: GHES-инстансов в AWS и команд, которым нужно приватное подключение через VPC endpoint
Безопасность: шифрование HTTPS, AWS PrivateLink, политики VPC endpoint, токены доступа сервисного аккаунта
Недостатки: требуется согласование с Cursor и настройка endpoint-сервиса AWS.
Доступно для корпоративных клиентов. Используйте Cloudflare Tunnel, если AWS PrivateLink не подходит или требуется вариант развертывания только с исходящими подключениями. В вашей сети запускается cloudflared, а Cursor предоставляет имя хоста и токен туннеля.
Лучше всего подходит для: инфраструктур без входящего сетевого доступа
Безопасность: шифрование HTTPS, Cloudflare Tunnel, токены доступа сервисного аккаунта
Недостатки: необходимо запускать и обслуживать cloudflared в вашей инфраструктуре.
Права доступа
Приложение Cursor для GitHub запрашивает следующие права доступа для работы функций Cursor:
| Право доступа | Назначение |
|---|---|
| Доступ к репозиторию | Клонировать ваш код и создавать рабочие ветки |
| Pull requests | Создавать PR и оставлять комментарии к ревью |
| Задачи | Отслеживать баги и задачи, выявленные во время ревью |
| Проверки и статусы | Сообщать о качестве кода и результатах тестов |
| Действия и рабочие процессы | Отслеживать CI/CD-конвейеры и запускать повторные прогоны CI из pull request |
| Администрирование | Читать правила защиты веток и обязательных проверок, чтобы определять возможность слияния PR |
| Пользовательские роли репозитория | Определять уровни доступа пользователей, чтобы отображались правильные параметры слияния и ревью |
| Пользовательские свойства организации | Отображать метаданные репозитория, заданные организацией, при фильтрации |
Все права доступа соответствуют принципу минимальных привилегий.
Защищённая область Git
Свяжите организацию GitHub с организацией Cursor, чтобы только ваши команды могли использовать её репозитории с Cloud Agents, автоматизациями и Bugbot. Для защиты области необходимы права владельца или администратора организации GitHub. См. Защищённая область Git.
Устранение неполадок
- Установите приложение Cursor для GitHub с доступом к репозиторию
- Проверьте права доступа к приватным репозиториям
- Проверьте права доступа аккаунта GitHub
- Предоставьте приложению право записи в pull request
- Проверьте правила защиты веток
- Переустановите приложение, если срок действия установки истёк
- Проверьте, установлено ли оно на уровне организации
- Переустановите приложение с github.com/apps/cursor
- Обратитесь в поддержку, если установка повреждена
Следующие шаги
После подключения интеграции с GitHub настройте использующие её функции:
- Bugbot — автоматизированное ревью PR, выявляющее баги и уязвимости
- Cloud Agents — ИИ-агенты, работающие в облаке с вашими репозиториями