Inhalt der Doku
discord-mcp · Doku
Konfiguration
Alle Umgebungsvariablen von discord-mcp mit Standardwerten sowie Login per Passwort, TOTP oder Session-Token.
Auf dieser Seite
Umgebungsvariablen
discord-mcp wird komplett über Umgebungsvariablen konfiguriert. Alle Variablen beginnen mit DISCORD_MCP_. Eine Vorlage findest du in .env.example.
| Name | Standard | Beschreibung |
|---|---|---|
DISCORD_MCP_SERVER_HOST |
0.0.0.0 |
Adresse, auf der der Server lauscht. |
DISCORD_MCP_SERVER_PORT |
3000 |
Port des Servers. |
DISCORD_MCP_SERVER_LOG_LEVEL |
info |
Log-Level: fatal, error, warn, info, debug, trace oder silent. |
DISCORD_MCP_PATH |
/mcp |
Pfad des MCP-Endpunkts. |
DISCORD_MCP_READ_ONLY |
true |
Nur lesende Tools anbieten. Mit false kommt send_message dazu. |
DISCORD_MCP_AUTH_TOKEN |
– | Wenn gesetzt, verlangt /mcp den Header Authorization: Bearer <token>. |
DISCORD_MCP_DISCORD_EMAIL |
– | E-Mail des Discord-Kontos für den Browser-Login. |
DISCORD_MCP_DISCORD_PASSWORD |
– | Passwort des Discord-Kontos. |
DISCORD_MCP_DISCORD_TOTP_SECRET |
– | Base32-Secret der Authenticator-App, nötig bei Zwei-Faktor-Login. |
DISCORD_MCP_DISCORD_TOKEN |
– | Session-Token. Wenn gesetzt, startet kein Browser. |
DISCORD_MCP_DISCORD_DATA_DIR |
./data |
Verzeichnis für Session und Token. Im Image /var/www/data. |
DISCORD_MCP_DISCORD_HEADLESS |
true |
Chromium ohne Fenster starten. Lokal auf false setzen, um ein Captcha zu lösen. |
DISCORD_MCP_DISCORD_LOGIN_TIMEOUT |
120000 |
Maximale Dauer eines Browser-Logins in Millisekunden. |
DISCORD_MCP_DISCORD_API_URL |
https://discord.com/api/v9 |
Basis-URL der Discord-API. |
Login
Der Server holt sich das Session-Token in dieser Reihenfolge:
DISCORD_MCP_DISCORD_TOKEN, wenn gesetzt.- Gespeichertes Token aus dem Datenverzeichnis (Datei
token). - Browser-Login mit E-Mail, Passwort und gegebenenfalls TOTP. Danach landen Token und Browser-Session im Datenverzeichnis.
Antwortet Discord mit 401, verwirft der Server das Token und meldet sich neu an. Dafür braucht er E-Mail und Passwort. Mit einem reinen Token ohne Zugangsdaten musst du nach Ablauf selbst ein neues eintragen.
Zwei-Faktor-Login
Hast du 2FA aktiv, braucht der Server das Secret deiner Authenticator-App, nicht einen einzelnen Code.
- In Discord Einstellungen → Mein Account → Authentifizierungs-App aktivieren (oder neu einrichten).
- Beim QR-Code den Schlüssel als Text anzeigen lassen.
- Den Schlüssel als
DISCORD_MCP_DISCORD_TOTP_SECRETeintragen und gleichzeitig in deiner Authenticator-App hinterlegen.
Session-Token selbst auslesen
Statt Passwort kannst du das Token aus deinem eigenen Browser nehmen:
- Discord im Browser öffnen und anmelden.
- Entwicklertools öffnen, Tab Netzwerk.
- Eine beliebige Anfrage an
discord.com/api/auswählen. - Den Wert des Request-Headers
Authorizationkopieren und alsDISCORD_MCP_DISCORD_TOKENsetzen.
Vorsicht
Das Token ist so viel wert wie dein Passwort. Wer es hat, ist in deinem Namen angemeldet. Abmelden in Discord macht es ungültig.
Captcha oder neuer Standort
Ein Login von einer unbekannten IP (z. B. einem Server) beantwortet Discord manchmal mit einem Captcha oder einer Bestätigung per E-Mail. Dann meldest du dich einmal lokal mit sichtbarem Browser an und kopierst die Session auf den Server:
DISCORD_MCP_DISCORD_HEADLESS=false npm run dev- Im Browserfenster das Captcha lösen.
- Ein beliebiges Tool einmal aufrufen.
./data/storage-state.jsonund./data/tokenin das Datenvolume des Containers kopieren.
Oder du setzt einfach DISCORD_MCP_DISCORD_TOKEN.
Beispiel
DISCORD_MCP_DISCORD_EMAIL=ich@example.com
DISCORD_MCP_DISCORD_PASSWORD=dein-passwort
DISCORD_MCP_DISCORD_TOTP_SECRET=JBSWY3DPEHPK3PXP
DISCORD_MCP_READ_ONLY=true