Ajoutez un serveur MCP à Claude Code dans le terminal ou dans VS Code. Suivez les commandes exactes pour les serveurs HTTP distants et stdio locaux, les trois portées, la connexion OAuth, un exemple d’image et de vidéo avec PicassoIA, et les solutions pour tout serveur qui ne parvient pas à se connecter.
Claude Code peut lire vos fichiers et exécuter des commandes shell dès l’installation, mais il ne voit pas votre gestionnaire de tickets, votre base de données ou votre générateur d’images tant que vous ne les avez pas connectés. Cette connexion est un serveur MCP. MCP, abréviation de Model Context Protocol, est le standard ouvert qui permet à Claude Code d’appeler des services externes comme s’ils étaient intégrés. L’ajout d’un serveur demande une seule commande, et le même serveur apparaît ensuite dans le terminal comme dans l’extension VS Code.
Cet article présente les commandes exactes, les trois portées qui déterminent qui accède à un serveur, les détails OAuth et les jetons qui posent souvent problème, ainsi qu’un exemple concret avec la connexion image et vidéo de PicassoIA. Les commandes et options ci-dessous ont été vérifiées par rapport à la documentation actuelle de Claude Code le 6 octobre 2026, elles correspondent donc à ce que vous verrez dans votre propre terminal.
💡 En bref : pour un serveur hébergé, exécutez
claude mcp add --transport http <name> <url>. Pour un serveur local, exécutezclaude mcp add --transport stdio <name> -- <command>. Tapez ensuite/mcpdans Claude Code et vérifiez que le serveur affiche Connected.
Il vous faut Claude Code lui-même. Pour passer par VS Code, vous avez aussi besoin de VS Code 1.94.0 ou une version ultérieure avec l’extension Claude Code. Vérifiez la version de la CLI avec claude --version, car certaines fonctionnalités en dépendent :
/mcp reconnect all nécessite la v2.1.284 ou une version ultérieureUne installation ancienne est la première chose à écarter lorsqu’une étape ci-dessous ne fonctionne pas. Il vous faut aussi les informations du serveur, qui dépendent de l’endroit où il s’exécute. Un serveur distant vous donne une URL, plus soit un jeton, soit une connexion via le navigateur. Un serveur local vous donne une commande de lancement, souvent via npx, donc Node.js doit être installé.
L’option --transport indique à Claude Code comment communiquer avec le serveur. Il existe trois choix.
| Transport | Lieu d’exécution du serveur | Quand l’utiliser | Statut |
|---|---|---|---|
http | URL distante | Un service hébergé vous fournit une URL | Le choix actuel pour les serveurs hébergés |
sse | URL distante | L’éditeur ne publie qu’un point de terminaison /sse | Obsolète |
stdio | Votre machine | Le serveur est un programme que Claude Code lance | Standard pour les outils locaux |
Une règle rapide : une URL se terminant par /mcp désigne HTTP, une URL se terminant par /sse désigne l’ancien transport SSE (vérifiez si l’éditeur propose désormais une URL HTTP), et une commande npx désigne stdio.
La CLI est la voie la plus rapide, et tout ce que vous faites ici est aussi ce que lit l’extension VS Code. Ouvrez un terminal dans le dossier de votre projet, ou dans n’importe quel dossier si vous prévoyez d’utiliser la portée utilisateur décrite plus loin.
Le modèle est claude mcp add --transport http <name> <url>. Voici un vrai serveur hébergé :
claude mcp add --transport http notion https://mcp.notion.com/mcp
Le mot notion est le nom que vous choisissez. Il apparaît dans les noms d’outils sous la forme mcp__notion__<tool>, donc gardez-le court et en minuscules. Lorsque le serveur demande un jeton, transmettez-le sous forme d’en-tête :
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
💡 Attention :
claude mcp addenregistre la configuration sans vérifier vos identifiants. Un jeton factice est accepté, et l’échec n’apparaît que plus tard, lorsque le serveur tente de se connecter.
Un serveur stdio est un programme sur votre propre machine que Claude Code démarre et avec lequel il communique via l’entrée et la sortie standard. Le modèle est claude mcp add [options] <name> -- <command> [args...] :
claude mcp add --transport stdio files -- npx -y @modelcontextprotocol/server-filesystem ~/projects
Le double tiret est obligatoire. Tout ce qui le suit est transmis au serveur sans modification, et chaque option de Claude Code (--env, --scope, --transport) doit venir avant le nom. Pour transmettre une variable d’environnement au processus du serveur, utilisez --env :
claude mcp add --transport stdio --env MY_SERVICE_TOKEN=paste-here myservice -- npx -y your-server-package
Remplacez your-server-package par le paquet documenté par l’éditeur. Sous Windows natif (et non WSL), npx nécessite souvent un wrapper pour que le shell puisse le lancer :
claude mcp add --transport stdio files -- cmd /c npx -y @modelcontextprotocol/server-filesystem C:\Users\you\projects
Trois commandes couvrent la gestion au quotidien :
claude mcp list
claude mcp get files
claude mcp remove files
list affiche tous les serveurs configurés, get affiche les détails d’un serveur, et remove le supprime. Si vous avez déjà la définition d’un serveur au format JSON, claude mcp add-json <name> '<json>' vous évite de la convertir en options. Dans une session Claude Code, /mcp affiche l’état en direct et gère la connexion.
L’extension Claude Code et la CLI partagent une même configuration MCP. Vous disposez donc de deux voies, et aucune ne vous enferme.
/mcp dans la zone de chat./mcp et vérifiez que le serveur affiche Connected.L’étape 5 est importante. Les modifications prennent effet dans les conversations que vous démarrez ensuite, donc une discussion déjà ouverte ne verra pas le nouveau serveur.
Ouvrez le terminal intégré avec Ctrl+` (ou Cmd+` sur Mac) et lancez la même commande claude mcp add que vous utiliseriez ailleurs. La boîte de dialogue et la commande du terminal enregistrent dans la même configuration. Voici le serveur distant de GitHub avec un jeton d’accès personnel :
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"
Un serveur avec de mauvais identifiants affiche Failed dans /mcp, tandis qu’un serveur fonctionnel affiche Connected.
💡 Deux fichiers de configuration, deux produits : VS Code dispose de sa propre prise en charge de MCP, avec un fichier situé à
.vscode/mcp.json. Ce fichier appartient au chat intégré de VS Code et utilise un format différent. Claude Code conserve sa propre configuration, donc un serveur déclaré uniquement dans.vscode/mcp.jsonn’apparaîtra pas dans la liste/mcpde Claude Code.
Vous pourriez aussi entendre parler d’un serveur nommé ide. L’extension le lance automatiquement pour ouvrir les différences et lire votre sélection, et il reste masqué dans /mcp car il n’y a rien à configurer.
La portée détermine qui voit le serveur et où il est stocké. Choisissez-la avec --scope (forme courte -s).
| Portée | Chargée dans | Partagée avec l’équipe | Stockée dans |
|---|---|---|---|
| local (par défaut) | Projet actuel uniquement | Non | ~/.claude.json |
| project | Projet actuel uniquement | Oui, via le dépôt | .mcp.json à la racine du projet |
| user | Chaque projet de votre machine | Non | ~/.claude.json |
claude mcp add --transport http stripe --scope local https://mcp.stripe.com
claude mcp add --transport http shared --scope project https://example.com/mcp
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic
Ma règle empirique : utilisez local pour les essais et tout ce qui contient un jeton personnel, project pour les outils dont toute l’équipe a besoin, et user pour la poignée de serveurs que vous voulez dans chaque dépôt.
Un serveur de portée projet vit dans un fichier .mcp.json à la racine du dépôt, que vous committez. Il prend en charge l’expansion des variables d’environnement, si bien que le fichier n’a jamais à contenir un secret :
{
"mcpServers": {
"api-server": {
"type": "http",
"url": "${API_BASE_URL:-https://api.example.com}/mcp",
"headers": {
"Authorization": "Bearer ${API_TOKEN}"
}
}
}
}
${VAR} est remplacé par la valeur de la variable d’environnement, et ${VAR:-default} utilise une valeur par défaut lorsque la variable n’est pas définie. Chaque coéquipier définit API_TOKEN sur sa propre machine.
Les coéquipiers voient une demande d’approbation avant que Claude Code n’utilise un serveur issu de .mcp.json dans une session interactive. Pour réinitialiser ces choix, exécutez claude mcp reset-project-choices. Les exécutions non interactives, comme claude -p, chargent les serveurs de projet sans demander de confirmation, ce qui est bon à retenir pour les tâches CI.
Un serveur peut s’authentifier de trois façons, et la bonne dépend de ce que prend en charge l’éditeur.
| Méthode | Idéale pour | Fonctionnement |
|---|---|---|
| Jeton dans un en-tête | Serveurs qui délivrent un jeton personnel | --header "Authorization: Bearer ..." |
| Variable d’environnement | Serveurs stdio locaux | --env NAME=value |
| OAuth | Serveurs hébergés avec connexion via le navigateur | /mcp, ou claude mcp login <name> |
Pour OAuth, ouvrez /mcp, sélectionnez le serveur et suivez la connexion dans le navigateur. En ligne de commande, claude mcp login <name> fait la même chose, et claude mcp login <name> --no-browser affiche ce dont vous avez besoin sur une machine SSH ou sans interface graphique. Pour effacer les identifiants enregistrés, exécutez claude mcp logout <name>. Certains serveurs nécessitent des identifiants préenregistrés, que vous transmettez avec --client-id, --client-secret et --callback-port lors de l’ajout du serveur.
Deux réflexes évitent la plupart des fuites. D’abord, ne committez jamais un jeton en clair. Placez ${VAR} dans .mcp.json et conservez la valeur réelle dans l’environnement de votre shell. Ensuite, gardez les serveurs qui portent un jeton personnel en portée locale ou utilisateur, là où le fichier reste hors du dépôt.
Un serveur concret rend tout cela moins abstrait. PicassoIA propose une connexion MCP qui permet à un client d’IA de créer des images et des vidéos depuis un chat. Elle expose quatre modèles : PicassoIA Image pour le texte vers image, PicassoIA Image Editor Pro pour les retouches, PicassoIA Video pour des clips à partir d’un texte ou d’une image, et Seedance 2.5 Lite pour la vidéo avec audio.
Les outils reposent sur des tâches asynchrones. Un appel de génération renvoie un identifiant de prédiction dès qu’un GPU accepte la tâche, puis le client interroge get_generation jusqu’à ce que le statut soit succeeded ou failed. Parmi les autres outils figurent edit_image, list_generations, cancel_generation, list_models et get_account. Un compte peut exécuter 5 prédictions à la fois, et cette limite est partagée entre toutes ses connexions MCP. L’accès MCP dépend de votre forfait, donc vérifiez-le sur la page des tarifs de PicassoIA avant de vous y fier.
claude mcp add --transport http picassoia YOUR_PICASSOIA_MCP_URL
/mcp et sélectionnez picassoia. S’il vous demande de vous connecter, suivez le parcours dans le navigateur. Si la page de connexions vous a fourni un jeton à la place, ajoutez --header "Authorization: Bearer YOUR_TOKEN" à la commande.Je n’affiche pas d’URL ici, volontairement. PicassoIA affiche la vôtre après votre connexion, utilisez donc celle exacte de votre compte plutôt qu’une copie tirée d’un article.
Comme vous avez nommé le serveur picassoia, ses outils apparaissent sous la forme mcp__picassoia__<tool>. Essayez quelque chose qui en utilise deux :
Utilisez PicassoIA pour générer une photographie au format 16:9 d’un bureau en bois au lever du soleil, avec un ordinateur portable et une tasse de café, puis animez-la dans une courte vidéo.
Claude Code demande l’autorisation avant d’appeler un nouvel outil, attendez-vous donc à une demande lors de la première exécution. Si vous souhaitez aussi comparer la façon dont différents grands modèles de langage lisent la même consigne, PicassoIA propose notamment Claude Sonnet 5 et Claude Fable 5 parmi ses grands modèles de langage.
La plupart des échecs proviennent d’une courte liste de causes. Commencez par /mcp pour lire le statut, puis utilisez claude mcp get <name> pour voir exactement ce qui a été enregistré.
| Symptôme | Cause probable | Solution |
|---|---|---|
| Le serveur affiche Failed | Mauvaise URL ou jeton invalide | Vérifiez avec claude mcp get <name>, puis supprimez et ajoutez à nouveau avec les bonnes valeurs |
| Serveur absent dans VS Code | La conversation a commencé avant son ajout | Démarrez une nouvelle conversation |
| Le serveur stdio s’arrête aussitôt sous Windows | npx nécessite un wrapper de shell | Utilisez -- cmd /c npx ... |
| Serveur connecté mais sans outils | Connexion OAuth non terminée | /mcp puis authentifiez-vous, ou claude mcp login <name> |
| Le serveur de projet ne se charge jamais | L’approbation a été refusée | Exécutez claude mcp reset-project-choices et approuvez à nouveau |
| Ça fonctionne pour vous, pas pour un coéquipier | Il a été enregistré en portée locale | Ajoutez-le à nouveau avec --scope project |
| Serveur déconnecté en cours de session | Connexion perdue | Exécutez /mcp reconnect all (v2.1.284 ou version ultérieure) |
Trois paramètres gèrent les serveurs lents. MCP_TIMEOUT définit le délai de démarrage du serveur en millisecondes, ce qui aide lorsque le premier téléchargement de npx est lent :
export MCP_TIMEOUT=10000
Sous PowerShell Windows, la même chose s’écrit $env:MCP_TIMEOUT = "10000". MAX_MCP_OUTPUT_TOKENS augmente la limite de sortie des outils. La valeur par défaut est de 25 000 tokens, et Claude Code vous avertit à partir de 10 000. Enfin, un timeout par serveur dans .mcp.json (également en millisecondes) accorde plus de temps aux outils lents, ce qui convient aux générateurs d’images et de vidéos :
{
"mcpServers": {
"slow-tool": {
"type": "http",
"url": "https://example.com/mcp",
"timeout": 600000
}
}
}
Vous avez maintenant tout le cycle : choisir un transport, ajouter le serveur, choisir une portée, vous connecter en toute sécurité et le réparer lorsqu’il dysfonctionne. Le moyen le plus rapide de constater ce que cela apporte est de connecter un serveur qui produit quelque chose de visible.
Connectez-vous à PicassoIA, reliez-le à Claude Code et demandez une photographie. Générez-la avec PicassoIA Image, retouchez-la avec PicassoIA Image Editor Pro, puis donnez-lui vie avec PicassoIA Video ou Seedance 2.5 Lite. Parcourez tous les modèles sur picassoia.com/en/all-models, et commencez avec un prompt de votre choix.
Choisissez votre langue
