Background Agents와 Bugbot은 리포지토리를 복제하고 변경 사항을 푸시하려면 Cursor GitHub 앱이 필요해.

​
설치

  1. 대시보드의 Integrations로 이동
  2. GitHub 옆의 Connect 클릭
  3. 저장소 범위 선택: All repositories 또는 Selected repositories
GitHub 계정을 연결 해제하려면 Integrations 대시보드로 돌아가서 Disconnect Account를 클릭해.

​
GitHub에서 Agent 사용하기

GitHub 연동을 통해 풀 리퀘스트와 이슈에서 바로 백그라운드 에이전트 워크플로를 실행할 수 있어. 어떤 PR이나 이슈에 @cursor [prompt]라고 댓글을 달면, 컨텍스트를 읽고, 수정 사항을 적용하고, 커밋까지 푸시하는 에이전트를 트리거할 수 있어. Bugbot이 활성화되어 있다면, @cursor fix라고 댓글을 달아서 Bugbot이 제안한 수정 내용을 읽고, 해당 이슈를 처리할 백그라운드 에이전트를 트리거할 수 있어.

​
권한

GitHub 앱이 백그라운드 에이전트와 함께 작동하려면 특정 권한이 필요해:
권한목적
Repository access네 코드를 클론하고 작업 브랜치를 만들어
Pull requests검토용으로 에이전트 변경을 담은 PR을 만들어
Issues에이전트가 발견했거나 고친 버그와 작업을 추적해
Checks and statuses코드 품질과 테스트 결과를 보고해
Actions and workflowsCI/CD 파이프라인과 배포 상태를 모니터링해
모든 권한은 백그라운드 에이전트가 동작하는 데 필요한 최소 권한 원칙을 따르도록 설정돼 있어.

​
IP 허용 목록 구성

조직에서 GitHub의 IP 허용 목록 기능으로 리포지토리 접근을 제한하고 있다면, 팀에 IP 허용 목록 기능을 켜려면 먼저 지원팀에 연락해야 해.

​
지원팀에 문의

IP 허용 목록을 설정하기 전에, 이 기능을 팀에 활성화하려면 hi@cursor.com으로 연락해 줘. 아래의 두 가지 구성 방식 모두에 필요해. Cursor GitHub 앱에는 이미 IP 목록이 사전 구성되어 있어. 설치된 앱에 대해 허용 목록을 활성화하면 이 목록을 자동으로 상속해. 이 방법을 가장 권장하는 이유는 우리가 목록을 업데이트하면 조직도 자동으로 최신 목록을 적용받을 수 있기 때문이야. 활성화하려면:
  1. 조직의 Security 설정으로 이동
  2. IP allow list 설정으로 이동
  3. “Allow access by GitHub Apps” 체크
자세한 안내는 GitHub 문서를 참고해 줘.

​
허용 목록에 IP를 직접 추가하기

조직이 GitHub에서 IdP 정의 허용 목록을 사용하거나 사전 구성된 허용 목록을 사용할 수 없다면, IP 주소를 수동으로 추가하면 돼: 
184.73.225.134
3.209.66.12
52.44.113.131
IP 주소 목록은 가끔 변경될 수 있어. IP 허용 목록을 사용하는 팀에는 IP 주소가 추가되거나 제거되기 전에 미리 안내할 거야.

​
문제 해결