Prérequis
- Avoir Claude Desktop / Cursor / VS Code installé
- Le runtime requis par le serveur que vous allez installer (la plupart nécessitent Node.js ou Python ; certains requièrent des dépendances supplémentaires)
- Avoir vos identifiants API prêts (p. ex., le token GitHub) — vous en aurez besoin pendant la configuration
Claude Desktop
Flux graphique :
- Ouvrez Claude Desktop → Settings
- Entrez dans Developer → cliquez sur Edit Config
- Ajoutez votre serveur dans la section
mcpServersdeclaude_desktop_config.json:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "votre-token" }
}
}
}
Enregistrez le fichier et redémarrez Claude Desktop. Votre nouvel outil apparaîtra dans la liste des outils de la barre latérale gauche. Consultez toujours le README du serveur pour la commande et les arguments exacts.
Cursor
- Ouvrez la palette de commandes (
Ctrl+Shift+P/Cmd+Shift+P) - Recherchez et sélectionnez Cursor Settings > MCP
- Cliquez sur Add New MCP Server, choisissez le type de transport (stdio ou SSE) et remplissez la commande/les arguments
VS Code
- Installez l'extension MCP Client (ou utilisez Copilot / des extensions avec prise en charge MCP intégrée)
- Configurez
mcpServersdans les réglages de l'extension avec le même format JSON que Claude Desktop - Rechargez la fenêtre de VS Code pour que les modifications prennent effet
Les interfaces peuvent changer selon les versions du client — consultez toujours la documentation officielle pour les étapes exactes ; la structure de la commande/JSON suit toujours le README du serveur.
Résolution d'erreurs courantes
| Erreur | Cause | Solution |
|---|---|---|
| command not found | Le runtime Node/Python n'est pas installé ou n'est pas dans le PATH | Installez le runtime et redémarrez le client |
| 401 / 403 | Identifiants API invalides ou expirés | Régénérez le token et vérifiez deux fois votre configuration d'environnement |
| Connection refused | Adresse du serveur SSE incorrecte ou le service ne tourne pas | Vérifiez l'URL + le port et confirmez que le serveur est en ligne |
| Tool not found | Les modifications de configuration n'ont pas été chargées car le client n'a pas été redémarré | Redémarrez entièrement l'application du client après avoir enregistré la configuration |
Notes de sécurité
- Les tokens ne sont gardés que dans votre fichier de configuration local — ne poussez jamais le fichier vers Git (pensez à ajouter
.gitignore) - Installez seulement des serveurs de projets fiables et à nombreuses étoiles — des serveurs non vérifiés pourraient exfiltrer vos données
- Accordez des serveurs à haute permission uniquement quand c'est absolument nécessaire