Discourse MCP-Einrichtung in der OpenAI Codex CLI

Community-Wiki Benutzer
, ,
1

Ich habe mit Discourse MCP experimentiert, stellte jedoch fest, dass die vorhandene Dokumentation auf Meta zur Verwendung nichts für die Codex CLI enthielt, und es war etwas verwirrend herauszufinden, welche Teile der Dokumentation anwendbar wären:

  • ist es npx oder npm install?
  • Welche Teile der Einrichtung sind Codex und welche Teile sind Discourse MCP?
  • Wo platziere ich die Einstellungen wie read_only: false?

Nach viel Herumprobieren ist hier eine getestete Anleitung zur Installation des Discourse MCP in die Codex CLI, und in den kommenden Tagen werde ich eine Anleitung für Claude Code CLI und opencode folgen lassen. Wenn Sie andere MCP-Clients verwenden möchten, lassen Sie es mich in den Antworten wissen, und ich werde versuchen zu helfen.

Bearbeiten: 2026.03.13 - Ich habe eine Anleitung für opencode geschrieben, die ein etwas anderes Konfigurationsdateiformat für MCPs aufweist, was für manche Leute verwirrend sein könnte.

Voraussetzungen:

Es ist wichtig zu erkennen, dass es drei separate Komponenten gibt:

  1. Das entfernte Discourse-Forum, das die Datenquelle und das Ziel für Aktionen ist.

  1. Der Discourse MCP-Server, ein Open-Source-lokal laufendes Tool, das sich mit Discourse verbindet und eine API für Codex zur Interaktion mit Discourse bereitstellt. Dieser wird als STDIO-Server installiert und bei Bedarf von der Codex CLI gestartet.

  1. Die Codex CLI, der MCP-Client, der sich mit dem MCP-Server verbindet und die Schnittstelle für die Interaktion mit Discourse über die MCP-API bereitstellt.

1. Generieren Sie den Benutzer-API-Schlüssel

Dies authentifiziert Sie bei Discourse und ist der Weg, wie Sie Ihren API-Schlüssel erhalten. npx lädt den Code herunter und führt ihn aus, es muss nichts im herkömmlichen Sinne installiert werden.

Führen Sie in einem Terminal Folgendes aus:

npx @discourse/mcp@latest generate-user-api-key \
  --site =DISCOURSE-FORUM= \
  --save-to =MCP-CONFIG=

Bestätigen Sie die Browser-Zustimmung und kopieren Sie die verschlüsselten Daten zurück, was Ihre Fähigkeit zur Anmeldung nachweist und einen API-Schlüssel generiert, der zur Verwendung durch den MCP-Server in =MCP-CONFIG= gespeichert wird.

Der API-Schlüssel hat die gleichen Zugriffsberechtigungen auf das Forum wie Sie als Benutzer haben.

2. Fügen Sie den MCP-Server zur Codex CLI hinzu:

Führen Sie dies in einem Terminal aus (nicht in der Codex CLI selbst)

codex mcp add discourse \
  -- npx -y @discourse/mcp@latest \
  --profile =MCP-CONFIG=

Er wird als STDIO-Server installiert, sodass er bei Bedarf mit npx von der Codex CLI gestartet wird, wenn Sie die Codex CLI starten.

Er ist so konfiguriert, dass er das Profil unter =MCP-CONFIG= verwendet, und standardmäßig ist er schreibgeschützt.

3. Starten Sie die Codex CLI neu

Starten Sie OpenCode vollständig neu, damit es config.toml und das Profil neu lädt.

Wenn es ohne Fehler startet, gibt es keine Probleme mit der Konfiguration, und Sie sollten den MCP-Server sehen, wenn Sie den /mcp ‘Slash’-Befehl in der Codex CLI ausführen.

In der Codex CLI können Sie Codex bitten, sich auf dieses Discourse für Informationen zu beziehen – insbesondere auf Informationen, auf die Sie Zugriff haben, die aber nicht öffentlich sind –, was überprüft, ob es sich als Sie verbindet.

4. Schreibfunktionen aktivieren (Optional)

Standardmäßig läuft der Discourse MCP-Server im schreibgeschützten Modus. Um Schreibvorgänge (Erstellen von Beiträgen, Themen, Benutzern usw.) zu ermöglichen, müssen Sie zwei Flags zu Ihrer Profil-JSON-Datei hinzufügen.

Bearbeiten Sie das Discourse-Profil unter =MCP-CONFIG= und fügen Sie "read_only": false und "allow_writes": true als Geschwister des Arrays auth_pairs hinzu:

{
  "read_only": false,
  "allow_writes": true,
  "auth_pairs": [
    {
      "site": "=DISCOURSE-FORUM=",
      "user_api_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

Beispiel:

{
  "read_only": false,
  "allow_writes": true,
  "auth_pairs": [
    {
      "site": "https://meta.discourse.org",
      "user_api_key": "abc123def456ghi789jkl012mno345pqr",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

Nachdem Sie diese Flags hinzugefügt haben, starten Sie die OpenCode CLI neu, damit die Änderungen wirksam werden. Der MCP-Server ermöglicht nun Schreibvorgänge wie:

  • Themen erstellen und aktualisieren
  • Beiträge und Antworten erstellen
  • Entwürfe verwalten
  • Dateien hochladen
  • Kategorien erstellen (wenn Sie die Berechtigung haben)
  • Benutzer verwalten (wenn Sie Admin-Berechtigung haben)

Warnung: Schreibvorgänge verwenden die Berechtigungen Ihres Benutzerkontos. Alle erstellten Inhalte erscheinen so, als hätten Sie sie manuell erstellt. Verwenden Sie Schreibfunktionen verantwortungsvoll.

Einstellungen bearbeiten

Irgendwann möchten Sie möglicherweise die Einstellungen bearbeiten, um die Möglichkeit zu erhalten, in Discourse zu schreiben, und dies tun Sie in den Discourse-Einstellungen.

Verwirrenderweise gibt es zwei Stellen, an denen Einstellungen gespeichert werden, und zwischen den Codex-Dokumenten und den Discourse-Dokumenten ist dies wirklich sehr verwirrend, insbesondere um herauszufinden, welche Teile zu Codex CLI gehören und welche zum MCP STDIO-Server selbst gehören.

Es gibt zwei Hauptdateien:

  1. =CODEX-CONFIG= - Dies ist die Konfigurationsdatei der Codex CLI, die die Einstellungen des MCP-Servers enthält.

  2. =MCP-CONFIG= - Dies ist das Profil für den Discourse MCP-Server, das den API-Schlüssel und andere Einstellungen für die Verbindung mit Discourse enthält.

Codex CLI-Einstellungen

Die Einstellungen für die Verbindung mit dem MCP befinden sich in =CODEX-CONFIG= und sollten in etwa so aussehen. Wenn Sie dem MCP-Server Optionen hinzufügen möchten, fügen Sie sie hier hinzu.

# =CODEX-CONFIG=
[mcp_servers.discourse]
command = "npx"
args = ["-y", "@discourse/mcp@latest", "--profile", "=MCP-CONFIG="]

Codex MCP Settings Dokumentation Model Context Protocol

Discourse MCP-Einstellungen

Die Einstellungen für den Discourse MCP-Server selbst befinden sich in =CODEX-CONFIG=

# =MCP-CONFIG=
{
  "profiles": [
    {
      "site": "=DISCOURSE-FORUM=",
      "user_api_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

Verweis auf die Dokumentation der Discourse MCP-Einstellungen GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub

3 „Gefällt mir“
Discourse MCP is here!
Discourse MCP Setup in OpenCode CLI