Connecter Skillry MCP dans Codex (CLI, application ChatGPT et extension IDE)

La réponse courte

1Lancez codex mcp add skillry -- npx --yes skillry-cli@latest mcp une fois ; sous Windows, enveloppez le lancement dans cmd /c.
2Confirmez avec codex mcp list, ou tapez /mcp dans l’interface Codex.
3L’application ChatGPT de bureau et l’extension IDE partagent l’entrée : configurez une fois, utilisez dans les trois.

Commencez ici :L’ajouter Le vérifier Autoriser Ça ne marche pas

Avant de commencer

Vérifié par rapport à la documentation officielle le 28 octobre 2026. Pas encore exécuté sur une installation réelle de ce client ; si une étape diffère sur votre machine, utilisez Signaler un problème en bas de page.

Codex connecté : la CLI, l’application ChatGPT de bureau avec Codex, ou l’extension IDE. Ils partagent une seule configuration.
Node.js 22 ou plus récent (node --version). Codex lance le serveur avec npx.
Un .codex/config.toml au niveau du projet fonctionne aussi, mais seulement dans les projets marqués comme fiables. Ce guide utilise le fichier global.

Ajouter Skillry à Codex

Le plus rapide quand vous utilisez la Codex CLI

1
Lancez ceci dans n’importe quel terminal :
macOS
```
codex mcp add skillry -- npx --yes skillry-cli@latest mcp
```
Vous devriez voir : Aucune erreur, et codex mcp list inclut maintenant skillry.
2
Sous Windows, lancez plutôt ceci pour que Windows puisse démarrer npx :
Windows (PowerShell ou Invite de commandes)
```
codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Relancez Codex, ou redémarrez l’application ou l’extension si l’une est ouverte.
Vous devriez voir : skillry dans la liste /mcp à l’intérieur de Codex.

Pas de terminal nécessaire

1
Dans l’application ChatGPT de bureau, ouvrez Settings, puis MCP servers. Dans l’extension IDE, ouvrez le menu engrenage, puis MCP servers.
2
Choisissez Add server. Saisissez le nom skillry, choisissez STDIO, et saisissez la commande npx --yes skillry-cli@latest mcp (sous Windows cmd /c npx --yes skillry-cli@latest mcp).
3
Enregistrez, puis choisissez Restart dans l’application ou Restart extension dans l’IDE.
Vous devriez voir : skillry listé comme activé dans la liste des serveurs MCP.

Quand vous gardez vos réglages Codex dans le fichier

1
Ouvrez ~/.codex/config.toml dans un éditeur ; créez-le s’il n’existe pas.
2
Ajoutez cette table à la fin. Si une table [mcp_servers.skillry] existe déjà, remplacez-la.
macOS
```
[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]
```

Sous Windows, utilisez plutôt cette table.

Windows

[mcp_servers.skillry]
command = "cmd"
args = ["/c","npx","--yes","skillry-cli@latest","mcp"]

4
Si le premier démarrage expire, ajoutez startup_timeout_sec = 60 sous la table. La valeur par défaut est 10 secondes, et la première exécution de npx télécharge le paquet.
5
Enregistrez, puis relancez Codex.
Vous devriez voir : skillry dans codex mcp list et dans /mcp.

Vérifier que Codex est connecté

1
Dans un terminal, listez les serveurs configurés :
Terminal
```
codex mcp list
```
Vous devriez voir : skillry avec la commande npx que vous avez saisie.
2
Dans l’interface Codex, tapez /mcp.
Vous devriez voir : skillry parmi les serveurs actifs, avec ses outils.

Essayez votre première recherche

La recherche ne demande aucun compte : c’est donc le moyen le plus rapide de prouver que la connexion fonctionne.

1
Ouvrez une nouvelle conversation dans Codex et collez cette demande.
Prompt pour votre agent
```
Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.
```
Vous devriez voir : Trois Skills candidats, chacun avec un lien d’aperçu, les entrées nécessaires, ses dépendances et d’éventuels coûts externes. Rien n’est installé.
2
Si l’agent répond qu’il n’a pas d’outil Skillry, ou si la demande reste bloquée, allez à Ça ne marche pas.

Autoriser au moment d’installer

L’installation vérifie votre compte Skillry. Vous ne tapez pas de mot de passe et ne collez aucune clé dans l’agent : la première fois, il ouvre une page dans votre navigateur et vous approuvez là.

1
Demandez à Codex d’installer le Skill que vous avez choisi, par exemple Installe-le pour ce projet.
Vous devriez voir : L’agent indique qu’il doit connecter votre compte et ouvre votre navigateur. Dans un client en terminal, il peut n’afficher que le lien ; ouvrez-le vous-même.
2
Vérifiez que le code d’appareil affiché sur la page correspond à celui que montre l’agent, connectez-vous à Skillry si on vous le demande, puis choisissez Approve.
Vous devriez voir : Authorization approved, avec une note vous invitant à revenir dans votre agent. L’agent le remarque en quelques secondes et termine l’installation.

L’approbation dure 7 jours et est stockée dans le trousseau de votre système (Keychain sur macOS, Gestionnaire d’identifiants sur Windows). Quand elle expire, l’agent vous demande simplement d’approuver à nouveau. Pour vous déconnecter plus tôt, demandez à l’agent de déconnecter votre compte Skillry.

Si Codex ne voit pas Skillry

Ce que vous voyez	Cause probable	Que faire
`skillry` manque dans `codex mcp list`	La table est allée dans un fichier de projet d’un projet non fiable, ou le nom de la table contient une faute	Mettez la table dans `~/.codex/config.toml` et vérifiez qu’elle s’écrit exactement `[mcp_servers.skillry]`.
Le serveur n’est jamais prêt, ou Codex signale un délai de démarrage dépassé	Le premier téléchargement `npx` a pris plus longtemps que `startup_timeout_sec` (10 secondes par défaut)	Ajoutez `startup_timeout_sec = 60` à la table, ou lancez une fois la commande de lancement à la main pour que le paquet soit en cache.
Fonctionne dans la CLI mais pas dans l’application ChatGPT	L’application était ouverte pendant la modification du fichier	Quittez et rouvrez l’application ChatGPT de bureau, ou choisissez Restart extension dans l’IDE.
Le serveur est listé mais apparaît en échec, ou ne démarre jamais	`npx` n’est pas installé, Node.js est antérieur à la version 22, ou le premier démarrage a expiré pendant le téléchargement du paquet	Lancez `node --version` et `npx --version` dans un terminal. Puis lancez une fois à la main `npx --yes skillry-cli@latest mcp`, attendez qu’il démarre, appuyez sur Ctrl+C et réessayez le client : le paquet est maintenant en cache.
Sous Windows, le serveur se ferme dès qu’il démarre	L’entrée lance `npx` directement, et Windows a besoin d’un shell pour l’exécuter	Utilisez l’entrée Windows de cette page : la commande est `cmd` et les arguments commencent par `/c`, `npx`.
La page du navigateur dit que la demande est invalide ou expirée	Le code d’appareil a été approuvé trop tard, ou appartient à une tentative précédente	Demandez à l’agent de se reconnecter et approuvez le nouveau code en quelques minutes.
L’installation s’arrête avec un message Premium ou d’achat	Le Skill est Premium et votre compte n’a ni abonnement ni achat pour lui	Suivez le lien que montre l’agent pour acheter le Skill ou vous abonner, puis redemandez. Rien n’est facturé avant cela.

Retirer ou déconnecter

1
Supprimez la table [mcp_servers.skillry] de ~/.codex/config.toml, ou utilisez la commande de suppression que codex mcp --help liste pour votre version. Pour le désactiver sans le supprimer, ajoutez enabled = false à la table.
2
Redémarrez Codex, l’application ou l’extension.
Vous devriez voir : skillry absent de codex mcp list.

Supprimer l’entrée ne vous déconnecte pas de Skillry. Pour révoquer aussi l’approbation stockée, demandez d’abord à l’agent de déconnecter votre compte Skillry, ou supprimez l’entrée et laissez l’approbation expirer au bout de 7 jours.

Référence

Élément	macOS	Windows
Fichier de configuration global	`~/.codex/config.toml`	`%USERPROFILE%\.codex\config.toml`
Fichier de configuration du projet	`.codex/config.toml` (projets fiables seulement)	idem
Commande de lancement	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Vérifier	`codex mcp list` ou `/mcp`	idem

La table que Codex stocke (macOS)

[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]

Les délais, les listes d’outils autorisés et les modes d’approbation sont dans la documentation MCP officielle de Codex.

Questions fréquentes

Dois-je le configurer séparément pour l’application ChatGPT de bureau ?

Non. L’application, la CLI et l’extension IDE lisent le même config.toml. Redémarrez l’application après l’avoir modifié.

Puis-je l’utiliser dans un seul projet ?

Oui. Dans un projet fiable, mettez la table dans .codex/config.toml à l’intérieur de ce projet plutôt que dans le fichier global.

Pourquoi le premier démarrage est-il lent ?

La première exécution de npx télécharge skillry-cli. Augmentez startup_timeout_sec ou lancez une fois la commande de lancement à la main ; ensuite il démarre immédiatement.

Sources

Ce guide vous a-t-il aidé ?

PrécédentClaude Code SuivantCursor