Discord MCP 에이전트

Discord 기반 AI 에이전트와 사용자 간의 통신을 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. AI 에이전트가 IDE 채팅 인터페이스 대신 Discord를 통해 사용자와 소통할 수 있게 합니다.

목차

• 빠른 시작
• Discord 봇 설정
• 도구 참조
• 리액션 기능
• 설정
• 사용 예제
• 문제 해결
• 요구 사항
• 기여
• 링크

빠른 시작

설치

VS Code / GitHub Copilot

.vscode/mcp.json에 추가:

Claude 데스크톱

claude_desktop_config.json에 추가:

Discord 봇 설정

1. Discord 개발자 포털로 이동
2. 새 애플리케이션(New Application) 클릭 → 이름 입력 → 생성
3. 봇(Bot) 섹션으로 이동 → 봇 추가(Add Bot) 클릭
4. 봇 토큰(Bot Token) 복사 (비공개 유지!)
5. Privileged Gateway Intents 활성화:
   • ✅ 메시지 내용 인텐트(Message Content Intent)
6. OAuth2 → URL 생성기(URL Generator):
   • 스코프(Scopes): bot
   • 봇 권한(Bot Permissions): 메시지 보내기(Send Messages), 메시지 기록 읽기(Read Message History), 리액션 추가(Add Reactions), 파일 첨부(Attach Files)
7. 생성된 URL 복사 후 열어서 봇을 서버에 초대
8. 서버 ID 가져오기: Discord 설정에서 개발자 모드 활성화 → 서버 우클릭 → ID 복사

⚠️ 보안 경고: 절대 봇 토큰을 버전 관리 시스템에 올리지 마세요! 환경 변수나 .env 파일을 사용하세요.

도구 참조

discord_ask

질문을 보내고 사용자 응답을 기다립니다. 리액션 기반 상호작용을 지원합니다.

| 매개변수(Parameter) | 타입(Type) | 필수(Required) | 설명(Description) | | ------------------- | ---------- | --------------

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.