10분 만에 AI Discord 봇 만들기 (코딩 불필요)

Discord에서 AI 챗봇 시작하기

Discord 서버에 똑똑한 대화형 AI 봇을 만들고 싶으신가요? 이 단계별 가이드를 따라가면 코딩 없이 단 10분 만에 설정할 수 있습니다.

동영상 보기

AI 봇을 만드는 간단한 5단계

다음 단계를 따르면 Discord 서버에서 실제로 작동하는 AI 챗봇을 사용할 수 있습니다.

Discord 서버 만들기
Discord 애플리케이션 만들기
서버에 봇 추가하기
Quickchat AI 계정 만들기
Discord 봇과 Quickchat AI 연동하기

완성된 AI 봇의 모습

설정이 끝나면 봇이 Discord에서 실행되며 서버 멤버와 자연스럽게 대화할 준비를 마칩니다.

완성 모습: 똑똑한 대화형 AI

가장 빠른 방법: 클릭 한 번으로 연결하기

이미 Quickchat AI 계정이 있다면 Developer Portal을 거칠 필요가 없습니다. 대시보드 왼쪽 사이드바에서 External Apps를 열고 Discord를 선택한 다음, Connect 아래의 Add to your Discord server를 클릭하세요.

Quickchat AI의 Discord 연결 화면과 Add to your Discord server 버튼 External Apps → Discord에 있는 원클릭 연결 화면.

Discord에서 공유 Quickchat AI 앱을 승인하고 서버를 선택하라는 화면이 나타납니다. Authorize를 클릭하면 봇이 실행되며, 멤버가 채널에서 @멘션하여 사용할 수 있습니다. 필요한 것은 선택한 서버의 Manage Server 권한뿐입니다.

Quickchat AI에 새로 가입하면 Discord 전용 초기 설정 화면에서 바로 이 연결 과정으로 진행할 수 있습니다.

Quickchat AI 신규 가입자에게 표시되는 Discord 전용 초기 설정 화면 신규 가입자는 Discord 전용 초기 설정 화면에서 원클릭 연결을 시작합니다.

아래 단계는 수동 연결 방식인 Use your own Discord app 옵션입니다. 직접 Discord 애플리케이션을 만들고 봇 토큰으로 연결합니다. 봇 이름과 아바타를 직접 지정하거나, 다이렉트 메시지와 Discord AI Actions를 사용하거나, 한 서버에서 여러 봇을 운영하려면 이 방법을 선택하세요. Discord Actions는 Discord API 요청에 사용하는 토큰이 필요하므로 직접 만든 봇의 연결을 사용해야 합니다.

1. Discord 서버 만들기

Discord 계정이 없다면 discord.com에서 계정을 만드세요. 그런 다음 첫 서버를 설정합니다.

첫 서버 만들기

2. Discord 애플리케이션 만들기

**Discord Developer Portal**에 접속해 새 애플리케이션을 만드세요.

새 애플리케이션 만들기

3. Discord 서버에 봇 추가하기

아래 스위치를 켜서 봇이 메시지 내용을 받을 수 있도록 설정하세요.

봇을 만들었다면 서버에 추가해야 합니다. 다음 형태로 Discord URL을 구성한 뒤 브라우저에 붙여 넣으세요.

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237713920&scope=bot

권한 숫자는 어디서 나온 값인가요?

권한 숫자(309237713920)는 다음 권한을 요청했을 때의 값입니다.

View Channels
Send Messages
Create Public Threads
Send Messages in Threads
Read Message History

봇이 올바르게 작동하기 위한 최소 권한입니다. discord.com/developers/applications에서 애플리케이션을 선택하고 왼쪽의 Bot을 클릭한 뒤 아래로 스크롤하면 직접 확인할 수 있습니다.

Discord 봇 권한

YOUR CLIENT ID는 어디에서 찾나요?

가장 쉬운 방법은 브라우저 주소창의 URL에 포함된 긴 숫자를 복사하는 것입니다.

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

클라이언트 ID

이 예시의 클라이언트 ID는 1234567890123456789입니다. 따라서 서버에 봇을 추가하려면 다음 전체 URL을 열면 됩니다.

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237713920&scope=bot

이 단계에서 문제가 생긴다면:

“Integration requires code grant”: 애플리케이션에서 Require OAuth2 Code Grant가 켜져 있습니다. Developer Portal에서 앱을 열고 Bot으로 이동해 이 옵션을 끈 다음 저장하고 초대 URL을 다시 여세요. (자세히 보기)

케이크 또는 “baked” 화면이 나타남: Discord의 성공 화면으로, 봇이 추가된 상태입니다. Server Settings → Integrations → Bots and Apps에서 확인하세요.

팁: Quickchat AI 대시보드에 봇 토큰을 붙여 넣으면(5단계), Discord 연동 페이지가 초대 URL과 설정 체크리스트를 표시합니다. 따라서 위 URL을 직접 조합하는 과정을 생략할 수 있습니다.

4. Quickchat AI 계정 만들기

**Quickchat AI**에 가입해 봇에 사람처럼 자연스러운 대화형 AI를 연결하세요.

Quickchat AI에서는 맞춤 지식 베이스, AI Actions 등을 갖춘 AI 에이전트를 만들 수 있습니다. Discord 봇, 웹사이트 등 다양한 곳에 적합합니다.

5. 봇과 Quickchat AI 연동하기

봇을 Quickchat AI에 연결하려면 Developer Portal에서 Discord Bot Token을 가져오세요.

Bot Settings → Reset Token → Copy Token으로 이동합니다.

토큰 재설정

Quickchat AI 대시보드에서 External Apps → Discord를 열고 Use your own Discord app을 선택한 다음 토큰을 붙여 넣으세요. Quickchat AI가 봇을 켜고 시작하는 동안 상태를 표시합니다.

토큰 붙여 넣기

봇이 온라인 상태가 되지 않는 경우

봇이 시작되지 않으면 Discord 연동 페이지에 정확한 오류와 해결 방법 링크가 표시됩니다. 가장 흔한 오류는 다음 두 가지입니다.

Invalid token: 토큰이 잘못되었거나 다시 생성되었습니다. 토큰을 재설정하면 이전 토큰은 무효가 됩니다. Developer Portal에서 봇을 열고 Bot → Reset Token으로 이동해 새 토큰을 복사하세요. 그런 다음 Quickchat AI에서 Reconnect를 클릭하고 붙여 넣으세요. 정확한 화면은 Invalid bot token을 참고하세요.
Message Content Intent가 꺼져 있음(PrivilegedIntentsRequired로 표시): 봇은 연결되었지만 메시지를 읽을 수 없습니다. Developer Portal에서 봇을 열고 Bot → Privileged Gateway Intents에서 Message Content Intent를 켠 다음 저장하세요. 정확한 스위치는 Message Content Intent를 참고하세요.

토큰이나 설정을 변경하면 봇이 재시작됩니다. 온라인 상태가 될 때까지 최대 1분 정도 기다려 주세요.

직접 만든 봇이 온라인이지만 답하지 않는 경우

원클릭으로 연결한 공유 Quickchat AI 봇이 같은 서버에 남아 있는지 확인하세요. 두 봇이 같은 서버에 있으면 공유 봇이 응답하고, 직접 만든 봇은 토큰, 인텐트, 권한이 모두 올바르더라도 응답하지 않습니다. Quickchat AI 대시보드에서 External Apps를 열고 원클릭 설정의 Connected servers 아래에서 해당 서버를 찾아 제거하세요. 그러면 직접 만든 봇이 즉시 역할을 이어받습니다. Both bots are in the same server를 참고하세요.

AI 봇이 실행되었습니다!

Discord로 돌아가세요. 봇이 온라인 상태로 대화할 준비를 마쳤을 것입니다. @멘션해서 대화를 시작하세요.

활성화된 봇

@멘션하면 봇은 기본적으로 채널에 답합니다. Reply in 설정에서 Thread를 선택하면 스레드를 만들며, 사용자는 그 안에서 봇을 다시 멘션하지 않고 대화를 이어갈 수 있습니다.

스레드에서 이어지는 대화

봇이 응답하는 방식

봇은 여러 방식으로 호출할 수 있으며, 각 방식에 따라 대화 기록을 다루는 방식이 달라집니다.

상황	호출 방법	대화 기록
채널에서 @멘션	텍스트 채널에서 봇을 @멘션	Reply in 설정에 따라 다름(아래 참고)
봇 스레드의 메시지	봇이 만든 스레드에 메시지 전송	스레드 전체 기록 유지
봇 메시지에 답장	봇 메시지에 Discord의 답장 기능 사용	매번 새 대화 시작
`/ask` 슬래시 명령어	`/ask`와 질문 입력(원클릭 봇만 지원)	매번 새 대화 시작
다이렉트 메시지	봇에 DM 전송(직접 만든 앱만 지원)	DM 세션 전체에서 유지

채널에 일반 메시지만 보내면 봇은 반응하지 않습니다. 바쁜 서버에서 불필요한 응답을 하지 않도록 의도한 동작이며, 새로 추가한 봇이 고장 난 것처럼 보이는 가장 흔한 이유입니다. /ask는 사용 방법을 더 쉽게 발견하도록 마련된 대안이기도 합니다. 어느 채널에서든 /를 입력하면 목록에 표시되며, 메시지 내용 접근이 제한된 곳에서도 작동합니다. 공유 원클릭 봇에 등록된 명령어이므로 직접 만든 애플리케이션을 연결한 경우에는 @멘션을 사용하세요.

”Reply in” 설정

Quickchat 대시보드의 Channels > External Apps > Discord에는 두 옵션이 있는 “Reply in:” 드롭다운이 있습니다.

Channel(기본값): 멘션된 채널에 바로 답합니다. @멘션할 때마다 이전 상호작용을 기억하지 않는 새 대화가 시작됩니다.
Thread: @멘션마다 새 스레드를 만듭니다. 스레드 이름에는 봇과 사용자 이름이 들어갑니다(예: “Aria & john_doe”). 스레드 안에서는 @멘션 없이 모든 메시지에 응답하며 전체 대화 기록을 유지합니다.

다이렉트 메시지

DM을 사용하려면 직접 만든 Discord 애플리케이션이 필요합니다. 공유 원클릭 봇은 서버에서만 답합니다. 하나의 공유 계정으로 요청하지 않은 DM에 응답하면 그 봇이 서비스하는 모든 서버에 영향을 주기 때문입니다.

직접 만든 앱에서는 DM에 @멘션이 필요 없습니다. 봇이 모든 메시지에 응답하고 세션 동안 대화 기록을 유지합니다. DM에 답할 때는 서버 채널 기록에 접근하지 않습니다.

참고: 봇은 직접 만든 스레드에서만 응답합니다. 누군가 수동으로 스레드를 만들고 글을 쓰면 봇은 답하지 않습니다.

봇이 채널 맥락을 이해하는 방법

채널에서 누군가 봇을 @멘션하면 봇은 멘션이 포함된 메시지 하나만 보는 것이 아닙니다. 채널의 최근 메시지를 자동으로 가져와 시간 정보가 있는 대화 기록으로 AI 프롬프트에 포함합니다. 따라서 진행 중인 대화를 이해하고 앞서 나온 발언을 참조할 수 있습니다.

AI 관점에서 보는 맥락의 예시는 다음과 같습니다.

Most recent messages on the #general channel:
[2026-02-19 14:01] alice: Has anyone tried the new API endpoint?
[2026-02-19 14:03] bob: Yeah, I got a 429 back after about 50 requests
[2026-02-19 14:05] alice: @QuickchatBot what's the rate limit for the v2 API?

봇은 채널의 활성 스레드와 보관된 스레드에서도 메시지를 읽으므로, 스레드의 논의가 맥락에 포함됩니다.

Discord의 답장 기능으로 특정 메시지에 답하면, 봇은 최근 기록 전체를 가져오는 대신 답장 대상 메시지 바로 주변으로 맥락을 좁힙니다. 사용자가 언급하는 특정 대화에 초점을 맞출 수 있습니다.

스티커, GIF, 이미지, 임베드, 반응 같은 특수 콘텐츠는 주석으로 표현됩니다. 맥락 기록에서 시각적으로 볼 수 없어도 봇이 존재를 인식할 수 있습니다. @멘션 토큰은 읽기 쉬운 표시 이름으로 바뀝니다.

별도 설정은 필요 없습니다. 채널 맥락은 모든 Quickchat AI Discord 봇에서 기본적으로 활성화되어 있습니다.

채널 맥락을 활용해 후속 질문에 답하는 봇

서버 기록 전체를 대상으로 하는 스마트 AI 검색

기본적으로 봇은 멘션된 채널의 메시지만 읽습니다. Smart AI search over server history를 켜면 서버의 모든 텍스트 채널에서 메시지를 검색할 수 있습니다. AI가 사용자의 질문에 따라 살펴볼 채널을 결정합니다.

예를 들어 #general에서 “마이그레이션에 관해 #engineering에서 어떤 결론이 났어?”라고 물으면 봇은 #engineering의 최근 기록을 읽고 찾은 내용을 바탕으로 답할 수 있습니다.

기간 필터링과 페이지네이션도 지원하므로 필요할 때 더 오래된 기록을 살펴볼 수 있습니다.

모드	범위	적합한 용도
기본값	현재 채널만	범용 커뮤니티 봇
Smart AI search over server history	서버의 모든 채널	지원 봇, 여러 채널에 걸친 지식 검색

참고: Smart AI search over server history는 현재 베타 기능입니다. 관심이 있다면 이메일이나 Quickchat Discord 서버로 문의하세요.

봇에 이미지 보내기

봇을 @멘션할 때 이미지를 첨부하면 AI가 시각 이해 기능으로 처리합니다. PNG, JPG, JPEG, GIF, WebP 형식을 지원합니다. 이미지를 여러 장 첨부하면 첫 번째 이미지를 처리합니다.

Discord CDN의 이미지 URL이 메시지 텍스트와 함께 멀티모달 입력으로 AI 모델에 전달되므로, AI는 같은 대화 턴에서 텍스트와 이미지를 함께 볼 수 있습니다. 설정은 필요 없습니다. 이미지 이해는 기본적으로 활성화되어 있습니다.

Discord 커뮤니티에서 활용할 수 있는 예시입니다.

개발자 커뮤니티: 사용자가 스택 트레이스나 오류 메시지의 스크린샷을 보내고 설명을 요청합니다
디자인 커뮤니티: UI 목업을 공유하고 봇의 피드백을 요청합니다
게임 커뮤니티: 게임 설정 화면을 공유하고 최적화 팁을 요청합니다
전자상거래 지원: 고객이 불량 제품 사진을 지원 봇에 보냅니다

사용자가 스크린샷을 보내면 봇이 이미지를 분석해 질문에 답하는 모습

Discord에 AI Actions 연결하기

AI Actions를 사용하면 Discord 대화 중에 봇이 외부 API와 도구를 호출할 수 있습니다. Quickchat 대시보드의 AI Agent > Actions & MCPs에서 한 번 설정하면 Discord, 웹사이트 위젯, WhatsApp, Telegram 등 모든 채널에서 작동합니다.

두 종류의 액션을 사용할 수 있습니다.

액션 종류	기능
API Action	매개변수, 헤더, 본문을 설정하여 외부 엔드포인트로 HTTP 요청(GET, POST, PUT, DELETE)을 보냄
Remote MCP	Model Context Protocol 서버에 연결하여 외부 도구와 데이터 소스에 접근

Discord에서 AI Actions로 만들 수 있는 예시는 다음과 같습니다.

주문 추적 봇: API Action을 전자상거래 백엔드에 연결하면 멤버가 “주문 #12345는 지금 어디 있나요?”라고 묻고 실시간 상태를 확인할 수 있습니다.
GitHub 이슈 봇: Remote MCP를 GitHub 저장소에 연결하면 개발자가 Discord에서 “critical 태그가 붙은 미해결 버그가 있나요?”라고 직접 물을 수 있습니다.
지원 티켓 봇: 문서에서 답을 찾아 안내하고, 해결하지 못한 내용에만 지원 역할을 멘션하는 비공개 티켓 스레드를 엽니다.
모더레이션 도우미: 타임아웃, 추방, 차단, 슬로우 모드 템플릿을 선택해 관리자가 자연어로 실행하도록 합니다.
회의 일정 봇: Remote MCP를 Cal.com이나 Google Calendar에 연결하여 사용자가 Discord에서 팀과의 회의를 예약하게 합니다.
CRM 연동: HubSpot에 연결하여 Discord 대화에서 잠재 고객을 기록하거나 지원 티켓을 만들게 합니다.
잠재 고객과 피드백 기록: Google Sheets에 연결하면 봇이 Discord 대화에서 나온 잠재 고객, 미답변 질문, 데모 요청을 팀이 이미 사용하는 스프레드시트에 바로 기록합니다.

API Action 설정하기

Quickchat 대시보드에서 AI Agent > Actions & MCPs로 이동합니다.
Add Action을 클릭합니다. 지원되는 Discord 작업이라면 Discord Action을 선택하고 템플릿을 고르세요. 지원 템플릿은 서버, 채널, 역할을 묻고, 모더레이션 템플릿은 바로 설치됩니다. Quickchat이 편집 가능한 요청, 설명, 매개변수, 응답 처리, 실행 조건을 만들어 줍니다.
갤러리에 없는 엔드포인트가 필요할 때만 사용자 지정 HTTP Request 액션을 선택하세요. “주문 상태 확인” 같은 이름과 AI가 언제 사용할지 알 수 있는 설명을 지정합니다. 예: “사용자가 주문 상태를 물을 때 사용합니다. 먼저 주문 번호를 요청하세요.”
HTTP 메서드(예: GET), 엔드포인트 URL, 필요한 매개변수를 설정하고 저장합니다.

이제 지원 채널에서 에이전트가 액션을 사용할 수 있습니다. Discord 갤러리 Actions는 편집 가능한 일반 HTTP Request Actions이므로, 수정한 뒤에는 인증, 대상, 매개변수를 검토하세요. 자세한 절차는 HubSpot AI Actions 튜토리얼, Discord 모더레이션 봇 가이드(타임아웃, 추방, 차단, 역할, 슬로우 모드를 AI Actions로 사용), Actions 문서를 참고하세요.

설정된 API Action이 표시된 Quickchat 대시보드의 Actions & MCPs 페이지

더 읽어보기

관련 주제를 자세히 다룬 가이드입니다.

캐릭터를 유지하는 롤플레이 AI 챗봇 만드는 방법: 같은 봇을 고유한 설정을 가진 지속적인 캐릭터로 만들기
Telegram용 AI 챗봇 만드는 방법: 같은 AI 에이전트를 Telegram에 배포하기
WhatsApp용 AI 봇 만들기: WhatsApp 연동 가이드
HubSpot AI Actions: API Actions 설정을 위한 단계별 튜토리얼
AI Discord 티켓 봇: 지식 베이스로 답하고 남은 문제를 비공개 티켓 스레드로 전달하기
Discord 환영 봇: 새 멤버, 새 스레드, 새 티켓 채널에 정해진 인사 메시지 보내기
AI 에이전트를 Jira 티켓에 연결하기: Jira를 활용한 Remote MCP 예시
MCP 알아보기: Model Context Protocol의 개념과 작동 방식
Actions 문서: 전체 참조 문서

**Quickchat AI에 가입**해 AI 에이전트를 만들거나 Discord 커뮤니티에 참여하세요: discord.gg/KqkHwvPRNH