Discord MCP für Codex

Discord MCP ist ein lokales Codex-Plugin, das einen Discord-Bot als MCP-Tools bereitstellt. Codex startet die Brücke bei Bedarf; es ist kein dauerhaft laufender Gateway-Dienst oder öffentlicher Server erforderlich.

[!IMPORTANT] Dieses Projekt ist nicht mit Discord verbunden oder von Discord unterstützt. Discord ist eine Marke von Discord Inc. Verwenden Sie den Bot nur auf Servern, auf denen Sie berechtigt sind, ihn zu verwalten.

Voraussetzungen

• Codex-Desktop mit lokaler Plugin-Unterstützung

• Node.js 18 oder neuer

• Eine Discord-Anwendung mit einem Bot-Benutzer

Related MCP server: Discord MCP Server

Funktionsumfang

• Bot-Konnektivität prüfen und eine Einladungs-URL generieren

• Zugängliche Server, Kanäle und Rollen auflisten

• Kanäle erstellen, bearbeiten und löschen

• Nachrichten senden

• Rollen erstellen, bearbeiten und löschen

• Rollen von Mitgliedern hinzufügen und entfernen

• Beliebige guild-bezogene JSON-Endpunkte der Discord API v10 über abgesicherte Lese-/Schreib-Fallback-Tools aufrufen

Die Fallback-Ebene deckt Moderation, Bans, Timeouts, AutoMod, Threads, Reaktionen, Emojis, Sticker, geplante Ereignisse, Onboarding, Soundboard, Berechtigungen, von Bots verwaltete Webhooks und neue guild-bezogene REST-Endpunkte ab – ohne auf ein Plugin-Update warten zu müssen.

Discord setzt weiterhin die Berechtigungen des Bots, die aktivierten Intents und die Rollenhierarchie durch. Destruktive Tools erfordern ein zielspezifisches Bestätigungs-Token. Jeder generische Schreibvorgang wird als Vorschau angezeigt und benötigt vor der Ausführung ein an die Anfrage gebundenes Bestätigungs-Token.

Einrichtung

1. Erstellen Sie im Discord Developer Portal eine Anwendung und fügen Sie einen Bot hinzu.

2. Setzen Sie das Bot-Token zurück bzw. kopieren Sie es. Fügen Sie es niemals in einen Chat ein und speichern Sie es nicht in diesem Plugin-Ordner.

3. Öffnen Sie PowerShell und führen Sie Folgendes aus:

   & "$HOME\plugins\discord-mcp\scripts\configure.ps1"

   Das Skript fragt sicher das Token und optional eine kommagetrennte Zulassungsliste von Guild-IDs ab. Es speichert die Werte in Ihrer Windows-Benutzerumgebung, damit Codex sie an den MCP-Prozess weiterreichen kann.

4. Starten Sie die Codex-Desktop-App nach der Konfiguration neu.

5. Installieren oder aktivieren Sie Discord MCP über den persönlichen Marketplace und starten Sie dann eine neue Aufgabe.

6. Fragen Sie: „Überprüfe den Status meines Discord-Bots und gib mir die Administrator-Einladungs-URL.“

7. Öffnen Sie die Administrator-Einladungs-URL und autorisieren Sie den Bot für den vorgesehenen Server. Die Statusausgabe enthält außerdem eine Alternative mit minimalen Rechten.

Um eine Guild-ID zu finden, aktivieren Sie den Entwicklermodus in Discord, klicken Sie das Server-Symbol mit der rechten Maustaste an und wählen Server-ID kopieren. Die Angabe von DISCORD_ALLOWED_GUILD_IDS wird dringend empfohlen; die Brücke lehnt jede Guild ab, die nicht in dieser Liste steht.

Installation

1. Klonen Sie dieses Repository in Ihr lokales Codex-Plugins-Verzeichnis als discord-mcp.

2. Fügen Sie das Plugin zu einem lokalen Codex-Marketplace hinzu oder verwenden Sie das Plugin-Manifest des repositorys zusammen mit Ihrem bestehenden lokalen-Workflow.

3. Konfigurieren Sie die Bot-Zugangsdaten wie unten beschrieben.

4. Installieren Sie Discord MCP und aktivieren Sie es, starten Codex neu und starten Sie eine neue Aufgabe.

Das Plugin-Manifest befindet sich unter .codex-plugin/plugin.json, die MCP-Server-Definition liegt in .mcp.json.

Release-Downloads

Jeder Push auf main, der die Testsuite besteht, erzeugt ein GitHub-Release mit:

• Einem versionierten Plugin-Archiv discord-mcp-vX.Y.Z-build.N.zip

• Zugehöriger SHA-256-Prüfsummendatei

• Automatisch erzeugten Release-Notizen

Das Archiv wird in ein discord-mcp-Verzeichnis entpackt und kann direkt in ein lokales Codex-Plugins-Verzeichnis gelegt werden. Die semantische Version stammt aus package.json; die Run-Nummer aus der GitHub Actions macht jeden Build des Hauptzweigs eindeutig herunterladen.

Konfiguration

• DISCORD_BOT_TOKEN (erforderlich): Discord-Bot-Token.

• DISCORD_ALLOWED_GUILD_IDS (empfohlen): kommagetrennte Discord-Guild-IDs.

Führen Sie scripts/configure.ps1 -Clear aus, um beide Benutzerumgebungsvariablen zu entfernen.

Unter macOS und Linux setzen Sie dieselben Variablen in der Umgebung, mit der Codex gestartet wird. Zum Beispiel:

export DISCORD_BOT_TOKEN='your-token'
export DISCORD_ALLOWED_GUILD_IDS='123456789012345678'

Speichern Sie keine echten Werte in einer versionierten Datei und fügen Sie sie nicht in eine Codex-Aufgabe ein.

Administrator-Zugriff

discord_status liefert jetzt:

• administrator_invite_url, die das ADMINISTRATOR-Berechtigungsbit (8) von Discord anfordert

• least_privilege_invite_url, das nur die üblichen Verwaltungsberechtigungen des Plugins anfragt

• invite_url, das der Bequemlichkeit halber auf die Administrator-Einladung einsetzt.

Ist der Bot bereits auf dem Server, autorisieren Sie ihn erneut über administrator_invite_url oder aktivieren Administrator auf ages Bot-Rolle unter Servereinstellungen → Rollen. Legen die Bot-Rolle über alle Rolle, die diese verwalten muss. Administrator umgeht die überschriebenen Berechtigungen auf Kanälen, aber nicht die Rollenhierarchie, und kann nicht auf den Serverbesitzer zugreifen.

Architektur

Codex kommuniziert über stdio mit einem lokalen, abhängigkeitslosen Node.js-MCP-Server. The MCP Server ruft die Discord-API v22 über HTTPS mit dem Bot-Token auf. Er lauscht auf keinem Netzwerkport, empfängt keine Discord-Nachrichten und benötigt keinen privilegierten Gateway-Intent.

Umfang und Grenzen

Die abgestützten Fallback-Tools unterstützen Resternübereinstimmung GET, POST, PUT, PATCH und DELETE-Guild-Routen. Before the request, the SQL assigns it to a guild using guild, channel, stage, invitation or bot-authenticated webhook routes.

Diese lokale On-Demand-Brücke bietet keiner Discord-Gateway-Ereignis-Liste, keine persistente Präsenz, kein Sprach-/Audio-Streaming, keine Interaktion-Rückrufe, die temporäre Token zur benötigen, keine OAuth-Benutzerabläufe, keine Webhook-Token-Execution-Routen und keine Multipart-Dateiuploads. Diese Funktionen benötigen eine eigene, dauerhaft laufende Bot-Runtime oder einen wiederverwendbaren Upload-Flow. Routen und JSON-Felder mit Anmeldedaten werden absichtlich blockiert.

Sicherheit

• Administrator ist extrem stark. Verwenden Sie ihn nur auf Servern, die Sie kontrollieren.

• Halten Sie die Zulassungsliste aktiviert.

• Der Discord-Audit-Log empfängt einen Grund für alle insbesondere admin änderungen.

• Rohwrites are bound to method, path, query, body and audit; any change in will remove the confirmation token¿.

• Credential-Like Fields werden in Anfragen blockiert und in dem API-Antwortenauf Utilisieren.

• Rotate the bot token sofort, falls es öffentlich wurde.

See SECURITY.md for the trusted reporting your security issues.

Entwicklung

Der MCP-Server hat keine weiteren Laufzeit-Paketabhängigkeiten. Führen Sie die lokalen Überprüfungen und den Protocolsmoke test through:

npm test

The "smoke test" uses a scattered token and doesn't request Discord. Pull-Requests werden darüber hinaus von GitHub Actions durchgefuckt. See therefore CONTRIBUTING.md for Contribution guidelines and CHANGELOG.md for the release history.

Lizenz

Der Quellcode ist unter der MIT License verfügbar. Drittnamen, -Logos und -Marken liegen im Eigentum ihrer jeweiligen Inhaber.