MCP avec Claude pas-à-pas : utiliser le Model Context Protocol (2026)

📍 Article principal du cluster : Claude AI : le guide pratique 2026
Cet article fait partie du cluster « Claude AI 2026 ». Pour fabriquer vos propres serveurs MCP côté développeur, voir MCP servers : tutoriel développeur 2026.

Le Model Context Protocol — MCP — est probablement la brique technique la plus structurante de l’IA en 2026 (informations vérifiées en avril 2026, susceptibles d’évoluer ; vérifier la source officielle avant toute décision technique), et pourtant beaucoup d’utilisateurs le perçoivent encore comme un sujet de développeur. Mauvaise lecture. MCP est aux modèles d’IA ce que l’USB-C est aux périphériques : un standard universel qui permet à Claude — mais aussi ChatGPT, VS Code, Cursor — de se brancher sur n’importe quel outil ou source de données.

Ce tutoriel vous emmène pas à pas, depuis la compréhension du concept jusqu’à l’installation et l’usage de votre premier serveur MCP, sans coder. Vous repartirez avec deux ou trois serveurs branchés à votre Claude — par exemple un serveur filesystem qui lui donne accès à un dossier précis de votre disque, un serveur GitHub pour vos dépôts, un serveur PostgreSQL pour explorer une base — et vous saurez les déboguer quand quelque chose coince.

Prérequis

• Compte Claude payant (Pro minimum recommandé).
• Application bureau Claude installée (les MCP locaux fonctionnent surtout depuis l’app, pas depuis le web).
• Pour Claude Code, accès au terminal et au binaire claude.
• Niveau : intermédiaire. Aisance avec un terminal recommandée pour les MCP locaux.
• Temps estimé : 75 minutes.

Étape 1 — Comprendre MCP en deux minutes

Reprenons l’analogie officielle d’Anthropic. Avant l’USB-C, chaque appareil avait son connecteur : Apple avait Lightning, certains PC avaient mini-USB, d’autres micro-USB, les disques avaient eSATA. Pour brancher un disque dur sur un MacBook, il fallait un adaptateur. L’USB-C a normalisé : un seul port, qui se branche partout, qui transporte n’importe quoi.

Pour les modèles d’IA, le problème équivalent était : comment Claude lit-il votre Drive ? Comment Claude accède-t-il à votre base de données ? Comment ChatGPT consulte-t-il votre filesystem ? Avant MCP, chaque éditeur de modèle avait sa propre API d’intégration, ses propres formats. Construire une intégration pour Claude n’aidait pas pour ChatGPT, et inversement.

MCP normalise cette couche. Un serveur MCP expose des données ou des outils selon un protocole standard. Un client MCP — Claude, ChatGPT, VS Code, Cursor — sait parler à n’importe quel serveur MCP conforme. Conséquence directe : le travail d’un développeur qui code un serveur MCP « accès à notre base produit » sert tous les modèles à la fois. C’est l’effet réseau qui a fait décoller le standard très vite après son lancement par Anthropic.

Étape 2 — Différencier MCP, Connecteurs et Skills

Beaucoup d’utilisateurs confondent ces trois notions. Voici la distinction nette.

Un Connecteur est une intégration officielle de bout en bout, livrée par Anthropic, qui s’active en deux clics — Drive, Gmail, GitHub, Notion. Vous n’avez rien à installer ; tout est géré côté serveur. C’est l’option la plus simple quand le service que vous voulez brancher fait partie de la liste officielle.

Un serveur MCP est plus ouvert. Il peut être local — tournant sur votre machine — ou distant. Il expose des données ou outils sur mesure. Vous l’installez vous-même, soit par une commande simple type npx ou uvx, soit par un téléchargement. C’est l’option quand vous voulez brancher quelque chose qui n’a pas de Connecteur officiel : un dossier précis de votre disque, votre base PostgreSQL locale, un outil métier interne, un service obscur qui n’intéressera jamais Anthropic.

Une Skill est une instruction durable, pas une connexion à des données. Une Skill apprend à Claude un savoir-faire (« comment rédiger un rapport mensuel ITSkillsCenter ») ; un MCP lui donne accès à de l’information ou des actions. Les trois se combinent : vous pouvez avoir une Skill « Rapport mensuel », un Connecteur Drive, et un MCP custom qui requête votre base CRM, et tous travaillent ensemble dans une même mission Cowork.

Étape 3 — Installer votre premier MCP : filesystem

Le MCP filesystem est le plus simple à appréhender et le plus immédiatement utile. Il donne à Claude accès à un dossier précis de votre disque — pas plus, pas moins. Vous lui désignez le dossier, Claude peut lire et éventuellement écrire dedans, mais reste cadenassé en dehors.

Sur Claude Code, lancez :

claude mcp add filesystem --path ~/dev/mon-projet

La commande installe le MCP filesystem officiel, paramétré pour le dossier ~/dev/mon-projet. Vérifiez :

claude mcp list

Vous devez voir filesystem avec le statut « connected » et le chemin autorisé. Lancez ensuite une session Claude :

claude
> Liste-moi les fichiers de ce projet et identifie ceux qui sont les plus récents.

Claude répond avec une vraie liste de fichiers, lue depuis votre dossier. Si un fichier est modifié pendant la session, Claude le voit à la prochaine requête. Vous avez votre premier MCP en main.

Étape 4 — MCP GitHub officiel

Le MCP GitHub officiel donne à Claude accès à vos dépôts pour lecture (issues, PR, code) et, sur autorisation, écriture (commenter, créer une issue, ouvrir une PR). Installez :

claude mcp add github

Le navigateur s’ouvre pour l’OAuth GitHub. Comme pour le Connecteur GitHub, choisissez « Dépôts sélectionnés » et listez explicitement les dépôts auxquels Claude aura accès. Validez. Le MCP s’installe et apparaît dans mcp list.

Testez :

claude
> Liste les 5 dernières issues ouvertes du dépôt monorga/monrepo, classées par date de mise à jour.

Claude doit retourner les vraies issues. Si vous obtenez une erreur de permission, repassez sur GitHub Settings → Applications et vérifiez que le dépôt est bien dans la liste autorisée. Pour ajouter d’autres dépôts ensuite, on peut soit étendre l’autorisation côté GitHub, soit révoquer et re-brancher.

Étape 5 — MCP PostgreSQL pour explorer une base

Cas d’usage très puissant : brancher Claude à une base PostgreSQL pour explorer le schéma, lancer des requêtes, comprendre la structure d’une donnée. Vous ne donnez à Claude qu’un compte en lecture seule — c’est la précaution minimale, et elle est strictement non négociable.

Installation — exemple avec un serveur PostgreSQL local :

claude mcp add postgres --url "postgresql://lecteur:motdepasse@localhost:5432/ma_base"

Le compte lecteur est un utilisateur PostgreSQL que vous avez créé spécialement, avec uniquement le droit SELECT sur les schémas pertinents. Voici la commande SQL pour le créer dans psql :

CREATE USER lecteur WITH PASSWORD 'motdepasse';
GRANT CONNECT ON DATABASE ma_base TO lecteur;
GRANT USAGE ON SCHEMA public TO lecteur;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO lecteur;

Une fois branché, testez dans Claude :

Décris-moi le schéma de la base : liste les tables, leurs colonnes principales,
et les relations entre elles. N'exécute pas de SELECT * sur des tables larges.

Claude requête le catalogue PostgreSQL, vous restitue le schéma, et peut ensuite répondre à des questions analytiques (« combien de clients actifs au mois dernier ») via des requêtes ciblées. Si jamais vous donnez un compte en écriture par erreur, fermez la session et révoquez immédiatement les droits.

Étape 6 — Découvrir d’autres MCP utiles

L’écosystème MCP croît vite. Quelques serveurs qui valent le détour selon votre métier. MCP Slack pour permettre à Claude de poster ou résumer des canaux désignés. MCP Brave Search ou MCP Tavily pour des recherches web alternatives à celle intégrée. MCP Memory pour stocker une mémoire persistante hors du contexte Claude. MCP Puppeteer pour piloter un navigateur headless. MCP Linear ou MCP Jira pour les équipes produit.

Pour explorer le catalogue, le hub officiel modelcontextprotocol.io liste les serveurs MCP communautaires. Avant d’installer un serveur tiers, vérifiez deux choses : qu’il provient d’un éditeur identifiable (organisation officielle ou contributeur reconnu), et qu’il est récemment mis à jour (un dépôt non touché depuis six mois est suspect).

Étape 7 — Configurer manuellement un MCP via fichier de config

Pour un usage avancé, vous pouvez gérer la liste des MCP en éditant directement le fichier de configuration. Sur Claude Code, ce fichier est ~/.claude/mcp.json. Voici un exemple :

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/moi/dev"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres",
               "postgresql://lecteur:motdepasse@localhost:5432/ma_base"]
    }
  }
}

Cette voie est utile pour versionner votre configuration MCP dans un dépôt d’équipe, ou pour scripter l’installation sur plusieurs postes. Après modification, redémarrez Claude Code (claude restart ou simplement quitter et relancer) pour que les changements prennent effet.

Étape 8 — Déboguer un MCP qui ne répond pas

Quand un MCP est installé mais ne répond pas, voici la séquence de débogage. D’abord, claude mcp list confirme-t-il bien que le serveur est « connected » ? Si « disconnected » ou « error », passez au point suivant. Sinon, c’est probablement un problème de prompt — Claude n’invoque pas le serveur parce qu’il ne pense pas que c’est pertinent. Reformulez en explicitant : « utilise le serveur MCP filesystem pour lister… ».

Ensuite, lancez les logs détaillés :

claude mcp logs filesystem

Vous voyez les messages échangés entre Claude et le serveur. Les erreurs typiques : permission denied (le dossier ou la base n’est pas accessible), timeout (serveur trop lent), version protocol mismatch (le serveur MCP utilise une version trop ancienne ou trop neuve). Pour les problèmes de version, mettez à jour le paquet npm sous-jacent : npm update @modelcontextprotocol/server-filesystem.

Pour les MCP distants (qui tournent ailleurs que sur votre machine), vérifiez que l’URL est joignable et que le port n’est pas bloqué par votre firewall. Sur les réseaux d’entreprise africains qui parfois bloquent des ports moins communs, c’est une cause fréquente de panne silencieuse.

Étape 9 — Bonnes pratiques de sécurité

Brancher des MCP étend significativement ce que Claude peut voir et faire sur votre machine. Quelques règles à graver. Premièrement, jamais de credentials en dur dans la commande — utilisez des variables d’environnement et un fichier .env non versionné. Deuxièmement, comptes en lecture seule par défaut sur tout MCP qui touche à une donnée structurée (DB, API, etc.) ; l’écriture est l’exception qui se justifie cas par cas. Troisièmement, périmètres minimaux : un MCP filesystem sur un dossier précis, pas sur /.

Enfin, audit régulier de la liste des MCP installés. Sur chaque poste de l’équipe, faites le tour tous les trimestres. Désinstallez les MCP que vous n’utilisez plus. claude mcp remove nomduserveur nettoie en une commande. Ce n’est pas pénible, et ça réduit considérablement votre surface d’attaque.

Étape 10 — Vérifier votre maîtrise

Critères de validation. Premier : vous avez au moins deux MCP installés et utilisés cette semaine. Deuxième : vous avez audité les permissions de chacun et confirmé qu’elles sont minimales. Troisième : quand un MCP coince, vous savez ouvrir les logs et identifier la cause sans paniquer.

Si les trois sont OK, vous tenez l’outil. Pour aller plus loin — créer vos propres serveurs MCP en code — basculez sur le tutoriel développeur dédié à la fabrication de serveurs MCP.

Erreurs fréquentes

Adaptation au contexte ouest-africain

Pour un développeur freelance ou une PME tech à Dakar, les MCP les plus rentables sont, dans l’ordre : filesystem (pour pointer Claude sur le dossier d’un projet client), GitHub (pour les dépôts d’équipe), et un MCP base de données si vous gérez des bases applicatives. Le branchement Slack vient ensuite pour les équipes en remote synchrone.

Question pratique pour les connexions distantes : si votre base de données est hébergée sur un VPS en Europe (Hetzner, Contabo, OVH) et que vous travaillez depuis l’Afrique, la latence ajoute environ 200 ms par requête. C’est invisible pour des SELECT simples, perceptible quand Claude lance des requêtes en cascade. Privilégiez les requêtes agrégées plutôt que la pagination ligne par ligne.

Pour les usages comptables PME, un cas d’usage concret : un MCP Google Sheets ou Drive sur le fichier Suivi paiements 2026.xlsx qui consolide vos rentrées Wave, Orange Money et virements bancaires. Vous demandez à Claude « combien de paiements en retard de plus de 30 jours, et quel montant total » et il répond depuis votre source de vérité, sans copier-coller.

Tutoriels frères

• MCP servers : tutoriel développeur 2026 — pour fabriquer vos propres serveurs MCP en code.
• Connecteurs Claude — la version « clé en main » des MCP officiels.
• Claude Code : workflows quotidiens — où les MCP s’intègrent au flux dev.

Pour aller plus loin

• 🔝 Retour au pilier : Claude AI : le guide pratique 2026
• Documentation officielle : modelcontextprotocol.io
• Liste des clients MCP : modelcontextprotocol.io/clients
• Suggestion : si vous êtes développeur, enchaînez avec MCP servers : tutoriel développeur.

FAQ

MCP est-il un standard Anthropic ou un standard ouvert ?
Initié par Anthropic, désormais ouvert avec une gouvernance qui s’autonomise. Implémenté par Claude, ChatGPT, VS Code, Cursor, MCPJam, et beaucoup d’autres clients indépendants. Les serveurs MCP fonctionnent indifféremment avec n’importe quel client conforme.

Puis-je utiliser des MCP sans Claude Code ?
Oui, mais avec des limites. L’application bureau Claude supporte un sous-ensemble de MCP via la même config. Le chat web claude.ai s’appuie sur les Connecteurs officiels plutôt que sur les MCP locaux. La voie la plus complète aujourd’hui pour un usage MCP avancé reste Claude Code.

Un MCP peut-il transmettre mes données à un tiers ?
Techniquement, le serveur MCP que vous installez peut faire ce que son code fait. C’est pourquoi le choix de la source compte : un serveur MCP officiel ou écrit par une organisation reconnue est plus sûr qu’un serveur trouvé sur un dépôt obscur. Lisez le code avant d’installer un MCP communautaire.

Combien de MCP puis-je avoir installés en parallèle ?
Pas de limite stricte. En pratique, gardez moins de quinze MCP actifs — au-delà, le démarrage de Claude Code ralentit, et la confusion sur lequel invoquer s’installe. Désinstallez ce qui n’est pas utile.

Y a-t-il des MCP officiels pour les wallets africains ?
Non à date. La communauté MCP est encore principalement nord-américaine et européenne. C’est une opportunité pour les développeurs francophones africains : écrire un MCP « Wave » ou « Orange Money » serait un projet open source à fort impact local.

Mots-clés secondaires : MCP utilisateur, model context protocol, claude mcp, serveur filesystem, postgres, débuter MCP.