Claude Code에 Discord MCP 플러그인 설치 및 설정 가이드

실용적 조언

Claude Code 세션 내에서 '/plugin' 명령어를 입력하고 오른쪽 화살표를 눌러 설치된 플러그인의 오류 메시지를 확인하면 트러블슈팅이 빠르다.
매번 메시지 전송을 승인하지 않으려면 Claude Code에게 권한을 일임하는 프롬프트를 사용하라.

섹션별 상세

Discord MCP 서버를 구동하기 위해 Claude Code 내부에 Bun 런타임을 반드시 설치해야 한다. 사용자는 Claude Code 세션 내에서 Bun을 설치한 뒤 'bun --version' 명령어로 정상 설치 여부를 확인하는 과정을 거쳐야 플러그인 실행 오류를 방지할 수 있다.

bash

/plugin install discord@claude-plugins-official

공식 Discord MCP 플러그인을 설치하는 명령어

Discord 개발자 포털에서 봇 애플리케이션을 생성할 때 'Message Content Intent' 설정을 활성화하는 것이 필수적이다. 봇을 서버에 초대한 후 발급받은 토큰을 '~/.claude/channels/discord/.env' 경로에 정확히 저장해야 Claude Code가 봇의 권한을 획득하여 통신을 시작한다.

플러그인 활성화를 위해 '--channels' 파라미터를 포함하여 Claude Code를 재시작하는 단계가 요구된다. 정상적으로 설정되었다면 Discord 상에서 봇이 온라인 상태로 전환되며, 만약 실패할 경우 '/plugin' 명령어를 통해 설치된 플러그인의 상태와 토큰 접근성을 점검해야 한다.

bash

claude --channels plugin:discord@claude-plugins-official

Discord 채널 기능을 활성화하여 Claude Code를 실행하는 명령어

사용자 편의를 위해 Claude Code에게 메시지 전송 권한을 스스로 부여하도록 요청하는 팁이 제시됐다. 이를 통해 매번 메시지를 보낼 때마다 수동으로 승인해야 하는 번거로움을 없애고 자동화된 워크플로우를 구축할 수 있다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — Anthropic이 개발한 오픈 표준으로, LLM이 로컬 데이터나 외부 도구에 안전하게 접근할 수 있도록 연결하는 인터페이스 규격이다. Claude Code가 Discord와 같은 외부 앱과 통신하기 위한 다리 역할을 수행한다.
번(Bun): — JavaScript와 TypeScript를 위한 고성능 런타임이자 패키지 매니저이다. 이 가이드에서는 Discord MCP 서버를 실행하기 위한 필수 환경으로 사용되며 빠른 실행 속도가 특징이다.
메시지 콘텐츠 인텐트(Message Content Intent): — Discord 봇이 서버 내의 메시지 내용을 읽을 수 있도록 허용하는 특수 권한이다. 보안상의 이유로 개발자 포털에서 명시적으로 활성화해야 하며, 활성화하지 않으면 봇이 명령어를 인식하지 못한다.

언급된 도구

Bun추천

Discord MCP 서버 실행을 위한 JavaScript 런타임

Discord MCP Plugin추천

Claude Code와 Discord 간의 인터페이스 연결

언급된 리소스

튜토리얼Claude Code Channels Video Tutorial

튜토리얼Claude Code Channels Text Tutorial (DataCamp)