Configuration de Discourse MCP dans l'interface de ligne de commande OpenAI Codex

Wiki de la communauté Utilisateurs
, ,
1

J’expérimentais avec Discourse MCP mais j’ai constaté que la documentation existante sur Meta pour 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 Codex et quelles parties sont Discourse MCP ?
  • où dois-je placer les paramètres comme read_only: false ?

Donc, après avoir pas mal 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 jours à venir. Si vous souhaitez utiliser d’autres clients MCP, faites-le moi savoir dans les réponses et j’essaierai de vous aider.

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. Celui-ci 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 recopiez 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 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émarrerez Codex CLI.

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

3. Redémarrer Codex CLI

Redémarrez complètement Codex afin 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.

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 les documents 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 se connecter à 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

2 « J'aime »
Discourse MCP is here!