Discord MCP by Quadslab.io

@quadslab.io/discord-mcp

Gerencie todo o seu servidor Discord a partir do Claude Code, Claude Co-Work, Claude Desktop, Cursor ou Windsurf. 139 ferramentas administrativas em 20 categorias — cargos, canais, membros, mensagens, threads, moderação, fóruns, estágios, webhooks, eventos, enquetes, DMs e muito mais. Basta conversar com sua IA em português simples.

Desenvolvido por QuadsLab.io | Discord | npm

Se você achar isso útil, considere dar uma estrela no GitHub — isso ajuda outras pessoas a descobrirem o projeto!

Configuração em 60 Segundos

Um único comando. Sem arquivos de configuração manuais. Sem copiar IDs.

npx @quadslab.io/discord-mcp init

O assistente interativo guia você por todo o processo:

Ele vai:

1. Guiar você na criação de um bot do Discord (ou usar um existente)
2. Validar o token do seu bot em tempo real
3. Gerar automaticamente o URL de convite com todas as permissões necessárias
4. Deixar você escolher qual servidor gerenciar
5. Detectar automaticamente seus clientes MCP instalados e escrever a configuração para você

Funciona com Todos os Clientes MCP

O assistente detecta automaticamente quais clientes você tem instalados:

  Detected MCP clients:

  ● Claude Code      .mcp.json
  ● Claude Desktop   ~/Library/Application Support/Claude/claude_desktop_config.json
  ● Cursor           ~/.cursor/mcp.json
  ○ Windsurf         (not detected)

  ? Which client(s) to configure?
  1. Claude Code (detected)
  2. Claude Desktop (detected)
  3. Cursor (detected)
  4. Windsurf (not found)
  5. All detected (3 clients)
  6. Skip (show config to copy manually)

Selecione um, vários ou "Todos detectados" para configurar tudo de uma vez.

Verifique Sua Configuração

npx @quadslab.io/discord-mcp check

  QuadsLab.io [discord-mcp] — Health Check
  ────────────────────────────────────────────────────

  Token ............ present
  Bot .............. MyBot#1234
  Server ........... My Gaming Server (1,024 members)

  Permissions
  ────────────────────────────────────────────────────

  ✔ Manage Roles .............. yes
  ✔ Manage Channels ........... yes
  ✔ Kick Members .............. yes
  ✔ Ban Members ............... yes
  ...

  ██████████████████████████████  100% (24/24)

  ✔ All 24 permissions granted

  ┌──────────────────────────────────────────────────┐
  │ MCP server is ready!                             │
  │ Run discord-mcp or use via .mcp.json in Claude   │
  └──────────────────────────────────────────────────┘

O Que Você Pode Fazer Com Isso?

Uma vez conectado ao Claude Code ou Claude Co-Work, basta perguntar em linguagem natural:

• "Envie uma mensagem de boas-vindas no #geral"
• "Bloqueie o canal #anuncios"
• "Quem reagiu à última mensagem no #guia-do-servidor?"
• "Crie um cargo chamado VIP com cor dourada e atribua ao @joao"
• "Mostre-me o registro de auditoria das últimas 24 horas"
• "Configure uma regra de automoderação para bloquear links no #geral"
• "Mostre-me as últimas 20 mensagens no thread 'Discussão de API'"
• "Envie uma resposta no thread 'relatorio-de-bug' dizendo que estamos analisando"
• "Liste todos os threads arquivados no #geral"
• "Crie uma postagem no fórum #feedback intitulada Relatórios de Bugs"
• "Dê timeout no @spammer por 1 hora por spam"
• "Liste todos os webhooks e exclua os não utilizados"
• "Agende um evento da comunidade para sexta às 20h no canal de palco"
• "Exclua em massa as últimas 50 mensagens no #teste-de-bot"
• "Dê a todos com o cargo Membro acesso ao #canal-privado"
• "Crie uma enquete no #geral perguntando qual jogo jogar na sexta"
• "Envie DM para todos os moderadores sobre o próximo evento do servidor"
• "Defina o status do bot como 'Observando mais de 500 membros'"
• "Mostre-me quem está no canal de voz Gaming agora"

O Claude resolve automaticamente nomes de canais, cargos e membros usando correspondência difusa — sem necessidade de procurar IDs.

Recursos

• 139 ferramentas em 20 categorias — administração abrangente do servidor Discord sem sair do terminal
• Assistente de configuração interativo — npx init guia você pela criação do bot, validação de token e configuração em menos de um minuto
• Verificação de saúde e auditoria de permissões — npx check verifica seu token, acesso ao servidor e todas as 24 permissões necessárias com uma barra de progresso visual
• Resolução difusa de nomes — digite "bot testing", "bot-testing" ou "bottesting" e ele resolve corretamente; sem necessidade de procurar IDs
• Mensagens compatíveis com threads — todas as ferramentas de mensagem (enviar, editar, fixar, reagir, etc.) funcionam em threads e canais igualmente — sem necessidade de ferramentas separadas
• Correspondência de nomes sem configuração — canais, cargos e membros são todos resolvidos por nome, ID ou formato de menção automaticamente
• Dados de servidor pré-cacheados — todos os canais, cargos e membros são armazenados em cache na inicialização para consultas instantâneas sem chamadas extras de API
• Respostas JSON estruturadas — cada ferramenta retorna JSON consistente e bem formatado
• Integração com registro de auditoria — todas as operações de modificação aceitam um parâmetro reason que aparece no registro de auditoria do Discord
• Recuperação de erros útil — consultas com falha retornam sugestões (ex.: "Você quis dizer: #geral, #teste-de-bot?")
• Recursos MCP — três recursos somente leitura para dados de visão geral do servidor

Configuração Alternativa (Manual)

Se você preferir configurar as coisas manualmente em vez de usar o assistente:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@quadslab.io/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token",
        "DISCORD_GUILD_ID": "your-server-id"
      }
    }
  }
}

git clone https://github.com/HardHeadHackerHead/discord-mcp.git
cd discord-mcp
npm install
cp .env.example .env
# Edit .env with your DISCORD_TOKEN and DISCORD_GUILD_ID
npm run build
npm start

Referência da CLI

$ npx @quadslab.io/discord-mcp [command]

Quando iniciado via .mcp.json (stdin não é um TTY), o servidor inicia automaticamente — sem necessidade de subcomando.

Atualização

A configuração do seu cliente MCP não fixa uma versão, então atualizar é simples:

npx @quadslab.io/discord-mcp update

Isso verifica a versão mais recente no npm, limpa o cache do npx, e na próxima inicialização do seu cliente MCP a nova versão será usada automaticamente. Seu token do bot, servidor e configuração do cliente são todos preservados — nada precisa ser reconfigurado.

Para verificar após a atualização:

npx @quadslab.io/discord-mcp version
npx @quadslab.io/discord-mcp check

Visão Geral das Ferramentas

Resumo

Correspondência Difusa

Todas as ferramentas que aceitam nomes de canais, cargos ou membros usam correspondência difusa inteligente. Você nunca precisa procurar IDs manualmente. A ordem de resolução é:

1. Correspondência exata por ID — passe um ID snowflake do Discord diretamente
2. Correspondência exata por nome — sem diferenciar maiúsculas de minúsculas
3. Correspondência normalizada — ignora hífens, espaços e sublinhados ("bot testing" corresponde a "bot-testing")
4. Correspondência por substring — correspondências parciais de nome com limite de similaridade de 0,7+
5. Fallback de thread — se nenhum canal corresponder, as threads ativas são pesquisadas usando as mesmas etapas acima
6. Fallback de thread arquivada — se um ID for fornecido e não for encontrado nas threads ativas, a thread é buscada diretamente (cobre threads arquivadas)

Os formatos de menção também são tratados automaticamente:

• Canais: #name ou <#id>
• Cargos: @name ou <@&id>
• Membros: @name ou <@id> ou <@!id>

Se nenhuma correspondência for encontrada, a mensagem de erro inclui sugestões de nomes semelhantes para ajudar você a corrigir a entrada.

Recursos MCP

Três recursos somente leitura são expostos para uma visão geral rápida do servidor:

Permissões Necessárias

O bot do Discord precisa das seguintes permissões para funcionar totalmente:

O assistente init gera automaticamente uma URL de convite com todas essas permissões. Se você configurar manualmente, consulte o Guia de Configuração do Bot para saber quais caixas marcar.

O bot só pode agir dentro de sua hierarquia de cargos — ele não pode gerenciar cargos posicionados acima do próprio cargo mais alto.

Gateway Intents

Estes intents privilegiados devem ser habilitados no Portal do Desenvolvedor do Discord:

• Server Members Intent — necessário para gerenciamento de membros
• Message Content Intent — necessário para ler o conteúdo das mensagens

Solução de Problemas

Execute a verificação de saúde para diagnosticar problemas:

npx @quadslab.io/discord-mcp check

npx @quadslab.io/discord-mcp@latest init

Arquitetura

@quadslab.io/discord-mcp/
├── package.json
├── tsconfig.json
├── README.md
├── LICENSE
├── .env.example
├── docs/
│   ├── discord-mcp-server.md    # Full tool reference documentation
│   └── bot-setup-guide.md       # Step-by-step bot creation guide
└── src/
    ├── cli.ts                   # CLI — init wizard, health check, server start
    ├── mcp-server.ts            # MCP server entry — validates env, exports main()
    ├── index.ts                 # Tool/resource registration and MCP request routing
    ├── discord-client.ts        # Discord.js client — intents, caching, rate limit retry
    └── tools/
        ├── index.ts             # Tool registry — routes calls to category handlers
        ├── utils.ts             # Fuzzy matching for channels, roles, members
        ├── guild.ts             # Server info (2)
        ├── roles.ts             # Role management (11)
        ├── channels.ts          # Channel management (20)
        ├── members.ts           # Member management (15)
        ├── messages.ts          # Messaging (14)
        ├── reactions.ts         # Reactions (1)
        ├── server.ts            # Server admin (16)
        ├── threads.ts           # Thread management (15)
        ├── forums.ts            # Forum channels (5)
        ├── emojis.ts            # Emoji & stickers (7)
        ├── webhooks.ts          # Webhooks (4)
        ├── events.ts            # Scheduled events (5)
        ├── stage.ts             # Stage instances (3)
        ├── automod.ts           # Auto-moderation (4)
        ├── polls.ts             # Polls (3)
        ├── dms.ts               # Direct messages (2)
        ├── presence.ts          # Bot presence (2)
        ├── templates.ts         # Server templates (4)
        ├── commands.ts          # Application commands (4)
        └── onboarding.ts        # Onboarding (2)

Comunidade

• Servidor Discord — obtenha ajuda, compartilhe feedback, veja o que outros estão construindo
• Issues no GitHub — relatórios de bugs e solicitações de recursos
• Discussões no GitHub — perguntas, ideias e demonstrações
• QuadsLab.io — mais ferramentas da equipe

Contribuindo

Contribuições são bem-vindas! Veja CONTRIBUTING.md para configuração de desenvolvimento, estilo de código e diretrizes.

Licença

Licença MIT. Copyright (c) 2026 QuadsLab.io.

Veja LICENSE para o texto completo.