GitHub
Cursor GitHub 앱을 연결하면 클라우드 에이전트 및 Bugbot 같은 기능을 사용할 수 있습니다.
설정
Cursor 관리자 권한 및 GitHub 조직 관리자 권한이 필요합니다.
- 대시보드의 통합으로 이동합니다
- GitHub 옆의 연결을 클릭합니다(이미 연결된 경우 연결 관리)
- 모든 저장소 또는 선택한 저장소를 선택합니다
- 대시보드로 돌아가 저장소의 기능을 설정합니다
GitHub 계정 연결을 해제하려면 통합 대시보드로 돌아가 계정 연결 해제를 클릭합니다.
IP 허용 목록 구성
조직에서 GitHub의 IP 허용 목록 기능을 사용해 리포지토리 접근을 제한하는 경우, 제한된 IP 집합을 사용하는 호스팅 이그레스 프록시를 사용하도록 Cursor를 구성할 수 있습니다.
IP 허용 목록을 구성하기 전에 hi@cursor.com으로 문의하여 팀에서 이 기능을 활성화하세요. 아래의 두 구성 방법 모두에 필요합니다.
설치된 GitHub Apps에 IP 허용 목록 구성 활성화(권장)
Cursor GitHub 앱에는 이미 IP 목록이 미리 구성되어 있습니다. 설치된 앱에 대해 허용 목록을 활성화하면 이 목록을 자동으로 상속받을 수 있습니다. 목록을 업데이트하면 조직에도 자동으로 업데이트가 적용되므로 권장되는 방법입니다.
활성화하려면 다음 단계를 따르세요.
- 조직의 보안 설정으로 이동합니다.
- IP 허용 목록 설정으로 이동합니다.
- **"GitHub Apps의 접근 허용"**을 선택합니다.
자세한 지침은 GitHub 문서를 참조하세요.
허용 목록에 IP 직접 추가
조직에서 GitHub의 IdP 정의 허용 목록을 사용하거나 미리 구성된 허용 목록을 사용할 수 없는 경우, Git egress proxy 및 IP 허용 목록에 나열된 프록시 IP를 추가하세요.
고급 네트워킹
자체 호스팅 인스턴스는 IP 허용 목록 외에도 여러 연결 방식을 지원합니다. 설정 세부 정보와 지원되는 비공개 네트워킹 옵션은 Private Connectivity를 참조하세요.
엔터프라이즈 고객에게 제공됩니다. GitHub Enterprise Server가 AWS에 있거나 AWS Network Load Balancer 뒤에 배치할 수 있는 경우 AWS PrivateLink를 사용하세요. PrivateLink를 사용하면 Cursor가 GHES에 액세스하고, 필요 시 GHES가 공개 인터넷을 거치지 않고 Cursor로 웹훅을 다시 보낼 수 있습니다.
적합한 경우: AWS에서 호스팅되는 GHES 인스턴스 및 비공개 VPC 엔드포인트 연결이 필요한 팀
보안: HTTPS 암호화, AWS PrivateLink, VPC 엔드포인트 정책, 서비스 계정 액세스 토큰
단점: Cursor와의 협업 및 AWS 엔드포인트 서비스 설정이 필요합니다.
엔터프라이즈 고객에게 제공됩니다. AWS PrivateLink가 적합하지 않거나 아웃바운드 전용 배포 모델이 필요한 경우 Cloudflare Tunnel을 사용하세요. 네트워크에서 cloudflared를 실행하고, Cursor에서 터널 호스트 이름과 토큰을 제공합니다.
적합한 경우: 인바운드 네트워크 액세스가 없는 환경
보안: HTTPS 암호화, Cloudflare Tunnel, 서비스 계정 액세스 토큰
단점: 환경에서 cloudflared를 실행하고 유지 관리해야 합니다.
권한
GitHub 앱은 Cursor 기능을 지원하기 위해 다음 권한을 요청합니다.
| 권한 | 용도 |
|---|---|
| 저장소 접근 | 코드를 클론하고 작업 브랜치를 생성합니다 |
| 풀 리퀘스트 | PR을 생성하고 리뷰 댓글을 남깁니다 |
| 이슈 | 리뷰 중 발견된 버그와 작업을 추적합니다 |
| 검사 및 상태 | 코드 품질 및 테스트 결과를 보고합니다 |
| 액션 및 워크플로 | CI/CD 파이프라인을 모니터링하고 풀 리퀘스트에서 CI 재실행을 트리거합니다 |
| 관리 | PR 머지 가능 여부를 판단하기 위해 브랜치 보호 및 필수 검사 규칙을 읽습니다 |
| 사용자 정의 저장소 역할 | 적절한 머지 및 리뷰 옵션이 표시되도록 사용자 접근 수준을 확인합니다 |
| 조직 사용자 정의 속성 | 필터링에 조직에서 정의한 저장소 메타데이터를 표시합니다 |
모든 권한은 최소 권한 원칙을 따릅니다.
보호된 Git 스코프
GitHub 조직을 Cursor 조직에 연결하면 팀만 클라우드 에이전트, 자동화 및 Bugbot에서 해당 리포지토리를 사용할 수 있습니다. 스코프를 보호하려면 GitHub 조직의 소유자 또는 관리자 권한이 필요합니다. 보호된 Git 스코프를 참조하세요.
문제 해결
- 저장소 접근 권한을 부여하여 GitHub 앱 설치
- 비공개 리포지토리의 권한 확인
- GitHub 계정 권한 확인
- 앱에 풀 리퀘스트 쓰기 권한 부여
- 브랜치 보호 규칙 확인
- 앱 설치가 만료된 경우 재설치
- 조직 수준에서 설치되었는지 확인
- github.com/apps/cursor에서 재설치
- 설치가 손상된 경우 지원팀에 문의
다음 단계
GitHub 통합을 연결한 후 이를 사용하는 기능을 설정하세요: