GitHub용 Notion AI 커넥터

Notion AI에 GitHub를 연결하려면 다음 조건을 충족해야 합니다.

• GitHub 조직 소유자이면서 동시에 Notion 워크스페이스 소유자여야 합니다.

• 비즈니스 또는 엔터프라이즈 요금제로 워크스페이스를 사용하고 있어야 하며, 멤버가 2명 이상이어야 합니다.

연결이 완료되면 Notion 워크스페이스의 멤버는 사용 권한이 있는 리포지토리에 액세스하기 위해 로그인해야 합니다.

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

1. 설정 → Notion AI로 이동하세요.

2. GitHub 옆에 있는 +를 선택하세요.

   

3. GitHub로 이동하게 됩니다. 올바른 GitHub 계정으로 로그인했는지 확인하세요. 설정을 진행하는 동안 Notion 창을 닫지 마세요!

   

4. 열리는 페이지에서 GitHub에 연결하고 동기화할 조직을 선택하세요. 개인 GitHub 리포지토리를 연결하려면 먼저 조직을 만든 다음 리포지토리를 조직으로 옮겨야 합니다.

5. 모든 리포지토리(권장) 또는 리포지토리 선택을 선택한 다음 설치를 선택하세요.

6. Notion으로 돌아가세요.

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

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

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

1. Notion에서 화면 하단의 Notion AI를 열고 ••• → Github 연결을 클릭합니다.

2. 로그인 을 선택하고 GitHub 계정을 연결합니다.

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

GitHub AI 커넥터는

• 최근 변경 사항 및 프로젝트 업데이트에 대해 문의하기,

• 코드 구현 찾기,

• 이슈 및 이슈 상태 찾기,

• 이슈 디버깅 작업 시 가장 유용합니다. 예를 들어, 기능이 작동되지 않거나 오류가 발생할 때 최근 PR을 읽어 맥락을 가져올 수 있습니다.

• 보안 패턴 찾기에도 유용합니다.

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

• "{프로젝트명} 프로젝트의 최신 동향은 무엇인가요?"

• "지난주에 어떤 풀 리퀘스트를 작업했나요?"

• "본사의 인증 시스템에 대한 최근 변경 사항은 무엇인가요?"

• "코드베이스에서 오류 처리를 적용하는 방법의 예시를 보여주세요."

• "프론트 엔드 구성 요소에 사용되는 주요 종속성은 무엇인가요?"

• "데이터베이스 마이그레이션 함수의 구현을 찾아 주세요."

• "API 엔드포인트에 어떤 보안 패턴을 사용하고 있나요?"

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

• Notion 오른쪽 하단의 Notion AI 채팅

• 홈상단의 Notion AI 위젯

• 사이드바 내 검색

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

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

GitHub를 Notion AI에 처음 연결할 때는 Notion 워크스페이스 소유자이면서 동시에 GitHub 조직 소유자여야 합니다. 연결이 완료되면 Notion 워크스페이스의 멤버는 사용 권한이 있는 리포지토리에 액세스하기 위해 로그인해야 합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

GitHub용 Notion AI는 GitHub 멤버를 Notion 멤버에 매핑합니다. 사용자 수준에서 이 앱을 인증하려면 GitHub와 Notion 두 곳 모두의 멤버여야 합니다. 매 시간마다 GitHub의 권한을 동기화하여 Notion의 권한을 업데이트합니다.

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

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