Comment connecter des serveurs MCP à Claude Desktop

Serveurs distants : ajouter un connecteur personnalisé

Ouvrez Claude Desktop, allez dans Réglages, puis Connecteurs, et cliquez sur Ajouter un connecteur personnalisé. Donnez-lui un nom, collez l'URL du serveur, et confirmez. Les connecteurs personnalisés utilisant MCP à distance sont disponibles sur les forfaits Free, Pro, Max, Team et Enterprise ; un compte Free est limité à un seul connecteur personnalisé. Sur les forfaits Team et Enterprise, un propriétaire d'organisation ajoute d'abord le connecteur dans les réglages de l'organisation, puis les membres l'activent depuis leur propre page Connecteurs.

Les serveurs qui prennent en charge OAuth vous demandent de vous connecter et d'approuver des permissions dans le navigateur la première fois que vous les utilisez ; rien d'autre n'est nécessaire. Une section facultative Réglages avancés prend un identifiant de client OAuth et un secret pour les serveurs qui exigent un client pré-enregistré, ce que la plupart des serveurs publics ne font pas. Pour le serveur de HostTracker, l'URL est https://mcp.host-tracker.com/mcp ; il utilise OAuth avec un enregistrement de client dynamique, donc le connecteur ne détient que les permissions que vous approuvez, et il n'y a pas de clé à coller.

Les connecteurs tournent du côté d'Anthropic plutôt que sur votre machine, donc ils ne peuvent pas atteindre un serveur sur votre réseau local, et ils utilisent le même mécanisme que claude.ai et Cowork. Le fichier de configuration décrit ensuite est l'équivalent local.

Serveurs locaux : modifier claude_desktop_config.json

Ouvrez Réglages, choisissez l'onglet Développeur, et cliquez sur Modifier la configuration. Cela ouvre le fichier de configuration dans votre éditeur, en le créant s'il n'existe pas encore. Le fichier se trouve à ~/Library/Application Support/Claude/claude_desktop_config.json sur macOS et à %APPDATA%\Claude\claude_desktop_config.json sous Windows ; sur la bêta Linux, utilisez le bouton Modifier la configuration plutôt que de deviner un chemin. Chaque serveur est une entrée sous mcpServers avec la commande à démarrer et ses arguments :

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

Enregistrez le fichier, puis quittez complètement Claude Desktop et relancez-le ; fermer la fenêtre ne suffit pas, car les serveurs sont lancés au démarrage de l'application. Sous Windows, l'environnement d'exécution dont la commande dépend, comme Node.js pour npx, doit être installé et dans le PATH que voit l'application de bureau, donc un serveur qui tourne bien dans un terminal mais pas depuis l'application est généralement dû à une différence de PATH.

Pour voir qu'un serveur a bien été chargé, cliquez sur l'icône « Ajouter des fichiers, des connecteurs et plus » en bas à gauche de la zone de message, survolez Connecteurs, et ouvrez Gérer les connecteurs ; le serveur y est listé avec ses outils. La documentation plus ancienne appelle cela l'icône du marteau, et la page de dépannage utilise encore ce nom dans un titre.

Extensions du répertoire

Réglages, puis Extensions, puis Parcourir les extensions affiche un répertoire organisé de serveurs locaux packagés en extensions, qui s'installent en un clic et se mettent à jour toutes seules. Un paquet téléchargé s'installe via Installer l'extension en choisissant le fichier ; ces paquets utilisent le format .mcpb, qui a remplacé l'ancien nom .dxt, et peuvent envelopper des serveurs Node.js, Python ou binaires. Les paquets distribués en privé ne se mettent pas à jour automatiquement et doivent être réinstallés à la main après un changement.

Où se trouvent les journaux quand rien n'apparaît

Claude Desktop écrit un journal de connexion général et un journal par serveur. Sur macOS, ils se trouvent sous ~/Library/Logs/Claude/ sous les noms mcp.log et mcp-server-NAME.log ; sous Windows, sous %APPDATA%\Claude\logs. Le fichier propre à chaque serveur porte la sortie d'erreur propre du serveur, où un module manquant, un chemin erroné ou un identifiant rejeté est explicitement indiqué. Si le fichier est vide, l'application n'a jamais réussi à démarrer la commande du tout, ce qui pointe de nouveau vers le PATH ou vers une erreur de syntaxe JSON dans le fichier de configuration.

Une application, deux interfaces

Claude Desktop inclut désormais un onglet Code qui exécute Claude Code à l'intérieur de l'application, à côté de l'onglet Chat. Les serveurs déclarés dans claude_desktop_config.json sont disponibles à la fois dans l'interface de chat et dans les sessions locales de l'onglet Code, aux côtés de ceux de ~/.claude.json et du .mcp.json d'un projet ; quand le même nom existe aux deux endroits, l'onglet Code reprend la définition du fichier de bureau. Le Claude Code autonome en ligne de commande ne lit pas le fichier de bureau. Si vous avez configuré des serveurs dans l'application de bureau en premier et voulez les avoir dans le terminal, claude mcp add-from-claude-desktop les importe sur macOS et sur Windows Subsystem for Linux, comme décrit dans comment ajouter un serveur MCP à Claude Code.

Un serveur de surveillance distant comme premier connecteur

Un serveur distant est le moyen le plus rapide de confirmer que le flux de connecteur fonctionne, puisqu'il n'y a rien à installer et que la réponse est vérifiable. Ajoutez le serveur de HostTracker comme connecteur personnalisé, connectez-vous quand on vous le demande, et demandez à Claude si un site que vous connaissez est en ligne ; la réponse devrait citer une vérification exécutée depuis les points de contrôle de HostTracker à des emplacements nommés plutôt qu'une supposition. La page du serveur MCP liste les 65 outils et les permissions dont chacun a besoin, des vérifications instantanées aux mises à jour de pages de statut.