Configuration de Discourse MCP dans le CLI OpenAI Codex

Wiki de la communauté Utilisateurs
, ,
1

J’expérimentais avec Discourse MCP, mais j’ai constaté que la documentation existante sur Meta concernant son utilisation n’incluait rien pour Codex CLI, et il était un peu confus de déterminer quelles parties de la documentation s’appliqueraient :

  • Est-ce npx ou npm install ?
  • Quelles parties de la configuration sont pour Codex et quelles parties sont pour Discourse MCP ?
  • Où dois-je placer les paramètres comme read_only: false ?

Donc, après avoir beaucoup tâtonné, voici un guide testé pour installer Discourse MCP dans Codex CLI, et je fournirai un guide pour Claude Code CLI et opencode dans les prochains jours. Si vous souhaitez utiliser d’autres clients MCP, faites-le moi savoir dans les réponses et j’essaierai de vous aider.

Édition : 2026.03.13 - J’ai rédigé un guide pour opencode qui possède un format de fichier de configuration légèrement différent pour les MCP, ce qui pourrait prêter à confusion pour certains.

Prérequis :

Il est important de réaliser qu’il y a trois composants distincts ici :

  1. Le forum Discourse distant, qui est la source des données et la cible des actions.

  1. Le serveur Discourse MCP, qui est un outil open-source exécuté localement qui se connecte à Discourse et fournit une API pour que Codex interagisse avec Discourse. Il est installé comme un serveur STDIO et lancé à la demande par Codex CLI.

  1. Codex CLI, qui est le client MCP qui se connecte au serveur MCP et fournit l’interface pour interagir avec Discourse via l’API MCP.

1. Générer la clé API Utilisateur

Ceci vous authentifiera auprès de Discourse et c’est ainsi que vous obtiendrez votre clé API. npx téléchargera et exécutera le code, rien n’a besoin d’être installé au sens traditionnel.

Dans un terminal, exécutez :

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

Approuvez le consentement du navigateur et copiez les données chiffrées, ce qui prouve votre capacité à vous connecter et génère une clé API qui est enregistrée dans =MCP-CONFIG= pour être utilisée par le serveur MCP.

La clé API aura le même niveau d’accès au forum que celui que vous avez en tant qu’utilisateur.

2. Ajouter le serveur MCP à Codex CLI :

Exécutez ceci dans un terminal (pas dans Codex CLI lui-même)

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

Il est installé comme un serveur STDIO, il sera donc lancé à la demande avec npx par Codex CLI lorsque vous démarrez Codex CLI.

Il est configuré pour utiliser le profil à =MCP-CONFIG= et par défaut il est en lecture seule.

3. Redémarrer Codex CLI

Redémarrez entièrement Codex pour qu’il recharge config.toml et le profil.

S’il démarre sans erreurs, il n’y a aucun problème avec la configuration et vous devriez voir le serveur MCP listé lorsque vous exécutez la commande ‘slash’ /mcp dans Codex CLI.

Dans Codex CLI, vous pouvez demander à Codex de se référer à ce Discourse pour obtenir des informations - en particulier des informations auxquelles vous avez accès mais qui ne sont pas publiques - cela vérifiera qu’il se connecte en tant que vous.

4. Activer les fonctionnalités d’écriture (Optionnel)

Par défaut, le serveur Discourse MCP s’exécute en mode lecture seule. Pour activer les opérations d’écriture (création de messages, de sujets, d’utilisateurs, etc.), vous devez ajouter deux indicateurs à votre fichier de profil JSON.

Modifiez le profil Discourse à =MCP-CONFIG= et ajoutez \"read_only\": false et \"allow_writes\": true comme frères et sœurs du tableau auth_pairs :

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

Exemple :

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

Après avoir ajouté ces indicateurs, redémarrez OpenCode CLI pour que les modifications prennent effet. Le serveur MCP autorisera désormais les opérations d’écriture telles que :

  • Création et mise à jour de sujets
  • Création de messages et de réponses
  • Gestion des brouillons
  • Téléchargement de fichiers
  • Création de catégories (si vous avez la permission)
  • Gestion des utilisateurs (si vous avez la permission d’administrateur)

Avertissement : Les opérations d’écriture utiliseront les permissions de votre compte utilisateur. Tout contenu créé apparaîtra comme si vous l’aviez créé manuellement. Utilisez les fonctionnalités d’écriture de manière responsable.

Modification des paramètres

À un moment donné, vous voudrez peut-être modifier les paramètres afin d’ajouter la possibilité d’écrire sur Discourse, et vous le feriez dans les paramètres Discourse.

De manière déroutante, il y a deux endroits où les paramètres sont stockés et entre les documents Codex et Discourse, c’est vraiment assez confus, surtout pour déterminer quelles parties appartiennent à Codex CLI et lesquelles font partie du serveur STDIO MCP lui-même.

Il y a deux fichiers principaux :

  1. =CODEX-CONFIG= - C’est le fichier de configuration de Codex CLI, qui inclut les paramètres du serveur MCP.

  2. =MCP-CONFIG= - C’est le profil pour le serveur Discourse MCP, qui inclut la clé API et d’autres paramètres pour la connexion à Discourse.

Paramètres de Codex CLI

Les paramètres pour se connecter au MCP sont dans =CODEX-CONFIG= et devraient ressembler à ceci. Si vous souhaitez ajouter des options au serveur MCP, vous les ajoutez ici.

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

Documentation des paramètres Codex MCP Model Context Protocol

Paramètres de Discourse MCP

Les paramètres pour le serveur Discourse MCP lui-même sont dans =CODEX-CONFIG=

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

Référence de la documentation des paramètres de Discourse MCP GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub

3 « J'aime »
Discourse MCP is here!
Discourse MCP Setup in OpenCode CLI