Vollständige Discord-Serververwaltung durch KI – Nachrichten, Kanäle, Rollen, Moderation, Ereignisse, Webhooks und Sprachkanäle.
discord-mcp ist ein Java-basierter MCP-Server, der auf JDA (Java Discord API) basiert und KI-Assistenten die volle Kontrolle über Discord-Server gibt. Es stellt über 44 Tools zur Verfügung, die Messaging, Kanalverwaltung, Rollenverwaltung, Moderation (Kick/Ban/Timeout), Sprachkanäle, geplante Ereignisse, Webhooks und Emoji-Verwaltung abdecken. Unterstützt die Docker-Bereitstellung sowohl mit HTTP- als auch mit stdio-Transport.
In context_servers hinzufügen. Zed lädt beim Speichern neu.
claude mcp add discord-mcp-2 -- TODO 'See README: https://github.com/SaseQ/discord-mcp'
Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.
Anwendungsfälle
Praxisnahe Nutzung: discord-mcp
How to automate Discord server moderation with discord-mcp
👤 Discord server moderators and community managers⏱ ~10 minbeginner
Wann einsetzen: You want to perform bulk moderation actions or set up automated responses.
Voraussetzungen
Discord bot token — Create a bot at discord.com/developers and invite it to your server with appropriate permissions
Ablauf
Review recent activity
Show me the last 50 messages in #general. Flag any that contain spam links or rule violations.✓ Kopiert
→ Message list with flagged items highlighted
Take moderation action
Delete the flagged messages and timeout the users who posted them for 24 hours.✓ Kopiert
→ Confirmation of deletions and timeouts applied
Ergebnis: Spam cleaned up and violators timed out in one operation.
Fallstricke
Bot lacks required permissions — Ensure the bot role has Manage Messages, Moderate Members, and other needed permissions
Set up event channels and scheduled events for your community
👤 Community organizers running Discord-based events⏱ ~15 minintermediate
Wann einsetzen: Sie müssen Kanäle, Rollen und geplante Ereignisse für ein Community-Treffen oder -Turnier erstellen.
Voraussetzungen
Discord-Bot mit den Berechtigungen „Kanäle verwalten“ und „Ereignisse verwalten“. — Einrichtung über discord.com/developers
Ablauf
Erstellen Sie eine Event-Infrastruktur
Erstellen Sie eine neue Kategorie mit dem Namen „Spieleabend März 2025“ mit den Textkanälen #Ankündigungen, #Allgemeiner-Chat und #Voice-Lobby. Erstellen Sie außerdem einen Sprachkanal.✓ Kopiert
→ Mit Bestätigungen erstellte Kanäle
Planen Sie die Veranstaltung
Erstellen Sie eine geplante Veranstaltung für „Game Night“ an diesem Samstag um 20:00 Uhr EST im Voice-Lobby-Kanal. Beschreibung: „Wöchentlicher Spieleabend! Machen Sie mit bei Among Us und Jackbox.‘✓ Kopiert
→ Geplante Veranstaltung mit Link erstellt
Erstellen Sie eine Rolle für Teilnehmer
Erstellen Sie eine „Game Night Crew“-Rolle mit grüner Farbe und weisen Sie sie @Benutzer1, @Benutzer2 und @Benutzer3 zu.✓ Kopiert
→ Rolle erstellt und zugewiesen
Ergebnis: Komplette Event-Einrichtung mit Kanälen, geplantem Event und Teilnehmerrollen.
Fallstricke
Das Überschreiben von Kanalberechtigungen ist komplex — Legen Sie Berechtigungen auf Kategorieebene fest und lassen Sie Kanäle diese erben
Veröffentlichen Sie GitHub-PR-Benachrichtigungen automatisch auf einem Discord-Kanal
Suchen Sie seit gestern in unserem Repo nach neuen zusammengeführten PRs und veröffentlichen Sie eine Zusammenfassung unter #dev-updates auf Discord.✓ Kopiert
Werkzeuge
Was dieses MCP bereitstellt
Werkzeug
Eingaben
Wann aufrufen
Kosten
send_message
channel_id: str, content: str
Senden Sie eine Nachricht an einen Discord-Kanal
1 Discord API call
read_messages
channel_id: str, limit?: int
Nachrichtenverlauf eines Kanals lesen
1 Discord API call
create_text_channel
name: str, category_id?: str
Erstellen Sie einen neuen Textkanal
1 Discord API call
kick_member
user_id: str, reason?: str
Ein Mitglied vom Server werfen
1 Discord API call
create_scheduled_event
name, start_time, channel_id, description?
Planen Sie ein Serverereignis
1 Discord API call
create_role
name: str, color?: str, permissions?: int
Erstellen Sie eine neue Rolle auf dem Server
1 Discord API call
Kosten & Limits
Was der Betrieb kostet
API-Kontingent
Es gelten Geschwindigkeitsbegrenzungen für Discord-Bots (variiert je nach Endpunkt, typischerweise 5–50 Anforderungen/s).
Tokens pro Aufruf
200–800 Token pro Tool-Aufruf
Kosten in €
Kostenlos – Die Discord-Bot-API ist kostenlos
Tipp
Batch-Lesevorgänge, wenn möglich. Verwenden Sie server_id env var, um die Variable auf einen Server zu beschränken.
Sicherheit
Rechte, Secrets, Reichweite
Minimale Scopes:Bot token with required permissions
Credential-Speicherung: Bot-Token in Umgebungsvariable. Übertragen Sie niemals Bot-Tokens an Repos.
Datenabfluss: Alle Aufrufe gehen an die Discord API (discord.com)
Niemals gewähren:Administrator permission to the bot unless absolutely necessary
Gewähren Sie nur die Mindestberechtigungen, die Ihr Bot benötigt. Vermeiden Sie die Administratorberechtigung.
Write operations (send, delete, kick, ban) are irreversible — review before executing.
Fehlerbehebung
Häufige Fehler und Lösungen
403 Missing Permissions
Für diese Aktion fehlt dem Bot die erforderliche Berechtigung. Überprüfen Sie die Rollenberechtigungen des Bots unter Servereinstellungen → Rollen.
Prüfen: Review the bot's role permissions in Discord server settings
Unknown Channel / 404
Die Kanal-ID ist falsch oder der Bot hat keinen Zugriff auf diesen Kanal. Stellen Sie sicher, dass der Kanal vorhanden ist und der Bot ihn sehen kann.
Prüfen: List channels with channels_list tool first
Docker container can't connect
Stellen Sie sicher, dass die Umgebungsvariable DISCORD_TOKEN in Ihrem Befehl docker-compose.yml oder docker run korrekt eingestellt ist.