GuidesMCP

Tuto : connecter un serveur MCP à Claude Desktop

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

{"mcpServers": {"crm": { … }}}claude_desktop_config.jsonOutil crm utiliséUn fichier de réglages, un redémarrage, et Claude voit vos outils
Déclaré dans le fichier de configuration, le serveur MCP apparaît dans Claude Desktop.

1. La déclaration

{
  "mcpServers": {
    "stock": {
      "command": "node",
      "args": ["/Users/vous/mcp-stock/build/index.js"],
      "env": { "STOCK_API_KEY": "..." }
    }
  }
}

2. Les étapes

  1. 1Ouvrir la configurationRéglages, Développeur, modifier la configuration.
  2. 2Déclarer le serveurCommande, arguments avec chemin absolu, variables.
  3. 3RedémarrerQuitter complètement l’application, puis la relancer.
  4. 4VérifierLes outils du serveur apparaissent dans la conversation.

3. Tester

Demandez à Claude une action qui demande l’outil (« quel est le stock de TSH-042 ? »). L’application montre l’appel et vous demande l’autorisation avant de l’exécuter.

Les erreurs fréquentes

Symptôme Cause probable
Aucun outil JSON invalide ou application pas redémarrée
Serveur en erreur Chemin relatif, ou node introuvable
Outil qui échoue Variable d’environnement manquante

Avant : créer le serveur en TypeScript.

Questions fréquentes

Où se trouve le fichier de configuration ?
Dans Claude Desktop, menu Réglages, section Développeur, bouton de modification de la configuration : il ouvre le bon fichier, sur Mac comme sur Windows.
Mon serveur n’apparaît pas, que vérifier ?
Que le JSON est valide, que le chemin est absolu, que la commande se lance seule dans un terminal, puis consultez les journaux MCP indiqués dans les réglages développeur.
Comment passer une clé d’API au serveur ?
Dans le champ env de sa déclaration. Le fichier reste sur votre poste : ne le partagez pas tel quel.

À lire ensuite

Tous les guides