Configurazione di Discourse MCP nella CLI di OpenAI Codex

Wiki della community Utenti
, ,
1

Ho sperimentato con Discourse MCP ma ho scoperto che la documentazione esistente su Meta per il suo utilizzo non includeva nulla per Codex CLI, ed è stato un po’ confuso capire quali parti della documentazione sarebbero state applicabili:

  • è npx o npm install?
  • quali parti della configurazione sono di Codex e quali di Discourse MCP?
  • dove devo inserire le impostazioni come read_only: false?

Quindi, dopo averci smanettato parecchio, ecco una guida testata per installare Discourse MCP in Codex CLI, e seguiranno nei prossimi giorni una guida per Claude Code CLI e opencode. Se ci sono altri client MCP che desideri utilizzare, fammelo sapere nelle risposte e cercherò di aiutarti.

Prerequisiti:

È importante rendersi conto che ci sono tre componenti separati qui:

  1. Il forum Discourse remoto, che è la fonte dei dati e il bersaglio per le azioni.

  1. Il server Discourse MCP, che è uno strumento open-source in esecuzione in locale che si connette a Discourse e fornisce un’API per Codex per interagire con Discourse. Questo viene installato come server STDIO e lanciato su richiesta da Codex CLI.

  1. Codex CLI, che è il client MCP che si connette al server MCP e fornisce l’interfaccia per interagire con Discourse tramite l’API MCP.

1. Genera la chiave API Utente

Questo ti autenticherà su Discourse ed è così che otterrai la tua chiave API. npx scaricherà ed eseguirà il codice, non è necessario installare nulla nel senso tradizionale.

In un terminale, esegui:

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

Approva il consenso del browser e copia indietro i dati crittografati, che dimostrano la tua capacità di accedere e generano una chiave API che viene salvata in =MCP-CONFIG= per l’uso da parte del server MCP.

La chiave API avrà lo stesso livello di accesso al forum che hai come utente.

2. Aggiungi il server MCP a Codex CLI:

Esegui questo in un terminale (non in Codex CLI stesso)

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

Viene installato come server STDIO, quindi verrà avviato su richiesta con npx da Codex CLI quando avvii Codex CLI.

È configurato per utilizzare il profilo in =MCP-CONFIG= e per impostazione predefinita è di sola lettura.

3. Riavvia Codex CLI

Riavvia completamente Codex in modo che ricarichi config.toml e il profilo.

Se si avvia senza errori, non ci sono problemi con la configurazione e dovresti vedere il server MCP elencato quando esegui il comando ‘slash’ /mcp in Codex CLI.

In Codex CLI puoi chiedere a Codex di fare riferimento a questo Discourse per informazioni - specialmente informazioni a cui hai accesso ma che non sono pubbliche - questo verificherà che si stia connettendo come te.

Modifica delle impostazioni

A un certo punto potresti voler modificare le impostazioni per aggiungere la possibilità di scrivere su Discourse, e lo faresti nelle impostazioni di Discourse.

In modo confuso, ci sono due posti in cui vengono memorizzate le impostazioni e tra la documentazione di Codex e quella di Discourse è davvero molto confuso, specialmente per capire quali parti appartengono a Codex CLI e quali fanno parte del server STDIO MCP stesso.

Ci sono due file principali:

  1. =CODEX-CONFIG= - questo è il file di configurazione di Codex CLI, che include le impostazioni del server MCP.

  2. =MCP-CONFIG= - questo è il profilo per il server Discourse MCP, che include la chiave API e altre impostazioni per la connessione a Discourse.

Impostazioni di Codex CLI

Le impostazioni per la connessione a MCP sono in =CODEX-CONFIG= e dovrebbero assomigliare a questo. Se vuoi aggiungere opzioni al server MCP, le aggiungi qui.

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

Documentazione delle impostazioni di Codex MCP Model Context Protocol

Impostazioni di Discourse MCP

Le impostazioni per il server Discourse MCP stesso sono in =CODEX-CONFIG=

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

Riferimento alla documentazione delle impostazioni di Discourse MCP GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub

2 Mi Piace
Discourse MCP is here!