GitHubBot

처음 사용하는 분을 위해

이 순서대로 연결해 주세요

Discord 앱 하나, GitHub 토큰 하나면 준비할 수 있어요.
설정을 마치면 다른 저장소도 같은 봇에 추가할 수 있어요.

1

Discord 앱을 만들어 주세요

  1. Discord Developer Portal에서 New Application을 눌러 주세요.
  2. General Information → Application ID를 복사해 주세요.
  3. OAuth2 → Client Secret을 확인해 주세요.
  4. Bot → Reset Token으로 Bot Token을 발급해 주세요.
  5. Bot 메뉴에서 Message Content Intent를 켜 주세요.
  6. OAuth2의 Redirects에 아래 주소를 추가해 주세요.

Client Secret과 Bot Token은 서로 다른 값이에요. 각각 해당 항목에 입력해 주세요.

2

앱 정보를 입력해 주세요

처음 연결하기에서 초기 설정 키로 관리자 확인을 마친 뒤, 방금 준비한 앱 정보 세 가지를 입력해 주세요.

Discord의 사용자 설정 → 고급 → 개발자 모드를 켜고, 연결할 서버를 우클릭해 서버 ID 복사를 선택해 주세요. 서버가 여러 개라면 쉼표로 구분해 입력하면 돼요.

초기 설정 키는 어디에 있나요?

설치 담당자가 전달한 링크나 키를 사용해 주세요. 직접 설치했다면 환경 설정의 SETUP_TOKEN 값이에요. 운영 서버에서는 설치 담당자가 환경 파일에서 확인할 수 있어요.

3

서버에 봇을 초대해 주세요

앱 정보를 저장한 뒤 Discord로 시작하기로 로그인하고 봇 초대하기를 눌러 주세요. 연결할 서버의 관리 권한이 필요해요.

서버에는 이슈용 포럼과 알림용 텍스트 채널을 준비해 주세요. 커밋·PR 알림과 CI/CD 알림은 같은 채널을 사용해도 돼요.

포럼 채널을 만들 수 없다면 Discord 서버 설정에서 커뮤니티 기능을 먼저 활성화해 주세요.

4

GitHub 접근 토큰을 만들어 주세요

Fine-grained token 만들기에서 저장소 소유자를 선택하고, 사용할 저장소만 허용해 주세요. Repository permissions는 아래처럼 설정해 주세요.

권한설정
Issues · Pull requests · Contents · ActionsRead and write
Metadata · Checks · Deployments · Commit statusesRead
WebhooksRead and write

웹훅을 직접 등록한다면 Webhooks 권한은 생략할 수 있어요. 조직 저장소는 관리자의 토큰 승인이 필요할 수 있어요.

GitHub에 남는 작업 계정은 토큰 소유자예요. 봇이 작성한 본문에는 Discord 작성자를 함께 기록해요.

5

저장소와 채널을 연결해 주세요

  1. 로그인한 웹 화면에서 서버를 선택하고 저장소 연결을 눌러 주세요.
  2. 소유자/저장소 이름과 GitHub 토큰을 입력해 주세요.
  3. 이슈 포럼, 커밋·PR 채널, CI/CD 채널을 선택해 주세요.
  4. 태그와 운영 역할을 정한 뒤 저장해 주세요.
  5. GitHub 웹훅 연결을 눌러 주세요. 토큰 소유자의 저장소 관리자 권한이 필요해요.
  6. 기존 이슈가 있다면 열린 이슈 가져오기를 눌러 주세요.

다른 프로젝트도 저장소 연결을 추가하면 돼요. 각 프로젝트에 서로 다른 포럼·채널·토큰·역할을 지정할 수 있어요.

6

첫 이슈로 확인해 보세요

  1. 연결한 포럼에 글을 쓰고 GitHub 이슈가 생기는지 확인해 주세요.
  2. 중요도를 고르지 않았다면 자동으로 붙은 P0~P3 태그와 요약 카드의 선택 이유를 확인해 주세요.
  3. 포럼 답글이 GitHub 댓글에도 보이는지 확인해 주세요.
  4. P1 · 높음 태그를 추가해 중요도가 바뀌는지 확인해 주세요. 직접 고른 중요도가 우선이에요.
  5. GitHub에서 이슈를 닫고 포럼의 완료 태그를 확인해 주세요.
  6. Discord에서 /github help로 명령어를 확인해 주세요.

자동 중요도는 제목과 본문으로 판단해요. 별도 AI 키는 필요 없으며, 이슈 내용을 외부 AI 서비스로 보내지 않아요.

연결이 멈췄다면 웹의 처리 기록과 채널 권한을 확인해 주세요. 실패한 작업은 기록에서 다시 시도할 수 있어요.