GuidesMCP
Tuto : connecter un serveur MCP à 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
- 1Ouvrir la configurationRéglages, Développeur, modifier la configuration.
- 2Déclarer le serveurCommande, arguments avec chemin absolu, variables.
- 3RedémarrerQuitter complètement l’application, puis la relancer.
- 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.