Installer un serveur MCP dans Claude Desktop

Il y a trois façons de brancher un serveur MCP (Model Context Protocol) à Claude Desktop : éditer le fichier claude_desktop_config.json pour un serveur local, installer une extension de bureau (fichier .mcpb), ou ajouter un connecteur personnalisé pour un serveur distant. La plus courante pour un développeur est la première : Claude Desktop lance lui-même le serveur au démarrage, d'après ce fichier. Étapes relevées le 15/11/2026 sur la documentation officielle.

Méthode 1 : le fichier de configuration (serveur local)

Prérequis. Claude Desktop à jour (menu Claude, « Check for Updates… »). Beaucoup de serveurs, dont le serveur de fichiers officiel, ont besoin de Node.js : vérifiez avec node --version, et installez la version LTS (support à long terme) depuis nodejs.org si besoin.

1. Ouvrir le fichier. Dans le menu Claude de la barre système (pas les réglages dans la fenêtre), choisissez « Settings… », puis l'onglet « Developer » et le bouton « Edit Config ». Le fichier est créé s'il n'existe pas :

2. Déclarer le serveur. L'exemple officiel installe le serveur de fichiers en lui donnant deux dossiers :

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

"filesystem" est le nom affiché ; command et args décrivent la commande à lancer ; -y confirme l'installation du paquet ; les derniers arguments sont les dossiers autorisés. Remplacez username par votre nom d'utilisateur. Une variable d'environnement (une clé d'accès, par exemple) se passe dans une clé env à côté de command.

3. Redémarrer. Quittez complètement Claude Desktop puis relancez-le. Le bouton « Add files, connectors, and more / », en bas à gauche de la zone de saisie, mène à « Connectors » puis « Manage connectors » : votre serveur et ses outils y apparaissent.

4. Approuver. Avant chaque opération, Claude demande votre accord. Lisez la demande ; vous pouvez toujours refuser.

Point de sécurité donné par la documentation : le serveur tourne avec les droits de votre compte utilisateur. Ne donnez accès qu'aux dossiers que vous acceptez de voir lus et modifiés.

Méthode 2 : les extensions de bureau (.mcpb)

Une extension de bureau est un paquet qui s'installe sans éditer de JSON. D'après le centre d'aide d'Anthropic : Settings > Desktop app, puis « Manage » à côté d'« Extensions » (Settings > Extensions dans l'ancienne disposition). « Browse extensions » ouvre un répertoire qui ne contient que des outils vérifiés par Anthropic. Pour une extension personnalisée : « Advanced settings », section « Extension Developer », bouton « Install Extension… ». Le centre d'aide précise que Claude Desktop embarque son propre environnement Node.js pour ces extensions. Sur les offres Team et Enterprise, les propriétaires peuvent activer ou désactiver les extensions publiques et téléverser des extensions personnalisées.

Méthode 3 : un serveur distant (connecteur personnalisé)

Pour un serveur hébergé sur Internet, pas de fichier à éditer : Settings > Connectors, bouton « Add », puis « Add custom connector », et saisissez l'adresse complète du serveur (avec https://). La documentation donne un serveur d'essai : https://example-server.modelcontextprotocol.io/mcp. Suivez ensuite l'authentification demandée par le serveur. Les conditions par offre sont détaillées sur la page MCP distant et OAuth.

Dépannage

Le serveur n'apparaît pas.

1. Redémarrez complètement Claude Desktop.
2. Vérifiez la syntaxe du fichier JSON.
3. Vérifiez que les chemins sont valides et absolus, pas relatifs.
4. Lisez les journaux (voir ci-dessous).
5. Lancez la commande du serveur à la main dans un terminal pour voir l'erreur, par exemple npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop.

Où sont les journaux. macOS : ~/Library/Logs/Claude ; Windows : %APPDATA%\Claude\logs ; Linux : ~/.config/Claude/logs. Le fichier mcp.log trace les connexions et leurs échecs ; chaque mcp-server-NOM.log contient la sortie d'erreur du serveur concerné. Sur macOS, tail -n 20 -f ~/Library/Logs/Claude/mcp*.log les suit en direct.

Erreur ENOENT et ${APPDATA} sous Windows. La documentation conseille d'ajouter la valeur développée de %APPDATA% dans la clé env du serveur, et de vérifier que npm est installé globalement (le dossier %APPDATA%\npm doit exister ; sinon npm install -g npm).

Les appels d'outils échouent sans message. Vérifiez les journaux, vérifiez que le serveur se compile et démarre sans erreur, puis redémarrez Claude Desktop.

Si vous écrivez votre propre serveur

Le principe est le même : un bloc sous mcpServers avec la commande qui lance votre programme. Les configurations exactes pour un serveur Python (lancé par uv) et TypeScript (lancé par node) sont sur leurs pages. Vous travaillez plutôt dans le terminal ? Voir ajouter un serveur MCP à Claude Code.