Ho fatto esperimenti 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’ confusionario capire quali parti della documentazione sarebbero state applicabili:
- si usa
npxonpm install? - quali parti della configurazione sono di Codex e quali di Discourse MCP?
- dove devo inserire le impostazioni come
read_only: false?
Quindi, dopo un bel po’ di prove, ecco una guida testata per installare Discourse MCP in Codex CLI, e nei prossimi giorni seguirà una guida per Claude Code CLI e opencode. Se ci sono altri client MCP che vorreste usare, fatemelo sapere nelle risposte e cercherò di aiutarvi.
Modifica: 2026.03.13 - Ho scritto una guida per
opencodeche ha un formato di file di configurazione leggermente diverso per gli MCP che potrebbe confondere le persone.
Prerequisiti:
- Node.js installato (si consiglia 24 LTS)
- Codex CLI installato
- Accesso a https://discourse.example.com come utente normale
È importante rendersi conto che ci sono tre componenti separati qui:
- Il forum Discourse remoto, che è la fonte dei dati e la destinazione per le azioni.
- Il server Discourse MCP, che è uno strumento open-source in esecuzione 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.
- 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 i dati crittografati, che provano 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 all’interno di Codex CLI stesso)
codex mcp add discourse \
-- npx -y @discourse/mcp@latest \
--profile =MCP-CONFIG=
Viene installato come server STDIO, quindi verrà lanciato su richiesta con npx da Codex CLI all’avvio di 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 sta connettendo come te.
4. Abilita le Funzionalità di Scrittura (Opzionale)
Per impostazione predefinita, il server Discourse MCP viene eseguito in modalità di sola lettura. Per abilitare le operazioni di scrittura (creazione di post, argomenti, utenti, ecc.), è necessario aggiungere due flag al file JSON del profilo.
Modifica il profilo Discourse in =MCP-CONFIG= e aggiungi \"read_only\": false e \"allow_writes\": true come fratelli dell’array auth_pairs:
{
"read_only": false,
"allow_writes": true,
"auth_pairs": [
{
"site": "=DISCOURSE-FORUM=",
"user_api_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"user_api_client_id": "discourse-mcp"
}
]
}
Esempio:
{
"read_only": false,
"allow_writes": true,
"auth_pairs": [
{
"site": "https://meta.discourse.org",
"user_api_key": "abc123def456ghi789jkl012mno345pqr",
"user_api_client_id": "discourse-mcp"
}
]
}
Dopo aver aggiunto questi flag, riavvia OpenCode CLI affinché le modifiche abbiano effetto. Il server MCP consentirà ora operazioni di scrittura come:
- Creazione e aggiornamento di argomenti
- Creazione di post e risposte
- Gestione delle bozze
- Caricamento di file
- Creazione di categorie (se si dispone dell’autorizzazione)
- Gestione degli utenti (se si dispone dell’autorizzazione di amministratore)
Attenzione: Le operazioni di scrittura utilizzeranno le autorizzazioni del tuo account utente. Qualsiasi contenuto creato apparirà come se fosse stato creato manualmente. Usa le funzionalità di scrittura in modo responsabile.
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.
Per confusione, ci sono due posti in cui vengono archiviate le impostazioni e tra la documentazione di Codex e quella di Discourse è davvero piuttosto confuso, specialmente per capire quali parti appartengono a Codex CLI e quali fanno parte del server STDIO MCP stesso.
Ci sono due file principali:
-
=CODEX-CONFIG=- questo è il file di configurazione di Codex CLI, che include le impostazioni del server MCP. -
=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 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