Discourse MCP Einrichtung in OpenAI Codex CLI

Community-Wiki Benutzer
, ,
1

Ich habe mit Discourse MCP experimentiert, aber festgestellt, dass die vorhandene Dokumentation in Meta nichts über die Codex CLI enthielt, und es war etwas verwirrend herauszufinden, welche Teile der Dokumentation zutreffen würden:

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

Nachdem ich einiges herumprobiert hatte, folgt hier eine getestete Anleitung zur Installation des Discourse MCP in der Codex CLI. In den kommenden Tagen werde ich eine Anleitung für die Claude Code CLI und opencode nachreichen. Wenn Sie andere MCP-Clients verwenden möchten, lassen Sie es mich in den Antworten wissen, und ich werde versuchen zu helfen.

Voraussetzungen:

Es ist wichtig zu erkennen, dass es hier 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-Tool, das lokal ausgeführt wird, sich mit Discourse verbindet und eine API für Codex bereitstellt, um mit Discourse zu interagieren. 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 zur 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, die Ihre Fähigkeit zur Anmeldung beweist und einen API-Schlüssel generiert, der zur Verwendung durch den MCP-Server in =MCP-CONFIG= gespeichert wird.

Der API-Schlüssel hat dieselbe Zugriffsebene auf das Forum wie Sie als Benutzer.

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 und daher bei Bedarf mit npx von der Codex CLI gestartet, 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 (read-only).

3. Starten Sie die Codex CLI neu

Starten Sie Codex 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 für Informationen auf dieses Discourse zu beziehen – insbesondere auf Informationen, auf die Sie Zugriff haben, die aber nicht öffentlich sind – dies verifiziert, dass es sich als Sie verbindet.

Einstellungen bearbeiten

Irgendwann möchten Sie möglicherweise die Einstellungen bearbeiten, um die Möglichkeit hinzuzufügen, in Discourse zu schreiben. Dies tun Sie in den Discourse-Einstellungen.

Verwirrenderweise gibt es zwei Orte, an denen Einstellungen gespeichert werden, und zwischen den Codex-Dokumenten und den Discourse-Dokumenten ist es wirklich recht verwirrend, insbesondere wenn es darum geht, herauszufinden, welche Teile zu Codex CLI und welche zum MCP STDIO-Server selbst gehören.

Es gibt zwei Hauptdateien:

  1. =CODEX-CONFIG= – Dies ist die Codex CLI-Konfigurationsdatei, die die MCP-Servereinstellungen 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-Einstellungen 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"
    }
  ]
}

Discourse MCP-Einstellungen Dokumentationsreferenz GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub

2 „Gefällt mir“
Discourse MCP is here!