Перейти к основному содержанию
Background Agents и Bugbot требуют приложения Cursor GitHub для клонирования репозиториев и отправки изменений.

Установка

  1. Перейди в Integrations в Dashboard
  2. Нажми Connect рядом с GitHub
  3. Выбери: All repositories или Selected repositories
Чтобы отключить свой аккаунт GitHub, вернись в раздел интеграций в Dashboard и нажми Disconnect Account.

Использование агента в GitHub

Интеграция с GitHub позволяет запускать фоновые сценарии агента прямо из pull request’ов и issues. Ты можешь запустить агента, чтобы он прочитал контекст, внес исправления и запушил коммиты, оставив комментарий @cursor [prompt] в любом PR или issue. Если у тебя включён Bugbot, оставь комментарий @cursor fix, чтобы взять предложенное исправление от Bugbot и запустить фонового агента для решения проблемы.

Разрешения

Приложению GitHub нужны определённые разрешения для работы с фоновыми агентами:
РазрешениеНазначение
Доступ к репозиториюКлонировать твой код и создавать рабочие ветки
Pull requestsСоздавать PR с изменениями агента для твоего ревью
IssuesОтслеживать баги и задачи, которые агенты находят или исправляют
Checks and statusesСообщать о качестве кода и результатах тестов
Actions and workflowsОтслеживать CI/CD‑пайплайны и статус деплоя
Все разрешения соответствуют принципу наименьших привилегий, необходимых для работы фоновых агентов.

Настройка списка разрешённых IP

Если твоя организация использует функцию GitHub по списку разрешённых IP для ограничения доступа к репозиториям, сначала свяжись с поддержкой, чтобы включить функциональность allowlist IP для вашей команды.

Связаться с поддержкой

Перед настройкой allowlist IP свяжись с hi@cursor.com, чтобы включить эту функцию для вашей команды. Это требуется для обоих методов ниже. У приложения Cursor для GitHub список IP уже преднастроен. Ты можешь включить allowlist для установленных приложений, чтобы автоматически унаследовать этот список. Это рекомендованный подход, потому что он позволяет нам обновлять список, а твоя организация будет получать обновления автоматически. Чтобы включить это:
  1. Перейди в раздел Security настроек организации
  2. Открой настройки IP allow list
  3. Отметь “Allow access by GitHub Apps”
Подробные инструкции смотри в документации GitHub.

Добавить IP-адреса напрямую в свой allowlist

Если твоя организация использует определяемые IdP allowlist в GitHub или по другим причинам не может использовать преднастроенный allowlist, ты можешь вручную добавить IP-адреса:
184.73.225.134
3.209.66.12
52.44.113.131
Список IP-адресов может изредка меняться. Команды, использующие списки разрешённых IP, получат заблаговременное уведомление перед добавлением или удалением IP-адресов.

Устранение неполадок

  • Установи GitHub‑приложение с доступом к репозиторию
  • Проверь права доступа к приватным репозиториям
  • Проверь свои права в аккаунте GitHub
  • Дай приложению права на запись в pull requests
  • Проверь правила защиты веток
  • Переустанови приложение, если срок установки истёк
  • Проверь, не установлено ли оно на уровне организации
  • Переустанови с github.com/apps/cursor
  • Обратись в поддержку, если установка повреждена
I