GitHub 계정으로 로그인하거나 personal access token으로 GitHub에 연결해 repository를 읽고 issues·pull requests를 관리하며 GitHub REST API로 자동화를 구축합니다.
GitHub API에 앱 연결하기
GitHub 계정으로 로그인하거나 personal access token으로 GitHub에 연결해 repository를 읽고 issues·pull requests를 관리하며 GitHub REST API로 자동화를 구축하세요.
GitHub는 엔지니어링 팀을 위해 repository, issues, pull requests, CI 워크플로를 호스팅합니다. GitHub API 커넥터는 Lovable 앱이 서버 코드에서 GitHub REST API를 호출하게 해줍니다. issue 대시보드, PR 트래커, 자동화 워크플로처럼 GitHub 데이터를 읽거나 업데이트하는 앱을 위해 설계되었습니다.
GitHub는 Lovable에서 두 가지 연결 유형으로 제공됩니다.
| 사용 방식 | 원하는 작업 |
|---|---|
| App + chat connector (이 페이지) | 공유 GitHub 연결을 채팅과 게시된 앱에서 사용 |
| App user connector | 게시된 앱의 각 사용자가 자신의 GitHub 계정을 연결해 자신의 repository, issues, pull requests로 작업 |
GitHub를 연결하면 앱은 다음 작업이 가능합니다.
- repository, 브랜치, 파일 내용 조회 및 읽기
- issues와 pull requests 생성 및 업데이트
- 커밋, 릴리스, 워크플로 실행 읽기
- GitHub 데이터 기반 내부 도구 및 자동화 구축
내부 엔지니어링 도구, 팀 대시보드, repository 관련 작업을 자동화하는 앱에 적합합니다.
이 커넥터는 Lovable로 빌드하는 앱에서 GitHub REST API를 호출합니다. Lovable 프로젝트 코드를 GitHub repository로 내보내거나 양방향 동기화하려는 것이라면 GitHub Git sync를 사용하세요.
주요 활용 사례 및 예시 앱
다음 예시는 GitHub로 만들 수 있는 앱을 시작용 프롬프트와 함께 보여줍니다.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| issue 분류 보드 | GitHub를 사용해서 내 repository 전체의 열린 issues를 라벨별로 묶어 나열하는 대시보드를 만들어줘. | 앱을 벗어나지 않고 열린 작업 확인. 앱이 GitHub에서 issues를 읽어 필터링 가능한 보드에 표시합니다. |
| PR 상태 허브 | GitHub를 사용해서 열린 pull requests를 리뷰 상태·경과 시간과 함께 보여주는 페이지를 만들어줘. | 진행 중인 코드 리뷰를 관리자에게 실시간으로 제공. 앱이 pull requests를 가져와 지연되거나 막힌 리뷰를 강조합니다. |
| 릴리스 트래커 | GitHub를 사용해서 주요 repository의 최근 릴리스와 워크플로 결과를 나열하는 도구를 만들어줘. | GitHub 데이터로 출시 활동 추적. 앱이 릴리스와 Actions 메타데이터를 한 화면에 결합합니다. |
| repo 상태 대시보드 | GitHub를 사용해서 repository 통계와 열린 issue 수를 보여주는 관리자 페이지를 만들어줘. | repository 상태를 한눈에 모니터링. 앱이 GitHub API 응답을 요약 카드로 집계합니다. |
| 피드백 issue 생성 폼 | GitHub를 사용해서 누군가 제출하면 GitHub issue를 생성하는 피드백 폼을 만들어줘. | 앱 이벤트를 GitHub issue로 자동 변환. 앱이 입력을 검증하고 GitHub REST API를 통해 issue를 생성합니다. |
| 기여자 활동 피드 | GitHub를 사용해서 팀 repository 전체의 최근 커밋과 pull requests를 보여주는 페이지를 만들어줘. | 최근 엔지니어링 활동을 이해관계자에게 한 화면으로 제공. 앱이 커밋과 pull requests를 가져와 repository나 작성자별로 묶습니다. |
GitHub API 연결하기
GitHub API 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 달라집니다. Free, Pro, Business 플랜에서는 앱 + 채팅 커넥터가 기본으로 제공됩니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 바꾸기 전까지 연결 및 클라이언트를 만들 수 있는 사용자의 기본값이 No one이기 때문입니다.
연결을 추가할 때 다음 두 가지 중에서 선택할 수 있습니다.
- GitHub: 한 번의 클릭으로 GitHub 계정에 로그인합니다(OAuth).
- Use your own credentials: GitHub에서 만든 personal access token으로 연결합니다.
서로 다른 GitHub 계정이나 token을 사용해 여러 GitHub API 연결을 만들 수 있습니다. 환경을 분리하거나(예: 개발과 프로덕션) 서로 다른 권한 scope를 사용할 때 유용합니다.
연결이 만들어지면 사용하려는 프로젝트에 연결을 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 채팅에서 Lovable에게 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 준비
GitHub API를 연결하기 전에 다음을 준비하세요.
- GitHub 계정
- GitHub로 로그인하는 대신 자체 자격 증명으로 연결하는 경우에만 필요한 personal access token
- Lovable 워크스페이스에서 연결을 만들 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
이 커넥터로 보내는 모든 API 요청은 GitHub 계정의 rate limit에 포함됩니다. 청구와 할당량은 Lovable이 아닌 GitHub에서 직접 처리합니다.
GitHub를 연결하려는 방식에 따라 아래 설정 단계를 따르세요.
가장 빠르게 설정하려면 이 옵션을 선택하세요. GitHub 계정으로 Lovable을 인가하므로 personal access token이 필요하지 않습니다. 연결 양식에서 이 옵션은 GitHub로 표시됩니다.
Connectors에서 GitHub API 열기
Connectors를 열고 GitHub API를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.
GitHub API를 처음 열면 Lovable이 무엇을 하려는지 묻습니다. Use the connector를 선택하세요. 다른 옵션인 Sync my code는 대신 GitHub Git sync를 설정합니다.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다.
연결 이름 지정
Display name에 연결 이름을 입력합니다(예: GitHub Prod). 이 이름은 Lovable 안에서 연결을 식별하는 데만 사용됩니다.
GitHub 인증 선택
Authentication에서 GitHub를 선택합니다. OAuth 옵션입니다.
Scope 검토(선택)
Scopes에서 앱이 요청하는 권한을 검토합니다. Read user profile은 항상 포함되며 Repositories는 기본으로 선택되어 있습니다.
| Scope | 설명 | 기본값 |
|---|---|---|
Read user profile (read:user) | 인증된 사용자의 프로필 데이터 읽기 | 필수 |
Repositories (repo) | 코드, issues, pull requests를 포함한 공개·비공개 repository 전체 접근 | On |
Public repositories (public_repo) | 공개 repository로 제한된 접근 | Off |
Workflows (workflow) | GitHub Actions 워크플로 파일 업데이트 | Off |
Gists (gist) | gist 생성 및 관리 | Off |
Notifications (notifications) | 알림 표시 및 스레드 접근 | Off |
Email (user:email) | 인증된 사용자의 이메일 주소 읽기 | Off |
Read organizations (read:org) | 조직 및 팀 멤버십 읽기 | Off |
Projects (project) | 프로젝트 전체 제어 | Off |
전체 scope 문서는 Scopes for OAuth apps를 참고하세요.
이 연결을 사용할 사람 선택
Sharing에서 워크스페이스 내 누가 이 연결을 사용할 수 있는지 정합니다. 새 연결은 기본적으로 본인에게만 비공개이며 Private 라벨이 표시됩니다.
- Private(기본값): 접근 목록을 그대로 두면 본인만 연결과 관련 데이터를 사용할 수 있습니다.
- Share with others: 이메일로 워크스페이스 멤버를 추가합니다. 본인과 추가한 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
GitHub에 연결 및 인가
Connect를 클릭합니다. GitHub 인가 창이 열리므로 브라우저가 팝업을 차단하지 않는지 확인하세요. 팝업이 차단되면 Lovable이 대신 리디렉션합니다.
요청이 표시되면 GitHub에 로그인하고, 요청된 권한을 검토한 뒤 앱을 인가합니다.
확인과 함께 Lovable로 돌아옵니다.
사용할 token을 정확히 제어하거나, fine-grained token으로 특정 repository로 제한하거나, 교체를 직접 관리하고 싶다면 personal access token을 사용하세요.
1단계: GitHub personal access token 생성
personal access token은 Lovable 앱이 token을 소유한 GitHub 계정으로 GitHub REST API에 인증하게 해줍니다.
GitHub personal access token 생성 방법.
GitHub token 설정 열기
GitHub에 로그인한 뒤 Settings → Developer settings → Personal access tokens를 엽니다.
token 생성
fine-grained 또는 classic token을 생성합니다. Lovable integration처럼 알아보기 쉬운 이름을 붙이세요. fine-grained token은 특정 repository로 제한할 수 있습니다. classic token은 repo나 public_repo 같은 scope 목록을 사용합니다.
권한 선택
앱에 필요한 권한만 부여합니다. private repository에는 repository 읽기 또는 쓰기 권한을 포함하세요. 공개 데이터만 다룬다면 classic token의 public_repo로 충분할 수 있습니다.
token 복사
GitHub가 token을 표시할 때 복사해 안전하게 보관합니다. GitHub는 token을 다시 표시하지 않습니다.
personal access token은 비밀번호처럼 동작합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 GitHub 문서 Managing personal access tokens를 참고하세요.
2단계: GitHub API를 Lovable에 연결
token이 준비되면 Lovable에서 연결을 추가합니다. 서로 다른 personal access token을 사용해 여러 연결을 만들 수 있습니다.
Connectors에서 GitHub API 열기
Connectors를 열고 GitHub API를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.
GitHub API를 처음 열면 Lovable이 무엇을 하려는지 묻습니다. Use the connector를 선택하세요. 다른 옵션인 Sync my code는 대신 GitHub Git sync를 설정합니다.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다.
연결 이름 지정
Display name에 연결 이름을 입력합니다(예: GitHub Prod). 이 이름은 Lovable 안에서 연결을 식별하는 데만 사용됩니다.
자체 자격 증명 선택
Authentication에서 Use your own credentials를 선택합니다. 그런 다음 1단계에서 만든 token을 Personal access token에 붙여넣습니다.
이 연결을 사용할 사람 선택
Sharing에서 워크스페이스 내 누가 이 연결을 사용할 수 있는지 정합니다. 새 연결은 기본적으로 본인에게만 비공개이며 Private 라벨이 표시됩니다.
- Private(기본값): 접근 목록을 그대로 두면 본인만 연결과 관련 데이터를 사용할 수 있습니다.
- Share with others: 이메일로 워크스페이스 멤버를 추가합니다. 본인과 추가한 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 GitHub API로 token을 검증합니다.
연결되면 프로젝트에서 빌드하는 누구나(구성된 연결 수준 접근에 따라) 채팅으로 Lovable에게 프로젝트를 GitHub API에 연결해달라고 요청할 수 있습니다. 이후 Lovable 앱은 repository, issues, pull requests를 비롯한 GitHub 리소스를 읽고 업데이트할 수 있습니다.
제한 사항
이 페이지에서 설명하는 GitHub API 앱 + 채팅 커넥터는 다음을 할 수 없습니다.
- Lovable 프로젝트 코드베이스를 내보내거나 동기화하는 GitHub Git sync 대체
- GitHub App 설치 token 사용. 연결은 OAuth 로그인이나 personal access token으로 하나의 GitHub 계정으로서 인증합니다.
- 부여된 scope나 token 권한이 다루지 않는 엔드포인트 호출. 호출이
403을 반환하면 연결의 OAuth scope나 personal access token의 권한을 검토하세요. - 최종 사용자별 GitHub 로그인 지원. 각 연결은 그 연결에 링크된 모든 프로젝트가 공유하는 단일 GitHub 계정을 나타냅니다. 앱의 각 사용자가 자신의 GitHub 계정으로 로그인해야 한다면 GitHub app user 커넥터를 사용하세요.
GitHub 쪽에서 GitHub 인가를 취소하면 API 호출이 다시 성공하기 전에 Lovable에서 통합을 다시 연결해야 합니다. personal access token이 만료되거나 취소되면 Lovable에서 연결의 token을 업데이트하세요.
GitHub API 연결 관리
연결은 Connectors에서 관리합니다. **GitHub API**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 GitHub API 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, GitHub API을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.