Connecter Skillry MCP dans Claude Code (macOS et Windows)

La réponse courte

1Lancez claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp une fois dans n’importe quel terminal. Sans --scope user, le serveur n’existe que dans le dossier d’où vous l’avez lancé.
2Confirmez avec claude mcp get skillry. La ligne d’état doit indiquer ✔ Connected.
3L’entrée vit dans ~/.claude.json (Windows : %USERPROFILE%\.claude.json). Vous pouvez aussi y coller le JSON à la main.

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

Avant de commencer

Testé sur macOS avec Claude Code 2.1.296 le 28 octobre 2026. La commande Windows suit la documentation officielle et n’a pas encore été exécutée sur une vraie machine.

Claude Code installé et connecté. claude --version doit afficher une version 2.x.
Node.js 22 ou plus récent (node --version). Claude Code lance le serveur avec npx, fourni avec Node.
Rien à télécharger depuis Skillry : npx récupère le paquet au premier démarrage du serveur.

Claude Code stocke un serveur dans l’une de trois portées. Ce guide utilise la portée user, pour que Skillry soit présent dans tous les projets.

Portée	Option	Stocké dans	À utiliser quand
User	`--scope user`	`~/.claude.json`, au premier niveau	Vous voulez Skillry dans tous les projets. Ce guide.
Local (par défaut)	aucune	`~/.claude.json`, sous le chemin du projet courant	Vous le voulez dans ce dossier seulement.
Project	`--scope project`	`.mcp.json` dans le dépôt	Vous voulez que vos coéquipiers l’obtiennent via le dépôt. Chacun l’approuve au premier lancement.

Ajouter Skillry à Claude Code

Le plus rapide. Fonctionne dans tout shell, y compris PowerShell et l’Invite de commandes

1
Ouvrez un terminal dans n’importe quel dossier et lancez :
macOS
```
claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp
```
Vous devriez voir : Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config, puis File modified: ~/.claude.json.
2
Sous Windows, lancez plutôt ceci. L’enveloppe cmd /c permet à Windows de démarrer npx, qui est un script et non un programme.
Windows (PowerShell ou Invite de commandes)
```
claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Démarrez une nouvelle session Claude Code, ou tapez /mcp dans une session déjà ouverte.
Vous devriez voir : skillry dans la liste /mcp. Sélectionnez-le pour voir ses 12 outils.

Quand vous préférez gérer le fichier vous-même

1
Ouvrez ~/.claude.json dans un éditeur. Sous Windows, le fichier est %USERPROFILE%\.claude.json. Claude Code le crée au premier lancement.
2
Fusionnez ceci dans l’objet mcpServers de premier niveau, en gardant les serveurs déjà présents.
macOS
```
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}
```
Premier niveau signifie à côté des autres clés à la racine du fichier. Une entrée sous un chemin de projet ne se charge que dans ce projet.

Sous Windows, utilisez plutôt cette entrée.

Windows

{
  "mcpServers": {
    "skillry": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

4
Enregistrez le fichier et démarrez une nouvelle session.
Vous devriez voir : skillry dans la liste /mcp.

Vérifier que Claude Code est connecté

1
Dans un terminal, lancez :
Terminal
```
claude mcp get skillry
```
Vous devriez voir : Scope: User config (available in all your projects), Status: ✔ Connected, et la commande npx que vous avez ajoutée.
2
Pour voir tous les serveurs avec leur état d’un coup, lancez claude mcp list. Dans une session, /mcp montre la même liste et permet d’ouvrir les outils d’un serveur.

La première vérification démarre le serveur, et le premier démarrage télécharge skillry-cli. Laissez-lui dix secondes ou plus. Un ✘ Failed to connect qui persiste ensuite signifie que Node ou npx manque ; voir ci-dessous.

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 Claude Code 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 à Claude Code 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 /mcp ne liste pas Skillry

Ce que vous voyez	Cause probable	Que faire
`/mcp` ne liste pas skillry	Il a été ajouté à la portée locale dans un autre dossier, ou la session a démarré avant l’ajout	Lancez `claude mcp get skillry`. S’il indique `Scope: Local config`, supprimez-le et rajoutez-le avec `--scope user`. S’il indique la portée utilisateur, démarrez une nouvelle session.
`claude mcp add` affiche « was not saved »	Claude Code n’a pas pu écrire `~/.claude.json`	Fermez les autres sessions Claude Code, vérifiez que le fichier n’est pas en lecture seule, et relancez la commande.
Connecté sur votre Mac, en échec sur votre PC Windows	L’entrée Windows lance `npx` sans `cmd /c`	Lancez `claude mcp remove skillry -s user`, puis ajoutez la commande Windows de cette page.
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
Retirez le serveur de votre configuration utilisateur :
Terminal
```
claude mcp remove skillry -s user
```
Vous devriez voir : Removed MCP server skillry from user config.
2
Pour garder le serveur mais le désactiver pour un projet, basculez-le dans /mcp ; Claude Code s’en souvient par projet.

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 (portées user et local)	`~/.claude.json`	`%USERPROFILE%\.claude.json`
Commande de lancement	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Vérifier	`claude mcp get skillry`	idem
Retirer	`claude mcp remove skillry -s user`	idem

L’entrée que Claude Code stocke (macOS)

{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

La priorité des portées, l’approbation par projet et toutes les autres options sont dans la documentation MCP officielle.

Questions fréquentes

Dois-je lancer la commande dans chaque projet ?

Non. --scope user rend Skillry disponible dans tous vos projets. La portée locale par défaut le lierait au dossier d’où vous avez lancé la commande.

Claude Code a-t-il besoin d’un redémarrage ?

Une nouvelle session prend le serveur en compte. Dans une session ouverte, /mcp le montre après la vérification d’état.

Mon équipe peut-elle partager l’entrée ?

Oui. --scope project l’écrit dans .mcp.json dans le dépôt, et chaque coéquipier l’approuve la première fois qu’il ouvre Claude Code là.

Sources

Ce guide vous a-t-il aidé ?

PrécédentVue d’ensemble SuivantCodex