Installer des serveurs MCP dans Claude Desktop (pas à pas)

Ajoutez un serveur MCP à Claude Desktop : emplacement de claude_desktop_config.json sous macOS et Windows, exemple de configuration et dépannage.

Avant de commencer

Il vous faut l’application Claude Desktop. La plupart des serveurs nécessitent aussi Node.js (pour les commandes npx) ou Python avec uv (pour les commandes uvx) ; le README du serveur précise lequel.

1. Ouvrir le fichier de configuration

Cliquez sur le menu Claude dans la barre de menus du système (pas dans les réglages de la fenêtre de discussion), choisissez Settings… puis ouvrez Developer → Edit Config. Cela ouvre claude_desktop_config.json. Sous macOS, il se trouve dans ~/Library/Application Support/Claude/claude_desktop_config.json ; sous Windows, dans %APPDATA%\Claude\claude_desktop_config.json.

2. Ajouter le serveur

Ajoutez une entrée sous mcpServers. Cet exemple ajoute le serveur officiel Filesystem avec accès à un seul dossier :

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
    }
  }
}

3. Redémarrer et vérifier

Quittez complètement Claude Desktop puis rouvrez-le. Dans la zone de saisie, cliquez sur Add files, connectors, and more, ouvrez Connectors → Manage connectors et sélectionnez votre serveur pour voir ses outils. S’il ne se connecte pas, consultez les journaux (mcp.log et mcp-server-NOM.log) dans ~/Library/Logs/Claude sous macOS ou %APPDATA%\Claude\logs sous Windows.

Conseils

• Utilisez des chemins absolus.
• Placez les clés d’API dans un objet env à l’intérieur de l’entrée du serveur.
• De nombreuses pages serveur sur Socketlist affichent une configuration prête à l’emploi, copiée du README.