MCP로 Discord를 Claude에 연결하는 방법(단계별)

무엇을 연결하는가

Claude는 혼자서 여러분의 Discord 서버를 건드릴 수 없습니다. MCP(Model Context Protocol, MCP 용어집 항목에서 설명)는 어시스턴트가 외부 도구를 호출하게 해 주는 표준입니다. Noxyr는 MCP 서버를 운영하므로, Claude는 여러분이 Noxyr 대시보드에서 쓰는 것과 같은 작업을 여러분을 대신해 사용할 수 있습니다.

Claude에 입력할 주소는 다음과 같습니다.

https://noxyrbot.com/mcp/api

Streamable HTTP를 사용하며 Discord로 로그인합니다(OAuth). 나머지 Noxyr와 마찬가지로 무료입니다. 제품 페이지는 Noxyr MCP이며, 항상 최신 URL을 보여 줍니다.

Claude에 연결하기(웹 또는 데스크톱)

1. 커넥터 설정을 엽니다. 웹 또는 데스크톱 앱의 Claude 설정에서 Connectors를 찾으세요.
2. 커스텀 커넥터를 추가합니다. Add custom connector를 고르고 이름을 Noxyr로 정하세요.
3. URL을 붙여 넣습니다. 위 주소를 쓰고 확인하세요.
4. Discord로 로그인합니다. Noxyr 페이지가 열립니다. 로그인하고, Claude가 관리해도 되는 서버를 고른 뒤 Allow를 누르세요.
5. 채팅에서 켭니다. Claude는 메시지 입력창의 플러스 메뉴에서 대화마다 커넥터를 켜고 끌 수 있게 합니다.

Anthropic은 메뉴 이름을 가끔 바꿉니다. 도움말 페이지는 커스텀 커넥터가 Free, Pro, Max, Team, Enterprise 요금제에서 쓸 수 있으며, Free는 하나로 제한되고, Team과 Enterprise에서는 소유자만 추가할 수 있다고 말합니다. 위 목록과 라벨이 다르면 같은 커스텀 커넥터 옵션을 찾으세요.

Claude Code에 연결하기

터미널에서 Claude Code를 쓰는 경우, 이것을 한 번 실행하세요.

claude mcp add --transport http --scope user noxyr https://noxyrbot.com/mcp/api

--scope user 플래그는 Noxyr를 모든 프로젝트에서 쓸 수 있게 합니다. 그다음 Claude Code 안에서 /mcp를 입력하고, noxyr를 고른 뒤 Authenticate를 선택하세요. 같은 Discord 로그인이 브라우저에서 열립니다. 서버를 프로젝트 폴더의 .mcp.json 파일에 넣을 수도 있습니다.

먼저 물어볼 것

작동하는 모습을 볼 수 있도록 읽기 전용 질문으로 시작하세요.

• 제가 관리하는 서버 중 Noxyr가 있는 곳은 어디이고, 아직 필요한 곳은 어디인가요?
• 이번 주에 티켓을 몇 개 닫았고, 평균 평점은 얼마인가요?

그다음 변경을 시도하세요. 예를 들어 지원 채널에 Billing과 Bug report 버튼이 있는 Support라는 티켓 패널을 만들어 달라고 하세요. Claude는 채널과 역할을 읽고, 호출을 계획하고, 무엇을 했는지 알려 줍니다. 에이전트가 무엇을 처리할 수 있는지 더 자세히 보려면 AI 에이전트가 Discord 서버를 관리하는 방법을 읽으세요.

Claude가 할 수 없는 것

Noxyr는 에이전트 주위에 제한을 둡니다. 어떤 AI를 쓰든 이 제한은 유지됩니다.

• 삭제에는 여러분이 필요합니다. 삭제, 티켓 닫기, 추첨 종료, 커스텀 명령 제거는 먼저 Noxyr 승인 페이지를 띄웁니다. 여러분의 브라우저에서 여러분만 Approve를 누를 수 있습니다.
• 여러분의 서버만. 여러분이 소유자이거나 관리자 권한이 있는 서버만, 모든 작업마다 Discord와 실시간으로 확인되며, 연결할 때 허용한 서버만 대상입니다.
• 대시보드와 같은 검사. 에이전트는 대시보드 자체의 규칙과 활동 로그를 거칩니다. API 키는 접근 금지입니다.
• 속도 제한. 분당 120 요청.

연결이 안 될 때

로그인 페이지가 열리지 않음

커넥터에서 다시 인증하거나(또는 Claude Code에서 /mcp), 로그인은 처음 사용할 때만 요청됩니다.

Claude가 서버를 볼 수 없다고 말함

허용 페이지에서 그 서버를 체크하지 않았거나, 그 서버에서 여러분이 소유자나 관리자가 아닐 수 있습니다. 다시 연결하고 그 서버를 고르세요.

연결을 끊고 싶음

Noxyr의 Connected apps 페이지를 열고, 한 번의 클릭으로 앱 연결을 해제하세요.

일상적으로 사용하기

연결한 뒤에는 Claude를 대시보드를 열어 둔 도우미처럼 다루세요. 서버를 여럿 관리한다면 서버 이름을 말하고, 채널과 역할은 정확한 이름으로 부르고, 한 번에 한 작업만 요청하세요. Claude는 서버를 읽어서 ID를 스스로 찾을 수 있으므로, ID를 손으로 복사할 필요가 없습니다.

일상적인 좋은 요청은 다음과 같습니다. 가격을 바꾼 뒤 카탈로그를 다시 게시하기, 인증된 멤버 수 확인하기, 마감이 있는 추첨 시작하기, 잊고 있던 보안 설정 켜기. 삭제나 닫기가 포함된 작업이라면 승인 페이지가 뜰 것을 예상하고, 직접 Approve를 누르세요.

여러 서버

커넥터는 허용한 모든 서버를 볼 수 있습니다. 요청마다 어느 서버인지 말하세요. 예를 들어 "메인 서버에서"라고 하세요. 이름이 모호하면 Claude가 물어봐야 하며, 묻지 않는다면 무엇이든 승인하기 전에 멈추고 명확히 하세요.

다음 단계

대신 ChatGPT를 쓰나요? ChatGPT용 Discord MCP 서버를 보세요. 이 개념이 처음이라면 서버 소유자에게 MCP가 의미하는 것을 읽으세요. 먼저 서버에 Noxyr를 추가하려면 초대 링크를 사용하세요.