Notion에 GitHub 연결하기
Notion에서 팀의 프로젝트 계획과 함께 풀 리퀘스트를 관리하세요.
관리형 GitHub 동기화를 사용하면 선택한 리포지토리에서 GitHub 풀 리퀘스트 데이터베이스가 생성됩니다. Notion은 기존 풀 리퀘스트를 가져오고 백그라운드에서 GitHub 업데이트를 확인합니다.
이 가이드는 GitHub 연결 설정의 데이터베이스 동기화를 다룹니다. 동기화된 속성은 읽기 전용입니다. 풀 리퀘스트 변경은 GitHub에서 수행하세요.
참고: 이 GitHub 통합은 기존 버전을 대체합니다. 외부 데이터를 최신 상태로 유지하려면 2026년 10월 30일까지 새 동기화를 설정하세요. 기존에 동기화된 데이터베이스는 Notion에 그대로 유지되지만, 해당 날짜 이후에는 업데이트가 중단됩니다.
GitHub 앱 설치를 통해 제공되는 여러 리포지토리에서 풀 리퀘스트를 동기화할 수 있습니다. 선택한 리포지토리는 하나의 Notion 데이터베이스로 통합됩니다.
정보 | 속성 |
|---|---|
풀 리퀘스트 | 제목, PR 번호, GitHub URL, 리포지토리 |
주 | 상태: 열림, 초안, 병합됨, 또는 닫힘 |
작성자 | 작성자(GitHub) 및 일치하는 Notion 멤버를 찾을 수 있는 경우의 작성자 |
조직 | 라벨, 베이스 브랜치, 헤드 브랜치 |
날짜 | 생성일, 업데이트일, 종료일, 병합일 |
작성자(GitHub) 속성에는 GitHub 사용자 이름이 포함됩니다. 작성자는 작성자의 공개 이메일이 워크스페이스 멤버와 일치할 때 Notion 사용자 속성으로 표시됩니다.
설명 속성은 GitHub에 작성된 그대로의 풀 리퀘스트 설명을 일반 텍스트로 동기화합니다. 마크다운으로 렌더링되지 않습니다.
이 동기화에는 GitHub 이슈, 댓글, 담당자 또는 사용자 리뷰 세부 정보는 포함되지 않습니다.
필요한 항목:
Notion 워크스페이스 멤버십.
동기화하려는 리포지토리에 사용 권한이 있는 GitHub 계정.
해당 리포지토리에 사용 권한이 있는 GitHub 앱 설치.
비즈니스 요금제(모바일 비즈니스 포함). GitHub 동기화는 다른 요금제에서는 사용할 수 없습니다.
GitHub 계정과 앱 설치 모두 사용 권한이 필요합니다. GitHub 조직의 경우 담당자가 앱을 승인하거나 설치해야 할 수도 있습니다.
Notion에서 설정 → 연결 → GitHub로 이동하세요.
데이터베이스 동기화를 열고 아직 연결하지 않았다면 GitHub 계정을 연결하세요.
GitHub의 인증 및 설치 단계를 완료하세요.
동기화할 저장소가 있는 조직이나 계정을 선택하세요. 다른 설치를 추가해야 하는 경우 조직 추가…를 사용하세요.
포함할 저장소를 선택하세요.
사용 가능한 모든 기록 또는 특정 기록 기간을 선택하세요.
동기화 생성을 선택하세요.
Notion은 개인 페이지 사이드바 섹션에 GitHub 풀 리퀘스트를 생성하고 일치하는 풀 리퀘스트를 가져오기 시작합니다.
팁: 리포지토리가 보이지 않나요? GitHub의 Manage access(액세스 관리)를 사용하여 앱이 액세스할 수 있는 리포지토리를 확인하세요. 설치 시 승인이 필요한 경우, GitHub 조직 소유자에게 승인을 요청하세요.
첫 번째 가져오기 중에 Notion은 선택한 각 리포지토리에서 가장 최근에 업데이트된 녹음부터 시작하여 선택한 기록 내의 풀 리퀘스트를 읽어옵니다.
가져오기가 완료되면 Notion은 정기적으로 각 저장소에서 새 풀 리퀘스트와 업데이트된 풀 리퀘스트를 확인합니다. 새 라벨, 닫힌 풀 리퀘스트, 병합과 같은 변경 사항은 Notion의 해당 속성을 업데이트합니다.
Notion을 닫아도 동기화는 계속 실행됩니다. 대규모 저장소, GitHub 요청 제한, 일시적인 서비스 문제로 인해 업데이트가 지연될 수 있습니다. 동기화 상태를 확인하여 진행 상황이나 오류를 확인하세요.
모든 기록, 최근 30일, 최근 90일 또는 최근 365일을 선택하세요. 모든 기록 동기화가 토글로 제공되는 경우, 사용 가능한 모든 기록 동기화를 켜두어 사용 가능한 모든 풀 리퀘스트를 포함하세요.
이 기간은 풀 리퀘스트의 업데이트 시간을 기준으로 합니다. 풀 리퀘스트가 생성된 시점이나 열림, 닫힘, 병합 여부와는 관계가 없습니다.
예를 들어, 90일 넘게 변경되지 않은 열린 풀 리퀘스트는 90일 기간에서 제외될 수 있습니다.
팁: 오래된 페이지는 삭제할 수 있습니다. 풀 리퀘스트가 선택한 기간을 벗어나면 해당 페이지는 사용자가 Notion 속성에 입력한 값을 포함하여 동기화된 데이터베이스에서 삭제됩니다. 변경되지 않은 풀 리퀘스트를 유지해야 하는 경우 사용 가능한 모든 기록을 사용하세요.
설정 → 연결 → GitHub → 데이터베이스 동기화에서 동기화를 여세요.
저장소 추가: 선택 항목을 편집하고 변경 사항 저장을 선택하세요. Notion이 추가된 저장소에서 일치하는 풀 리퀘스트를 가져옵니다.
저장소 제거: 선택을 해제하고 저장하세요. 동기화된 풀 리퀘스트 페이지가 Notion에서 제거됩니다.
변경 기록: 기간을 길게 설정하면 더 많은 녹음이 가져와집니다. 기간을 짧게 설정하면 새 기간 범위를 벗어나는 녹음이 제거됩니다.
업데이트 일시정지:동기화 일시정지를 선택하세요.
업데이트 재개: 동기화를 계속하려면 동기화 재개를 선택하세요.
저장소를 제거하거나 기록을 단축하기 전에, 영향을 받는 페이지에서 필요한 Notion 전용 정보를 보관해 두세요.
저장소, 상태, 작성자 또는 레이블별로 보기를 만드세요. 나만의 속성을 추가하여 릴리스 준비 상태를 추적하거나 풀 리퀘스트를 팀의 계획 프로세스와 연결할 수 있습니다. 사용자가 추가한 속성 값은 Notion에 유지됩니다.
GitHub 속성을 변경하려면 GitHub URL을 사용하여 풀 리퀘스트를 열고 GitHub에서 변경하세요.
데이터베이스는 처음에 개인 페이지로 시작됩니다. 데이터베이스를 공유하면 Notion의 공유 설정에 따라 가져온 데이터를 볼 수 있는 사용자가 결정됩니다. 뷰어마다 출처 리포지토리에 대한 사용 권한이 필요한 것은 아니므로, 개인 페이지 리포지토리 정보를 공유하기 전에 데이터베이스의 권한을 검토하세요.
조직이나 저장소를 찾을 수 없습니다
올바른 GitHub 계정과 앱 설치를 선택했는지 확인하세요. 계정과 앱 모두에 저장소 사용 권한이 있는지 확인하세요. 조직에서 앱 설치를 제한하는 경우, 담당자에게 사용 권한 승인을 요청하세요.
저장소 이름이 변경되었거나 저장소가 이동되었습니다
동기화의 저장소 설정을 열고 저장소 선택을 검토한 후 다시 저장하세요. 다른 조직으로 이동한 경우, 새 위치에서 연결에 대한 사용 권한이 있는지 확인하세요.
작성자 속성이 비어 있습니다
GitHub 사용자 이름에 Notion 워크스페이스 멤버와 일치하는 공개 이메일이 항상 있는 것은 아닙니다. 사람 속성이 비어 있을 때 작성자를 식별하려면 작성자 (GitHub)을 사용하세요. 작성자의 이메일이나 워크스페이스 멤버십이 변경되어도 이전의 동기화된 풀 리퀘스트는 자동으로 새로고침되지 않을 수 있습니다.
풀 리퀘스트가 누락되었습니다
해당 리포지토리가 선택되었는지, 마지막 업데이트가 기록 기간 내에 있는지, Notion 보기에서 필터링되고 있지 않은지 확인하세요. 첫 번째 가져오기가 아직 진행 중일 수 있습니다.
데이터베이스 업데이트가 중단되었습니다
동기화 상태 세부 정보를 확인하세요. 메시지가 표시되면 GitHub 계정을 다시 연결하거나 리포지토리 사용 권한을 복원하세요. GitHub 요청 제한 및 일시적인 중단으로 인해 Notion이 재시도하는 동안 업데이트가 지연될 수 있습니다.
Workers와의 비교 및 공유 문제 해결 지침은 다른 도구에서 Notion으로 데이터 동기화 →를 참조하세요.
