GitHub에 personal access token으로 연결해 repository를 읽고 issues·pull requests를 관리하며 GitHub REST API로 자동화를 구축합니다.
GitHub API에 앱 연결하기
GitHub에 personal access token으로 연결해 repository를 읽고 issues·pull requests를 관리하며 GitHub REST API로 자동화를 구축하세요.
GitHub는 엔지니어링 팀을 위해 repository, issues, pull requests, CI 워크플로를 호스팅합니다. GitHub 커넥터는 Lovable 앱이 GitHub 계정의 personal access token으로 GitHub REST API를 호출하게 해줍니다. issue 대시보드, PR 트래커, 자동화 워크플로처럼 서버 코드에서 GitHub 데이터를 읽거나 업데이트하는 앱을 위해 설계되었습니다.
GitHub를 연결하면 앱은 다음 작업이 가능합니다.
- repository, 브랜치, 파일 내용 조회 및 읽기
- issues와 pull requests 생성 및 업데이트
- 커밋, 릴리스, 워크플로 실행 읽기
- GitHub 데이터 기반 내부 도구 및 자동화 구축
이 커넥터는 Lovable로 빌드하는 앱을 위한 것입니다. 앱이 GitHub REST API를 호출해 repository, issues, pull requests를 비롯한 GitHub 데이터를 읽고 업데이트할 수 있습니다. Lovable 프로젝트 코드를 GitHub로 내보내거나 양방향 동기화하려는 것이라면 GitHub Git sync를 사용하세요.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| issue 분류 보드 | GitHub를 사용해서 내 repository 전체의 열린 issues를 라벨별로 묶어 나열하는 대시보드를 만들어줘. | 앱을 벗어나지 않고 열린 작업 확인. 앱이 GitHub에서 issues를 읽어 필터링 가능한 보드에 표시합니다. |
| PR 상태 허브 | GitHub를 사용해서 열린 pull requests를 리뷰 상태·경과 시간과 함께 보여주는 페이지를 만들어줘. | 진행 중인 코드 리뷰를 관리자에게 실시간으로 제공. 앱이 pull requests를 가져와 지연되거나 막힌 리뷰를 강조합니다. |
| 릴리스 트래커 | GitHub를 사용해서 주요 repository의 최근 릴리스와 워크플로 결과를 나열하는 도구를 만들어줘. | GitHub 데이터로 출시 활동 추적. 앱이 릴리스와 Actions 메타데이터를 한 화면에 결합합니다. |
| repo 상태 대시보드 | GitHub를 사용해서 repository 통계와 열린 issue 수를 보여주는 관리자 페이지를 만들어줘. | repository 상태를 한눈에 모니터링. 앱이 GitHub API 응답을 요약 카드로 집계합니다. |
| 자동화 webhook 도우미 | GitHub를 사용해서 폼이 제출되면 issue를 생성하는 서버 엔드포인트를 만들어줘. | 앱 이벤트를 GitHub issue로 자동 변환. 앱이 입력을 검증하고 커넥터 게이트웨이를 통해 GitHub REST API를 호출합니다. |
| 기여자 활동 피드 | GitHub를 사용해서 팀 repository 전체의 최근 커밋과 pull requests를 보여주는 페이지를 만들어줘. | 최근 엔지니어링 활동을 이해관계자에게 한 화면으로 제공. 앱이 커밋과 pull requests를 가져와 repository나 작성자별로 묶습니다. |
GitHub 연결하기
워크스페이스 admin과 owner가 GitHub를 연결할 수 있습니다.
서로 다른 personal access token을 사용해 여러 GitHub 연결을 만들 수 있습니다. 환경을 분리하거나(예: 개발과 프로덕션) 서로 다른 권한 scope를 가진 token을 사용할 때 유용합니다.
연결이 생성되면 해당 워크스페이스의 모든 프로젝트에서 GitHub를 사용할 수 있습니다. 프로젝트에서 빌드하는 누구나 채팅으로 Lovable에게 프로젝트를 연결해달라고 요청할 수 있습니다.
사전 준비
GitHub를 연결하기 전에 다음을 준비하세요.
- GitHub 계정
- 앱이 호출할 엔드포인트에 맞는 권한을 가진 personal access token
- Lovable 워크스페이스 owner 또는 admin 역할
이 커넥터로 이루어지는 API 요청은 GitHub 계정의 rate limit에 포함됩니다. 할당량과 청구는 Lovable이 아닌 GitHub에서 처리합니다.
1단계: GitHub personal access token 생성
personal access token은 Lovable 앱이 사용자를 대신해 GitHub REST API에 인증하게 해줍니다.
GitHub personal access token 생성 방법.
GitHub token 설정 열기
GitHub에 로그인한 뒤 Settings → Developer settings → Personal access tokens를 엽니다.
token 생성
fine-grained 또는 classic token을 생성합니다. fine-grained token은 특정 repository로 제한할 수 있습니다. classic token은 repo나 public_repo 같은 scope 목록을 사용합니다.
권한 선택
앱에 필요한 권한만 부여합니다. private repository에는 repository 읽기 또는 쓰기 권한을 포함하세요. 공개 데이터만 다룬다면 classic token의 public_repo로 충분할 수 있습니다.
token 복사
GitHub가 token을 표시할 때 복사합니다. 다시 볼 수 없습니다.
personal access token은 비밀번호처럼 동작합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 GitHub 문서 Managing personal access tokens를 참고하세요.
2단계: GitHub를 Lovable에 연결
서로 다른 personal access token을 사용해 여러 연결을 만들 수 있습니다.
Connectors에서 GitHub 열기
Connectors → App connectors에서 GitHub를 선택합니다.
연결 추가
Add connection을 클릭합니다.
연결 구성
- Display name: 연결 이름을 지정합니다(예:
GitHub Prod). - Personal access token: 1단계에서 생성한 token을 붙여넣습니다.
이 연결에 접근할 사람 선택
Who can access this connection에서 워크스페이스의 누가 이 연결을 사용할 수 있는지 결정합니다.
- Only you(기본값): 연결을 만든 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가된 워크스페이스 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있습니다.
자세한 내용은 연결 수준 접근을 참고하세요.
연결
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 GitHub API로 token을 검증합니다.
연결되면 프로젝트에서 빌드하는 누구나(구성된 연결 수준 접근에 따라) 채팅으로 Lovable에게 프로젝트를 GitHub에 연결해달라고 요청할 수 있습니다. 이후 Lovable 앱은 커넥터 게이트웨이를 통해 repository, issues, pull requests를 비롯한 GitHub 리소스를 읽고 업데이트할 수 있습니다.
제한 사항
GitHub 커넥터는 다음을 할 수 없습니다.
- OAuth app이나 GitHub App 설치 플로 사용. 대신 personal access token을 사용하세요.
- Lovable 프로젝트 코드베이스를 백업하거나 동기화하는 GitHub Git sync 대체.
- 최종 사용자별 GitHub 로그인 지원. 각 연결은 그 연결에 링크된 모든 프로젝트가 공유하는 단일 GitHub 계정을 나타냅니다.
- token 권한이 다루지 않는 엔드포인트 호출. 호출이
403을 반환하면 token 권한을 업데이트하거나 더 넓은 scope를 가진 새 token을 생성하세요.
GitHub에서 personal access token을 취소하면, API 호출이 다시 성공하려면 새 token으로 연결을 업데이트하거나 새 연결을 만들어야 합니다.
GitHub 연결에서 프로젝트 연결 해제
Editor 이상 권한을 가진 사용자는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결 해제할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
연결 해제 방법.
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **GitHub**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects에서 연결 해제할 프로젝트를 선택합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 GitHub에 접근할 수 없습니다. 필요하면 다른 연결로 다시 연결할 수 있습니다.
GitHub 연결 삭제
워크스페이스 admin 또는 owner가 GitHub 연결을 삭제할 수 있습니다. 다른 멤버는 자신이 만들었거나 명시적으로 접근 권한을 부여받은 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며, 새 연결을 만들기 전까지 이 연결을 사용하던 앱은 동작을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 먼저 확인하세요.
삭제 방법.
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **GitHub**를 선택합니다.
연결 열기
삭제할 연결을 엽니다.
연결된 프로젝트 확인
Linked projects 섹션을 확인합니다.
삭제
Delete this connection에서 Delete를 클릭하고 확인합니다.