Tech • IA • Robotique • Jeu
Comment les grands débutants maîtrisent Claude Code MCP en 19 minutes
7/10INTRO
Model Context Protocol permet à Claude de se connecter en direct à des dossiers locaux et à des services hébergés comme Notion, ce qui réduit les copier-coller manuels et permet à une seule invite d’agir sur plusieurs systèmes.
POINTS CLÉS
Ce que fait MCP
MCP, abréviation de Model Context Protocol, est une norme qui permet de connecter Claude à des outils, bases de données, API et documents externes. Au lieu de dépendre uniquement de texte collé dans une discussion, il peut accéder directement à des sources autorisées et les utiliser pendant la conversation. La différence essentielle est qu’il s’agit d’une connexion en direct, et non de code généré pour un usage ultérieur.
Deux types de serveurs comptent
Les serveurs MCP se répartissent généralement en deux catégories: les serveurs locaux, qui s’exécutent sur l’ordinateur de l’utilisateur, et les serveurs hébergés, qui s’exécutent en ligne. Les serveurs locaux sont ajoutés via un fichier de configuration JSON, tandis que les serveurs hébergés se connectent via Settings et Connectors, généralement en collant une URL puis en se connectant. Confondre ces deux parcours est une cause fréquente d’échec de configuration.
Comment fonctionne la configuration locale
Dans Claude Desktop, la configuration MCP locale s’ouvre via File, Settings, Developer et Edit Settings. Si le fichier n’existe pas encore, l’application le crée. Chaque entrée de serveur local comprend un nom de serveur, une commande, des arguments et parfois des variables d’environnement pour les identifiants.
Les utilisateurs Windows rencontrent un piège courant
Sous Windows, tout serveur MCP local lancé via NPX a besoin d’un wrapper CMD. La commande doit être cmd, avec des arguments commençant par /c et npx. Utiliser directement npx comme commande peut provoquer une erreur de lancement où le serveur semble enregistré sans jamais se connecter réellement.
L’accès au système de fichiers est limité par le chemin du dossier
Un premier exemple pratique est le serveur de système de fichiers, qui ne nécessite ni compte ni jeton API. Une fois ajouté à la configuration, il permet à Claude de lire et créer des fichiers uniquement dans le chemin de dossier explicitement autorisé. Ce chemin constitue une limite stricte, ce qui signifie que le reste de l’ordinateur reste inaccessible.
Un redémarrage est nécessaire
Après avoir modifié la configuration locale, les utilisateurs doivent quitter complètement Claude Desktop puis le rouvrir. Fermer simplement la fenêtre ne suffit pas, car l’application ne lit la configuration qu’au démarrage. Une fois redémarrée, on peut demander quels outils sont disponibles et vérifier que les outils du système de fichiers sont chargés.
Tester les outils locaux prouve la connexion
Un test correct consiste à demander à Claude de lister les fichiers du dossier autorisé, d’en lire un, puis de créer un nouveau fichier. Le résultat peut ensuite être vérifié dans Windows Explorer. Cela confirme que le système interagit avec un vrai répertoire plutôt que de résumer un contenu téléversé.
La configuration de Notion hébergé suit un autre parcours
Notion utilise un serveur MCP hébergé et ne s’ajoute pas via le fichier JSON. À la place, les utilisateurs vont dans Settings, ouvrent Connectors, ajoutent un connecteur personnalisé, collent l’URL MCP de Notion et terminent le parcours de connexion dans le navigateur. Cette option nécessite une offre Pro, Max, Team ou Enterprise et n’est pas disponible dans l’offre gratuite.
L’accès Notion en direct évite les exports obsolètes
Une fois l’autorisation accordée, Claude peut lire des documents d’un espace de travail Notion en direct en utilisant les mêmes permissions de compte déjà en place. Cela évite d’exporter des pages, de générer des jetons API séparés ou de partager manuellement chaque page. Cela évite aussi de travailler à partir d’instantanés de fichiers périmés lorsque les documents sont souvent mis à jour.
Une seule invite peut se diffuser vers plusieurs systèmes
Avec le serveur de système de fichiers et Notion actifs, une seule invite peut déclencher un flux de travail combiné. Un exemple consistait à rechercher un sujet, enregistrer les résultats dans un fichier local et créer une page Notion correspondante. La recherche a été effectuée une seule fois puis écrite vers deux destinations, un schéma souvent décrit comme fan out.
Les erreurs les plus fréquentes sont faciles à classer
Les commandes locales cassées affichent généralement une erreur claire de déconnexion, tandis qu’un JSON invalide peut empêcher le chargement du fichier de configuration et le réinitialiser aux valeurs par défaut. Une virgule manquante peut donc détruire une configuration fonctionnelle, ce qui rend les sauvegardes importantes. L’échec le plus déroutant est silencieux: placer un service hébergé comme Notion dans la configuration locale ne produit aucun avertissement utile et n’apparaît tout simplement jamais.
CONCLUSION
La règle pratique est simple: si un serveur MCP s’exécute sur la machine locale, il appartient au fichier de configuration; s’il s’exécute en ligne, il relève des connecteurs. Une fois les deux correctement configurés, Claude peut faire circuler l’information entre de vrais outils et documents avec beaucoup moins de travail manuel.
Poser une question