MCP Academy · Leçon

Le relier à Claude Desktop

Modifiez la configuration pour que Claude charge votre serveur.

Leçon 2 sur 413 étapes

Le relier à Claude Desktop est une leçon MCP Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage MCP Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours MCP Academy comprend 4 leçons au total.

Du script à un véritable hôte

Votre serveur fonctionne, mais personne ne lui parle encore. Connectons-le à un véritable hôte : Claude Desktop. 🖥️

Il lit un fichier de configuration

Claude Desktop découvre les serveurs à partir d’un seul fichier JSON nommé claude_desktop_config.json. Vous y répertoriez chaque serveur, puis l’application les charge au démarrage.

Emplacement du fichier

Sur macOS, le fichier se trouve sous Application Support ; sous Windows, il se trouve dans votre dossier d’itinérance AppData. Ouvrez-le depuis les paramètres de l’application.

~/Library/Application Support/Claude/claude_desktop_config.json

La clé mcpServers

Chaque serveur se trouve dans l’objet mcpServers de niveau supérieur. Chaque clé correspond au nom que vous choisissez ; la valeur décrit comment le lancer.

{
  "mcpServers": {}
}

Commande et arguments

Pour chaque serveur, vous indiquez une commande à exécuter et un tableau d’arguments. Ensemble, ils définissent exactement comment l’hôte crée votre processus.

{
  "weather": {
    "command": "python",
    "args": ["/abs/path/server.py"]
  }
}

Utiliser des chemins absolus

L’hôte se lance depuis son propre répertoire de travail : les chemins relatifs ne fonctionnent donc pas. Indiquez toujours dans les arguments un chemin absolu vers votre script.

uv simplifie les choses

Si votre projet utilise uv, définissez la commande sur uv et laissez-le exécuter votre module dans le bon environnement, sans installation globale.

{
  "command": "uv",
  "args": ["run", "server.py"]
}

Transmettre des variables d’environnement

Les secrets comme les clés d’API vont dans un objet env facultatif. L’hôte les injecte au démarrage de votre serveur, afin qu’ils restent en dehors du code.

"env": { "API_KEY": "sk-..." }

Redémarrer pour appliquer les changements

Claude ne lit la configuration qu’au démarrage. Après toute modification, vous devez redémarrer complètement l’application pour qu’elle détecte votre nouveau serveur.

L’icône de marteau

Lorsque tout fonctionne, un petit indicateur outils apparaît dans la conversation. Cliquez dessus pour afficher les outils que votre serveur propose désormais à Claude. 🔨

Choisir soigneusement le nom

La clé que vous choisissez sous mcpServers devient le nom du serveur. Gardez-le court et unique afin que plusieurs serveurs n’entrent jamais en conflit dans l’hôte.

Vérification rapide

Quelle modification Claude Desktop nécessite-t-il avant de charger un serveur nouvellement ajouté ?

Réponds-y dans la leçon interactive

Récapitulatif

Vous avez ajouté votre serveur à claude_desktop_config.json avec une commande, des arguments et env, utilisé des chemins absolus, puis redémarré l’application. Il est actif dans Claude ! ✅

Gratuit pour commencer

Apprends Python avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours: 30
Leçons: 120

Commencer gratuitement Voir le cours complet

Questions Fréquemment Posées

La leçon « Le relier à Claude Desktop » est-elle gratuite ?

Oui — le texte complet de « Le relier à Claude Desktop » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours MCP Academy, passe à CoddyKit PRO. Le cours MCP Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Le relier à Claude Desktop » ?

Modifiez la configuration pour que Claude charge votre serveur. Tu pratiques MCP Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer MCP Academy ?

Aucune expérience préalable n'est requise. MCP Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.

Combien de temps prend la leçon « Le relier à Claude Desktop » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon MCP Academy ?

Oui. Chaque leçon MCP Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à MCP Academy