Configurer Codex | Weegloo Docs

Codex est un agent de codage qui s'exécute dans le terminal. En y connectant le serveur MCP de WEEGLOO, Codex peut créer, lire et modifier directement des ressources comme Content Type, Content ou Media. L'outil d'installation installe aussi des Skills et des Rules en plus du serveur MCP, ce qui aide Codex à utiliser l'API de WEEGLOO de la manière prévue. Les Skills sont des guides qui expliquent comment bien accomplir une tâche précise, et les Rules sont des règles à respecter tout au long du travail. Vous configurez tout en une fois avec l'outil d'installation, puis il ne vous reste qu'à terminer l'authentification de la connexion MCP.

Pour en savoir plus sur le serveur MCP et sur les Skills et les Rules, reportez-vous respectivement aux pages MCP et Skills et Rules. Cette page ne traite que de la manière de se connecter à Codex.

Prérequis

Node.js est nécessaire pour exécuter les commandes d'installation ci-dessous. Vérifiez d'abord, avec les commandes suivantes, s'il est installé et si sa version est 18 ou ultérieure.

Terminal

node --version # OK si v18 ou version ultérieure npx --version # OK si une version s'affiche

Si Node.js est installé mais que npx ne l'est pas, mettez npm à jour vers sa dernière version avec la commande ci-dessous. La mise à jour de npm installe npx en même temps.

Terminal

npm install -g npm@latest

Si Node.js n'est pas installé ou si sa version est trop ancienne, installez Node.js selon la méthode adaptée à votre système d'exploitation.

Terminal

brew install node

Si vous n'avez pas Homebrew, installez-le d'abord depuis brew.sh, ou téléchargez Node.js directement depuis nodejs.org.

Terminal

winget install OpenJS.NodeJS.LTS

Si winget est absent ou n'est pas reconnu, téléchargez le fichier d'installation LTS depuis nodejs.org. Après l'installation, vous devez rouvrir le terminal.

Les paquets des distributions peuvent être anciens ; nous recommandons donc l'installation via nvm, utilisable sur plusieurs distributions.

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

Pour télécharger le fichier d'installation directement, rendez-vous sur nodejs.org.

Codex doit également être installé de façon à pouvoir être lancé dans le terminal avec la commande codex. Si ce n'est pas encore le cas, consultez le guide d'installation de Codex CLI.

Se connecter

Pour l'installation par défaut, il vous suffit de copier la commande d'installation de cette page et de l'exécuter une fois dans le terminal. Pour choisir vous-même chaque étape de l'installation, ouvrez Installation personnalisée.

Emplacement d'installation

Installer MCP et Skills

Copiez la commande d'installation et exécutez-la dans le terminal.

Terminal

$ npx weegloo@latest -y \ --agent codex \ --token <Personal Access Token>

Authentifier la connexion MCP

Authentifiez-vous dans l'ordre ci-dessous.

En exécutant la commande ci-dessous dans le terminal, la page d'authentification WEEGLOO s'ouvre dans votre navigateur.

Terminal
codex mcp login weegloo
Sur la page d'authentification WEEGLOO qui s'ouvre, copiez le token avec le bouton Copier le token ci-dessous, collez-le, puis cliquez sur Connecter le serveur. Un agent qui était déjà en cours d'exécution doit être redémarré une fois l'authentification terminée pour que les changements prennent effet.

Installer MCP et Skills

Copiez la commande d'installation et exécutez-la dans le terminal. Vous devez impérativement l'exécuter dans le dossier du projet que vous voulez connecter.

Terminal

$ npx weegloo@latest -y \ --agent codex \ --location project \ --token <Personal Access Token>

Authentifier la connexion MCP

Authentifiez-vous dans l'ordre ci-dessous.

En exécutant la commande ci-dessous dans le terminal, la page d'authentification WEEGLOO s'ouvre dans votre navigateur.

Terminal
codex mcp login weegloo
Sur la page d'authentification WEEGLOO qui s'ouvre, copiez le token avec le bouton Copier le token ci-dessous, collez-le, puis cliquez sur Connecter le serveur. Un agent qui était déjà en cours d'exécution doit être redémarré une fois l'authentification terminée pour que les changements prennent effet.

Exécutez npx weegloo en mode interactif et installez en choisissant vous-même les éléments demandés.

Emplacement d'installation

Exécuter l'outil d'installation

Exécutez la commande ci-dessous dans le terminal et choisissez les éléments demandés les uns après les autres. Là où le token est demandé, copiez le token avec le bouton Copier le token ci-dessous et collez-le.

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Codex ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← token copié ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Global … ✔ Installation complete!

Authentifier la connexion MCP

Authentifiez-vous dans l'ordre ci-dessous.

En exécutant la commande ci-dessous dans le terminal, la page d'authentification WEEGLOO s'ouvre dans votre navigateur.

Terminal
codex mcp login weegloo
Sur la page d'authentification WEEGLOO qui s'ouvre, copiez le token avec le bouton Copier le token ci-dessous, collez-le, puis cliquez sur Connecter le serveur. Un agent qui était déjà en cours d'exécution doit être redémarré une fois l'authentification terminée pour que les changements prennent effet.

Exécuter l'outil d'installation

Rendez-vous dans le dossier du projet que vous voulez connecter, puis exécutez la commande ci-dessous dans ce dossier et choisissez les éléments demandés les uns après les autres. Là où le token est demandé, copiez le token avec le bouton Copier le token ci-dessous et collez-le. Veillez à l'exécuter dans ce dossier de projet.

Terminal

npx weegloo@latest

Terminal

Authentifier la connexion MCP

Authentifiez-vous dans l'ordre ci-dessous.

En exécutant la commande ci-dessous dans le terminal, la page d'authentification WEEGLOO s'ouvre dans votre navigateur.

Terminal
codex mcp login weegloo
Sur la page d'authentification WEEGLOO qui s'ouvre, copiez le token avec le bouton Copier le token ci-dessous, collez-le, puis cliquez sur Connecter le serveur. Un agent qui était déjà en cours d'exécution doit être redémarré une fois l'authentification terminée pour que les changements prennent effet.

Fichier de configuration du serveur MCP

L'outil d'installation crée et gère automatiquement le fichier de configuration, vous n'avez donc pas besoin de le vérifier vous-même. Le contenu ci-dessous est un document de référence destiné aux utilisateurs qui ont besoin de la structure et des chemins précis du fichier de configuration.

Le serveur weegloo se connecte en HTTP à https://ai.weegloo.com/mcp, et le serveur weegloo-upload, qui gère les fichiers, s'exécute avec npx et utilise le Personal Access Token pour l'authentification. Avec une installation Global, l'enregistrement se fait dans ~/.codex/config.toml, dans le dossier personnel de l'utilisateur ; avec une installation Projet, il se fait dans .codex/config.toml, à l'intérieur du dossier du projet.

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp"
 
[mcp_servers.weegloo-upload]
command = "npx"
args = ["-y", "weegloo-upload"]
 
[mcp_servers.weegloo-upload.env]
UPLOAD_API_URL = "https://upload.weegloo.com/v1"
AUTH_BEARER_TOKEN = "<Personal Access Token>"

Pour changer de groupe de serveurs, ajoutez la valeur group à la fin de l'url du serveur weegloo. Par exemple, pour utiliser tous les outils, indiquez https://ai.weegloo.com/mcp?group=all. Pour la composition des outils par groupe, reportez-vous à Groupes de serveurs MCP.

Avec une installation Projet, l'outil d'installation ajoute aussi une entrée dans ~/.codex/config.toml, dans le dossier personnel de l'utilisateur. Codex ne lit le fichier .codex/config.toml d'un dossier que pour les projets qu'il approuve. Sans cette entrée, le serveur MCP que vous venez d'enregistrer serait ignoré ; l'outil d'installation marque donc ce projet comme approuvé. À la place du chemin figure le chemin réel du dossier de projet dans lequel l'installation a été exécutée.

[projects."/Users/jimin/projects/jeju-shop"]
trust_level = "trusted"

Skills

L'outil d'installation place chaque Skill sous la forme d'un répertoire sous .agents/skills/. L'installation globale utilise ~/.agents/skills/, l'installation par projet le dossier .agents/skills/ du projet, et Codex lit les Skills à cet emplacement.

Rules

Codex n'a pas de concept distinct de Rules. L'outil d'installation place donc le contenu correspondant aux Rules, c'est-à-dire le contenu qui joue le même rôle que les Rules de Claude Code, dans un fichier AGENTS.md. L'installation globale utilise ~/.codex/AGENTS.md, l'installation par projet le fichier AGENTS.md du projet.

Étapes suivantes

MCP : présente les bases de la connexion, comme les groupes de serveurs et le serveur de téléversement de fichiers.
Skills et Rules : présente ce que sont les Skills et les Rules que l'outil d'installation installe en même temps.
Rester à jour : présente comment maintenir à jour les Skills et les Rules installés.
Migrer des pages statiques avec l'IA : suit le déroulé permettant de migrer une page réelle vers un service basé sur le contenu à l'aide du MCP connecté.