Discord 봇 토큰과 웹훅 URL은 어디서 가져오나

Discord를 자동화하려면 결국 봇 토큰이나 웹훅 URL이 필요합니다.

MCP로 쓸 수 있는 서비스도 있지만, Discord는 직접 개발자 포털에서 값을 가져와야 하는 경우가 많습니다. 이 글은 그 과정을 통째로 정리한 가이드입니다.

무엇을 가져와야 하나

Discord 연동에는 두 가지 키가 있습니다.

• Bot Token: 봇이 메시지를 읽고 쓰거나, 길드 정보를 조회할 때 사용합니다.
• Webhook URL: 특정 채널로만 메시지를 전송할 때는 이 URL 하나로 충분합니다.

상황에 따라 둘 중 하나만 써도 되고, 둘 다 써도 됩니다.

봇 토큰 발급하기

1. Discord Developer Portal에 로그인합니다.
2. 오른쪽 위 New Application을 누르고 이름을 입력한 뒤 Create합니다.
3. 왼쪽 메뉴에서 Bot을 선택하고 Add Bot → **Yes, do it!**를 누릅니다.
4. Token 아래 Reset Token을 누르고, 생성된 문자열을 복사합니다.
5. 메시지 내용을 읽어야 한다면 Privileged Gateway Intents 섹션에서 MESSAGE CONTENT INTENT를 켜줍니다.

이제 이 토큰으로 Discord API를 호출할 수 있습니다.

봇을 서버에 초대하기

토큰만으로는 서버에 들어가지 못합니다. 초대 링크를 만들어야 합니다.

1. 왼쪽 메뉴 OAuth2 → URL Generator로 갑니다.
2. Scopes에서 bot을 체크합니다.
3. Bot Permissions에서 필요한 권한을 선택합니다. 예를 들어 메시지를 전송할 때는 Send Messages, 메시지를 읽을 때는 Read Message History가 필요합니다.
4. 하단에 생성된 URL을 복사해서 브라우저에 붙여넣으면 됩니다.
5. 대상 서버와 채널을 선택하고 Authorize합니다.

웹훅 URL 만들기

특정 채널에만 알림을 전송할 때는 웹훅이 더 간단합니다.

1. Discord 서버에서 대상 채널의 톱니바퀴 아이콘을 누릅니다.
2. Integrations → Webhooks → New Webhook을 누릅니다.
3. 웹훅 이름과 채널을 확인하고 Copy Webhook URL을 누릅니다.

이 URL에 POST 요청을 전송하면 채널로 메시지가 갑니다.

정리하면

값	언제 필요한가	발급 위치
Bot Token	봇이 주도적으로 행동할 때	Developer Portal → Bot
OAuth2 URL	봇을 서버에 초대할 때	Developer Portal → OAuth2
Webhook URL	채널로만 메시지를 전송할 때	채널 설정 → Integrations

주의할 점

봇 토큰은 재발급하면 이전 토큰이 즉시 무효화됩니다. 여러 환경에 흩어져 있다면 미리 정리해야 합니다.

또한 MESSAGE CONTENT INTENT를 켜지 않으면 메시지 본문을 읽을 수 없습니다. 슬래시 커맨드만 쓸 거라면 꺼두어도 됩니다.

마지막으로, 토큰은 .env나 비밀 관리 도구에 넣고 커밋하지 마세요. GitHub에 올라가면 Discord가 자동으로 감지해서 무효화할 수 있습니다.