GitHub AI 커넥터

이 참조 문서에 있는 내용

Notion AI에서 GitHub 지식을 활용하는 방법을 알아보세요. 🤖

자주 묻는 질문(FAQ)으로 이동

참고: 이 기능은 비즈니스 및 엔터프라이즈 요금제에서만 사용할 수 있습니다.

Notion AI에 GitHub 연결하기

어떤 사용자가 GitHub를 Notion AI에 연결할 수 있나요?

GitHub 조직 소유자이면서 동시에 Notion 워크스페이스 소유자여야 합니다.
비즈니스 또는 엔터프라이즈 요금제로 워크스페이스를 사용하고 있어야 하며, 멤버가 2명 이상이어야 합니다.

워크스페이스에 GitHub AI 커넥터가 설정되면 멤버는 API 통합을 사용하여 답변을 검색할 수 있습니다.

공개 리포지토리: 소유자가 초기 커넥터를 설정한 후에는 추가 인증이 필요하지 않습니다.
비공개 리포지토리: 각 멤버는 사용 권한을 확인하기 위해 GitHub에 로그인/인증해야 합니다.

GitHub를 연결하려면 어떻게 해야 하나요?

GitHub를 Notion AI에 연결하는 방법은 두 가지가 있습니다. GitHub 조직을 연결하려면 워크스페이스 소유자이자 GitHub 소유자여야 합니다. 비공개 리포지토리를 연결하려면 워크스페이스 멤버여야 합니다.

Notion 워크스페이스 소유자이면서 GitHub 소유자인 경우

GitHub를 Notion 워크스페이스에 연결하는 방법은 다음과 같습니다.

설정 → Notion AI로 이동하세요.
GitHub 옆에 있는 +를 선택하세요.
GitHub로 이동하게 됩니다. 올바른 GitHub 계정으로 로그인했는지 확인하세요. 설정을 진행하는 동안 Notion 창을 닫지 마세요!
열리는 페이지에서 GitHub에 연결하고 동기화할 조직을 선택하세요. 개인 GitHub 리포지토리를 연결하려면 먼저 조직을 만든 다음 리포지토리를 조직으로 옮겨야 합니다.
모든 리포지토리(권장) 또는 리포지토리 선택을 선택한 다음 설치를 선택하세요.
Notion으로 돌아가세요.

API 통합이 설정되면 API는 API 설정이 완료된 시점을 기준으로 PR 및 이슈를 색인화할 수 있습니다. 시간 제한 없이 markdown 파일과 READMe를 포함한 모든 코드 파일에 접근할 수 있습니다.

참고: 현재 Wiki 및 포크 저장소는 지원되지 않습니다.

연결이 완료되는 데 최대 72시간이 소요될 수 있습니다. 이후 Notion 워크스페이스의 각 사용자는 API 통합을 사용하기 위해 GitHub에서 개별적으로 인증해야 하며, 그러면 해당 사용자의 권한이 매핑됩니다.

Notion 워크스페이스 멤버인 경우

Notion 워크스페이스 또는 GitHub 조직의 소유자가 아닌 경우, API 통합을 사용하기 전에 먼저 Notion을 GitHub에 연결할 소유자가 필요합니다. 소유자가 API 통합을 설정한 후 개인 리포지토리를 연결하려면 로그인해야 합니다. 방법은 다음과 같습니다.

Notion에서 화면 하단의 Notion AI를 열고 ••• → Github 연결을 클릭합니다.
로그인 을 선택하고 GitHub 계정을 연결합니다.

GitHub의 어떤 콘텐츠를 Notion AI에 연결할 수 있나요?

워크스페이스에 AI 커넥터가 설정되면 코드, PR, 이슈, 파일 및 README를 인덱싱할 수 있습니다.

각 사용자는 Notion AI 사용 시 GitHub에서 사용 권한이 있는 콘텐츠만 검색하고 볼 수 있습니다. Notion AI는 PR에서 지난 1년간의 정보를 검색할 수 있습니다.

GitHub용 Notion AI 커넥터는 어디에서 사용할 수 있나요?

다음 위치에서 Notion AI 커넥터를 통해 GitHub를 검색할 수 있습니다.

Notion 오른쪽 하단의 Notion AI 채팅
홈상단의 Notion AI 위젯
사이드바 내 검색

채팅과 홈에서 모든 출처 토글을 열고 GitHub를 선택하면 검색 범위를 GitHub로 좁힐 수 있습니다. Notion AI 검색 결과를 필터링하여 GitHub의 정보만 표시할 수도 있습니다.

모범 사례 및 예시 명령어

GitHub AI 커넥터는 다음 작업에 활용할 수 있습니다.

최근 변경 사항 및 프로젝트 업데이트에 대해 문의하기,
코드 구현 찾기,
이슈 및 이슈 상태 찾기,
이슈 디버깅 작업 시 가장 유용합니다. 예를 들어, 기능이 작동되지 않거나 오류가 발생할 때 최근 PR을 읽어 맥락을 가져올 수 있습니다.
보안 패턴 찾기에도 유용합니다.

Notion AI에 다음과 같은 명령어를 입력해 보세요.

'{프로젝트명} 프로젝트의 최신 동향은 무엇인가요?'
'지난주에 어떤 풀 리퀘스트를 작업했나요?'
'본사의 인증 시스템에 대한 최근 변경 사항은 무엇인가요?'
'코드베이스에서 오류 처리를 적용하는 방법의 예시를 보여주세요.'
'프론트 엔드 구성 요소에 사용되는 주요 종속성은 무엇인가요?'
'데이터베이스 마이그레이션 함수의 구현을 찾아 주세요.'
'API 엔드포인트에 어떤 보안 패턴을 사용하고 있나요?'

더 알아보기

자주 묻는 질문(FAQ)

잘못된 Notion 워크스페이스를 연결했습니다. Github 리포지토리 연결을 해제하려면 어떻게 해야 하나요?

워크스페이스 소유자는 최초 API 통합이 완료된 후 설정 → Notion AI로 이동하여 채널 연결을 해제하거나 편집할 수 있습니다. GitHub 옆에 있는 ⚙️ 아이콘 선택 → 설정 → 연결 해제.

API 통합이 완료되려면 얼마나 걸리나요?

리포지토리 및 GitHub 요금제 유형에 따라 API 통합을 설정하는 데 최대 72시간이 소요될 수 있습니다.

GitHub의 새로운 콘텐츠가 Notion AI에 반영되려면 얼마나 걸리나요?

초기 설정 후 30분마다 새 데이터를 인덱싱합니다.

제 Notion 워크스페이스의 모든 사용자가 GitHub의 정보에 접근할 수 있나요?

워크스페이스의 멤버가 GitHub에서 이미 사용 권한이 있는 개인 리포지토리의 정보를 검색려면 개별적으로 인증 및 로그인해야 합니다.

GitHub에서 얼마나 오래된 내용까지 질문할 수 있나요?

리포지토리에서 최대 1년 치 PR 및 이슈를 검색할 수 있습니다. 모든 READM는 시간 제한 없이 사용할 수 있습니다.

Notion AI가 무엇에 액세스할 수 있나요?

온보딩 과정에서 연결하려는 GitHub 조직을 선택한 후 Notion AI가 다음에 접근할 수 있는지 여부를 선택할 수 있습니다.

모든 리포지토리: 리소스 소유자가 소유한 모든 현재 및 향후 리포지토리에 적용됩니다. 공용 리포지토리(읽기 전용)도 포함됩니다.
선택한 속성만: 리포지토리를 하나 이상 선택합니다. 공용 리포지토리(읽기 전용)도 포함됩니다.

Notion AI 커넥터는 기존 Notion AI 권한을 그대로 유지하나요?

물론입니다. Notion AI는 기존 Notion AI 보안 관리에 따라 기존 권한을 그대로 유지합니다. 사용자는 사용 권한이 없는 제3자 리소스를 기반으로 콘텐츠를 생성하거나 Notion AI 응답을 받을 수 없습니다.

제3자 콘텐츠의 경우, Notion AI는 보안을 염두에 두고 비공개 콘텐츠와 공개 콘텐츠를 처리하며 GitHub과 Notion 사용자 간의 권한 매핑에 따라서만 콘텐츠를 수집합니다.

Notion AI는 사용 권한 매핑을 어떻게 처리하나요?

사용자는 Notion AI에서 개인적으로 GitHub 내에서 접근 권한이 있는 GitHub 콘텐츠(예: 코드, PR, 이슈)만 볼 수 있습니다. 누군가가 GitHub에서 접근할 수 없는 리포지토리를 쿼리하려고 하더라도 Notion AI는 해당 리포지토리의 결과를 반환하지 않습니다.

사용자 수준에서 이 앱을 인증하려면 GitHub와 Notion 두 곳 모두의 멤버여야 합니다.
사용자는 Notion과 GitHub에서 동일한 이메일 주소를 사용할 필요가 없습니다.
권한은 이메일 주소의 비교가 아닌 각 사용자의 GitHub 계정 인증 성공 여부를 기반으로 매핑됩니다. Notion AI는 이메일 일치 여부가 아닌 OAuth 로그인을 기반으로 신원과 권한 범위를 확인합니다.
매 시간마다 GitHub의 권한을 동기화하여 Notion의 권한을 업데이트합니다.

Notion은 시스템에서 내 GitHub 데이터를 어떻게 저장하거나 참조하나요?

핵심 Notion AI 제품과 유사하게 우리는 Turbopuffer이 호스팅하는 벡터 데이터베이스에서 임베딩을 생성 및 저장하여 제3자 콘텐츠(예: GitHub)를 활용하는 질문의 답변을 제공할 수 있는 기능을 강화합니다. Turbopuffer는 Notion의 보안 팀과 외부 감사 기관이 심사한 결과 SOC2 Type II 인증서를 획득했습니다. 여기에서 Turbopuffer의 보안에 관해 자세히 알아보세요 →