Localisez claude_desktop_config.json sous Windows et macOS, évitez le piège du chemin MSIX, collez un exemple mcpServers fonctionnel, redémarrez correctement l’application et lisez les journaux MCP lorsqu’un serveur refuse de se charger. Un tutoriel vous montre comment déboguer votre JSON avec un modèle Claude sur PicassoIA.
Vous avez modifié le JSON, redémarré l’application, et rien ne s’est passé. Aucune icône de marteau, aucun nouvel outil, aucun message d’erreur. Cet échec silencieux est le scénario le plus courant avec une configuration MCP de Claude Desktop, et il remonte presque toujours à l’une de trois causes : vous avez modifié le mauvais fichier, le JSON contient une petite erreur de syntaxe, ou l’application n’a jamais été entièrement redémarrée. Cet article passe en revue les trois, dans l’ordre où vous les rencontrerez.
Vous obtiendrez l’emplacement exact de claude_desktop_config.json sous Windows et macOS (y compris le piège MSIX de Windows qui envoie vos modifications dans un fichier que personne ne lit), un exemple JSON fonctionnel à coller dès aujourd’hui, un moyen de confirmer qu’un serveur s’est bien connecté, et une courte procédure de dépannage fondée sur les journaux MCP. Vers la fin, un tutoriel explique comment utiliser Claude Sonnet 5 sur PicassoIA pour déboguer votre propre configuration, ainsi qu’un aperçu de la connexion des générateurs d’images et de vidéos une fois la plomberie opérationnelle.
💡 En bref : le fichier est
claude_desktop_config.json, il doit contenir un objetmcpServersde premier niveau, chaque chemin qu’il contient doit être absolu, et l’application doit être entièrement fermée puis rouverte après chaque modification.
Claude Desktop lit un fichier JSON au lancement pour savoir quels serveurs MCP (serveurs Model Context Protocol) il doit démarrer. Le fichier n’existe pas tant que vous ne l’ouvrez pas depuis l’écran des paramètres ou que vous ne le créez pas à la main, donc une installation neuve n’a encore rien à trouver. Son emplacement dépend de votre système d’exploitation et, sous Windows, de la manière dont vous avez installé l’application.
Sur une installation Windows standard, le fichier se trouve ici :
%APPDATA%\Claude\claude_desktop_config.json
Développé, cela donne C:\Users\<your name>\AppData\Roaming\Claude\claude_desktop_config.json. Appuyez sur Win+R, collez la première forme et appuyez sur Entrée pour ouvrir le bon dossier.
Voici le piège. Lorsque Claude Desktop est installé sous forme de paquet MSIX (le Microsoft Store et certaines installations WinGet fonctionnent ainsi), Windows virtualise le dossier AppData de cette application. Plusieurs rapports de bogues publics décrivent le même résultat : le bouton Edit Config ouvre le fichier %APPDATA% ordinaire, alors que l’application elle-même lit une copie enfouie dans le dossier du paquet :
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
Si vous modifiez le premier fichier, vos serveurs sont ignorés sans le moindre avertissement. Une rapide vérification PowerShell vous indique dans quelle situation vous vous trouvez :
Test-Path "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc"
Si cela affiche True, placez votre bloc mcpServers dans le chemin du paquet, redémarrez et vérifiez si le serveur apparaît. Les noms des dossiers de paquet peuvent changer d’une version à l’autre, donc considérez le chemin ci-dessus comme un point de départ. S’il ne correspond pas, cherchez dans %LOCALAPPDATA%\Packages un dossier qui commence par Claude_.
Sur un Mac, le fichier se trouve dans le dossier Bibliothèque, que le Finder masque par défaut :
~/Library/Application Support/Claude/claude_desktop_config.json
Dans le Finder, choisissez Aller, puis Aller au dossier, et collez ~/Library/Application Support/Claude. Depuis le Terminal, open ~/Library/Application\ Support/Claude fait le même travail.
Il n’existe pas de version officielle de Claude Desktop pour Linux. Les versions communautaires suivent en général la convention XDG et lisent ~/.config/Claude/claude_desktop_config.json, mais vérifiez les notes de la version que vous utilisez avant de vous fier à ce chemin.
La méthode la moins sujette aux erreurs passe par l’application elle-même :
Cela crée le fichier s’il manque et l’affiche dans votre gestionnaire de fichiers. Sur une installation MSIX sous Windows, comparez le dossier ouvert avec le chemin du paquet indiqué plus haut avant de lui faire confiance.
Voici tous les emplacements réunis :
| Système | Fichier de configuration | Dossier des journaux |
|---|---|---|
| Windows | %APPDATA%\Claude\claude_desktop_config.json | %APPDATA%\Claude\logs |
| Windows (MSIX) | %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\ | Le dossier logs à côté du fichier de configuration |
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | ~/Library/Logs/Claude |
Le fichier entier est un seul objet JSON. Claude Desktop cherche une propriété de premier niveau appelée mcpServers. À l’intérieur, chaque propriété correspond à un serveur, et le nom de la propriété est le libellé que vous voyez dans l’application. Chaque entrée est une petite recette pour lancer un programme sur votre ordinateur, et Claude communique avec ce programme par l’entrée et la sortie standard.
| Champ | Obligatoire | Rôle |
|---|---|---|
command | Oui | L’exécutable à lancer, comme npx ou node |
args | En général | Un tableau d’arguments, une chaîne par élément |
env | Non | Variables d’environnement transmises à ce processus |
La bonne command dépend de la façon dont le serveur a été écrit. Les serveurs Node.js publiés sur npm démarrent avec npx. Les serveurs que vous avez créés ou clonés vous-même démarrent avec node suivi du chemin vers le fichier compilé. Les serveurs Python se lancent en général via uvx, qui nécessite l’installation de l’outil uv. Dans tous les cas, la règle est la même : ce que vous saisissez comme command doit fonctionner lorsqu’il est tapé dans un terminal, car c’est exactement ce que Claude Desktop fait à votre place.
Si Claude Desktop a déjà ajouté d’autres entrées de premier niveau dans le fichier (les versions récentes peuvent y stocker quelques préférences), laissez-les tranquilles et ajoutez mcpServers à côté. Remplacer tout le fichier par un extrait collé est la façon la plus courante de perdre ces réglages.
Voici le serveur de système de fichiers officiel sur un Mac. Remplacez username par le nom de votre compte réel :
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/Users/username/Downloads"
]
}
}
}
La version Windows est identique, à l’exception des chemins, et chaque barre oblique inversée doit être doublée, car une seule barre oblique inversée est un caractère d’échappement en JSON :
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\username\\Desktop",
"C:\\Users\\username\\Downloads"
]
}
}
}
Trois détails font l’essentiel du travail ici. L’option -y permet à npx d’installer le paquet du serveur sans poser de question auxquelles personne ne pourrait répondre. Les dossiers placés après le nom du paquet sont les seuls endroits que le serveur peut toucher. Et tous ces chemins sont absolus, car les chemins relatifs sont une cause classique de démarrage raté.
Il vous faut aussi Node.js, car npx y est intégré. Exécutez node --version dans un terminal ; si cela affiche un numéro de version, c’est bon, et la version LTS est le choix sûr.
💡 Astuce : choisissez le libellé de
mcpServerspour les humains, pas pour la machine.filesystem,notesouweatherconviennent tous, et ce nom n’apparaît que dans les menus et dans le nom du fichier de journal.
Les serveurs réels ont souvent besoin d’un identifiant. Placez-le dans l’objet env de ce serveur, jamais dans args, où il apparaîtrait dans les listes de processus. Cet exemple lance deux serveurs côte à côte :
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Documents/notes"
]
},
"weather": {
"command": "node",
"args": ["/Users/username/tools/weather-server/build/index.js"],
"env": {
"WEATHER_API_TOKEN": "paste-your-token-here"
}
}
}
}
Remarquez la virgule entre les deux blocs de serveur et l’absence de virgule après le dernier. Ces deux endroits provoquent plus de fichiers cassés que tout le reste.
Le fichier de configuration est du texte brut, traitez-le donc comme un fichier de mots de passe. Ne le versionnez pas dans un dépôt public, ne le collez pas dans une discussion ni dans une capture d’écran où le token est visible, et limitez strictement l’accès aux dossiers. Un serveur s’exécute avec les droits de votre compte utilisateur, ce qui signifie qu’il peut faire tout ce que vous pouvez faire à la main. Faites pointer le serveur de système de fichiers vers un seul dossier de projet, et non vers l’ensemble de votre dossier personnel.
Le fichier JSON lance des processus locaux. Un serveur MCP distant et hébergé est d’une autre nature : il tourne déjà ailleurs et vous l’atteignez par une URL. Claude Desktop attend que ceux-ci soient ajoutés depuis Settings, puis Connectors, et non comme entrées dans claude_desktop_config.json. Coller une URL dans command fait partie des moyens discrets de se retrouver avec un serveur qui ne se charge jamais.
| Serveur local | Serveur distant | |
|---|---|---|
| Où il tourne | Sur votre ordinateur | Sur une machine hébergée |
| Comment l’ajouter | mcpServers dans le fichier JSON | Settings, puis Connectors |
| Nécessite Node.js | Souvent | Non |
| Panne typique | Mauvais chemin ou JSON invalide | Problème de connexion ou d’autorisation |
Claude Desktop lit la configuration une seule fois, au lancement. Enregistrer le fichier ne suffit pas à lui seul. Fermer la fenêtre ne suffit pas non plus, car l’application peut continuer de tourner en arrière-plan. Sur macOS, appuyez sur Cmd+Q ou utilisez Claude, puis Quit. Sous Windows, quittez depuis l’icône de la zone de notification si l’application y reste active. Ensuite, rouvrez-la.
Avancez par petites étapes. Ajoutez un serveur, redémarrez, vérifiez-le, puis ajoutez le suivant. Lorsque vous collez cinq serveurs d’un coup et que le fichier refuse de se charger, vous n’avez aucun moyen de savoir quel bloc l’a cassé.
Une fois l’application relancée, regardez la zone de saisie du chat et cliquez sur le bouton Add files, connectors, and more. Passez la souris sur Connectors, cliquez sur Manage connectors, puis choisissez votre serveur dans la liste. Un serveur qui fonctionne affiche les outils qu’il propose. Le serveur de système de fichiers, par exemple, liste des outils pour lire des fichiers, en écrire, les déplacer et les rechercher.
Lancez ensuite un vrai test avec un prompt tel que « Liste les fichiers de mon dossier Téléchargements. ». Claude demande l’autorisation avant d’appeler un outil. Approuvez l’appel, et la réponse doit revenir avec de vrais noms de fichiers. S’il répond qu’il n’a pas accès à vos fichiers, le serveur ne s’est pas connecté.
Un seul caractère mal placé empêche le chargement de tout le fichier. Voici les coupables habituels :
// sont des erreurs.Cet extrait en réunit trois en quelques lignes. Pouvez-vous les repérer ?
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\Users\username\Desktop",],
}
}
}
Le chemin utilise des barres obliques inversées simples, le tableau se termine par une virgule avant le crochet fermant, et la ligne args se termine par une virgule avant l’accolade fermante. Corrigez les trois et le fichier s’analyse correctement.
Avant de redémarrer, validez le fichier. N’importe quel validateur JSON convient, ou vous pouvez utiliser Node.js, que vous avez déjà :
node -e "JSON.parse(require('fs').readFileSync(process.argv[1],'utf8')); console.log('valid')" claude_desktop_config.json
Si cela affiche valid, la syntaxe est correcte et le problème se situe ailleurs.
Lorsque le JSON est valide mais que le serveur échoue encore, le coupable est en général la command. Une application de bureau ne lit pas votre profil de shell, donc un Node.js installé via un gestionnaire de versions peut lui être invisible. Exécutez which npx dans un terminal et indiquez le chemin complet dans le champ command au lieu de npx.
D’abord, exécutez la commande exacte à la main pour voir si elle fonctionne en dehors de l’application :
npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop
Sous Windows, si le journal mentionne une erreur sur ${APPDATA} dans un chemin, ajoutez la valeur développée de %APPDATA% au bloc env de ce serveur, par exemple "APPDATA": "C:\\Users\\username\\AppData\\Roaming\\". Vérifiez aussi que %APPDATA%\npm existe. Si ce n’est pas le cas, installez npm globalement avec npm install -g npm, puis redémarrez l’application.
Les journaux vous indiquent ce que l’application a vu. Ouvrez le dossier des journaux depuis le tableau ci-dessus et cherchez deux types de fichiers. mcp.log contient les messages généraux sur les connexions et les échecs. Les fichiers nommés mcp-server-NAME.log contiennent la sortie stderr de chaque serveur, c’est souvent là que se trouve le vrai message d’erreur. Sur un Mac, vous pouvez les suivre en direct :
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
Sous Windows, PowerShell fait le même travail :
Get-Content "$env:APPDATA\Claude\logs\mcp.log" -Tail 40 -Wait
Un journal qui ne change jamais après un redémarrage est en soi un indice : l’application lit probablement un autre fichier de configuration que celui que vous avez modifié, ce qui vous ramène au chemin MSIX.
| Symptôme | Cause probable | Solution |
|---|---|---|
| Aucun serveur, aucune erreur | Mauvais fichier de configuration, ou application pas entièrement quittée | Vérifiez le chemin, quittez depuis la zone de notification ou le menu |
| Serveur listé mais marqué en échec | command incorrecte ou Node.js absent | Utilisez le chemin complet vers npx ou node |
| Configuration entière ignorée | JSON invalide | Validez le fichier, supprimez les virgules finales |
| Les outils échouent à l’appel | Le serveur plante à l’exécution | Lisez mcp-server-NAME.log |
| Impossible d’accéder à un dossier | Chemin absent de args | Ajoutez le chemin absolu du dossier |
Un second regard est le moyen le plus rapide de repérer une virgule égarée. Claude Sonnet 5 sur PicassoIA est un modèle de texte qui lit le JSON collé, les traces de pile et même les captures d’écran d’une erreur, ce qui en fait un bon relecteur de configuration.
Rendez-vous sur la page Claude Sonnet 5 de la collection Large Language Models et ouvrez la zone de prompt. Gardez un onglet du navigateur pour le modèle et un pour votre éditeur, afin de pouvoir copier-coller dans les deux sens.
Le modèle expose quelques réglages, et quelques-uns comptent ici :
low par défaut, ce qui désactive la réflexion pour une réponse plus rapide. C’est suffisant pour une vérification de syntaxe. Passez à medium ou high lorsque vous avez besoin qu’il raisonne sur des chemins répartis entre plusieurs serveurs.Pour les vérifications rapides par oui ou par non, Claude 4.5 Haiku répond plus vite. Pour une énigme persistante sur plusieurs fichiers, Claude Opus 4.7 est l’option la plus puissante, mais plus lente.
Remplacez d’abord chaque token par un espace réservé. Puis collez le fichier et posez une question précise :
This claude_desktop_config.json is on Windows. The filesystem server never
appears in Claude Desktop. Check the JSON syntax, check the path escaping,
and tell me which line to fix first.
Comparez la réponse avec votre fichier ligne par ligne au lieu de la recoller aveuglément, et lancez sur le résultat le validateur Node.js vu précédemment.
Une fois que votre configuration fonctionne, la partie intéressante commence : donner à Claude des outils qui créent des contenus. PicassoIA propose une API pour développeurs et une connexion MCP, toutes deux limitées à quatre modèles au moment de la rédaction :
| Modèle | Type | Usage |
|---|---|---|
| PicassoIA Image | Image | Génération d’images à partir de texte |
| PicassoIA Image Editor Pro | Image | Retouche et réinterprétation d’images existantes |
| PicassoIA Video | Vidéo | Génération de vidéos |
| Seedance 2.5 Lite | Vidéo | Vidéo avec audio |
Les connexions MCP de PicassoIA se créent depuis la page de votre compte sur picassoia.com, après connexion. Elles sont hébergées, donc la méthode des connecteurs vue plus haut s’applique : ajoutez-les depuis Settings, puis Connectors, et non comme une entrée mcpServers. Les tâches s’exécutent de manière asynchrone : une requête lance une prédiction, et le résultat est récupéré une fois celle-ci terminée. Chaque compte peut exécuter 5 prédictions simultanément, et cette limite est partagée entre toutes les connexions MCP que vous créez, donc une demande groupée envoyée depuis Claude peut attendre derrière elle-même.
💡 Astuce : demandez d’abord une seule image, vérifiez le résultat, puis augmentez le volume. Un seul prompt de photo au format 16:9 vous dira plus vite qu’un lot de dix images si la connexion et les autorisations sont correctes.
Une bonne première demande est concrète : « Crée une photo au format 16:9 d’une tasse en céramique sur un bureau en chêne, dans une douce lumière du matin, avec PicassoIA Image. » Claude choisit l’outil, attend la tâche et vous transmet le lien. S’il demande l’autorisation à chaque fois, c’est la même étape d’approbation que vous avez vue avec le serveur de système de fichiers, et elle fonctionne comme prévu.
Votre fichier de configuration fait maintenant ce qu’il doit faire : il pointe vers le bon emplacement, s’analyse proprement, démarre ses serveurs et journalise ce qui ne va pas. C’est la moitié ennuyeuse du travail avec les outils d’IA, et vous n’avez à la faire qu’une seule fois.
La moitié amusante, c’est la création. Ouvrez PicassoIA Image et rédigez un prompt sur un sujet qui vous tient à cœur, une rue que vous connaissez ou un produit que vous vendez. Retravaillez-le avec PicassoIA Image Editor Pro, puis animez le meilleur résultat avec PicassoIA Video. Parcourez tous les modèles sur picassoia.com/en/all-models, choisissez-en un que vous n’avez pas encore testé, et créez votre première image dès aujourd’hui.
Choisissez votre langue
