Agents IA

Serveur MCP : à quoi ça sert et comment en brancher un

Un serveur MCP est un programme qui donne à un agent IA un accès normalisé à un outil : un navigateur, GitHub, une base de données. Il se branche en une commande dans Claude Code, Codex ou Gemini CLI, sur votre machine ou à distance. Voici comment le choisir, l'installer et limiter ce qu'il peut faire, au moment où le protocole passe à deux versions par an.

Partager

Sommaire
Visuel officiel du blog Model Context Protocol : logo MCP et titre « A More Predictable Release Cycle for MCP » en blanc sur fond noir, date du 11 novembre 2026, noms de Den Delimarsky et David Soria Parra, barres obliques grises et blanches à droite
© Model Context Protocol
Sommaire

En bref

  • MCP relie une application d’IA, l’hôte, à des serveurs qui lui exposent des outils, des ressources et des prompts.
  • Deux transports : stdio pour un serveur local, Streamable HTTP pour un serveur distant. L’ancien HTTP+SSE est déprécié.
  • Le 11 novembre 2026, les mainteneurs ont annoncé deux versions de la spécification par an. La prochaine, 2027-03-30, est prévue le 30 mars 2027.
  • Une commande suffit pour brancher un serveur : claude mcp add, codex mcp add ou gemini mcp add.
  • Un serveur MCP agit avec vos droits : jeton minimal, mode lecture seule et confirmation des outils.

Un serveur MCP, c’est quoi ?

MCP, pour Model Context Protocol, est un standard open source qui relie des applications d’IA à des systèmes externes. Sa documentation le compare à un port USB-C : une prise unique pour brancher des fichiers, des bases de données, des outils ou des services.

L’architecture compte trois rôles. L’hôte est l’application d’IA, par exemple Claude Code. Pour chaque serveur, il crée un client MCP qui tient une connexion dédiée. Le serveur est le programme qui fournit le contexte, qu’il tourne sur votre machine ou chez un éditeur.

Un serveur expose trois types de primitives :

  • les outils (tools), des fonctions que l’agent peut appeler : ouvrir une page, créer une issue, lancer une requête SQL ;
  • les ressources, des données de contexte : contenu de fichiers, enregistrements, réponses d’API ;
  • les prompts, des modèles de consignes réutilisables.

Le client découvre l’offre du serveur avec tools/list, resources/list ou prompts/list, puis appelle un outil avec tools/call.

Schéma officiel de MCP : à gauche des applications d’IA (interface de chat, IDE et éditeurs de code comme Claude Code, autres applications), au centre un bloc « MCP, Standardized protocol », à droite des sources de données et outils (PostgreSQL, SQLite, Git, Sentry, Slack), reliés par des flèches à double sens
© Model Context Protocol

stdio ou HTTP : les deux transports d’un serveur MCP

Un serveur MCP communique de deux façons :

  • stdio : le client lance le serveur comme un processus local et dialogue par l’entrée et la sortie standard, sans réseau. C’est le cas de Playwright MCP, lancé avec npx.
  • Streamable HTTP : le serveur répond à une adresse, reçoit des requêtes HTTP POST et sert en général de nombreux clients. Il accepte jetons bearer, clés d’API et en-têtes personnalisés ; MCP recommande OAuth. C’est le cas du serveur hébergé par GitHub.

L’ancien transport HTTP+SSE est officiellement déprécié depuis la spécification 2026-07-28, avec une transition d’un an.

Cette spécification, publiée le 28 juillet 2026, a aussi rendu le protocole sans état : chaque requête porte sa version et ses capacités, sans session. Selon les mainteneurs, n’importe quelle instance d’un serveur peut donc répondre derrière un simple répartiteur de charge.

Ce que change le calendrier annoncé le 11 novembre 2026

Le 11 novembre 2026, Den Delimarsky et David Soria Parra, mainteneurs principaux de MCP, ont annoncé un calendrier régulier. La spécification sortira tous les six mois, en général le dernier mardi de mars et de septembre. La prochaine version est visée pour le 30 mars 2027, sous le nom 2027-03-30.

Chaque cycle suit des étapes fixes : planification huit mois avant la sortie, gel souple deux mois et demi avant, bêtas des SDK de niveau 1 un mois et demi avant, gel strict un mois avant. Une proposition qui n’est pas prête passe à une version ultérieure au lieu de retarder la sortie.

Pour vos serveurs, rien à modifier : selon l’annonce du projet MCP, ce changement porte sur la préparation des versions, pas sur les messages ni sur la négociation de version. Il donne surtout des dates fixes pour tester vos clients et serveurs avec les bêtas des SDK avant chaque sortie.

Frise officielle des deux prochains cycles de MCP : version 2027-03-30 puis version 2027-09-28, avec les phases de planification, de revue, de gel souple et de gel strict, les bêtas des SDK de niveau 1, un chevauchement de deux mois et une cadence de six mois
© Model Context Protocol

Playwright MCP et GitHub MCP : deux serveurs utiles pour coder

Playwright MCP, publié par Microsoft, donne à l’agent un navigateur piloté par Playwright. Selon Microsoft, il s’appuie sur l’arbre d’accessibilité de la page, pas sur des captures d’écran, ce qui évite de recourir à un modèle de vision.

Playwright MCP demande Node.js 20 ou plus récent. Sa dernière version, la 0.0.86, a été publiée le 18 novembre 2026 sur npm. La configuration standard fonctionne dans la plupart des clients :

json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

Par défaut, Playwright MCP utilise un profil de navigateur persistant, distinct pour chaque projet, qui conserve les connexions d’une session à l’autre. L’option --isolated garde le profil en mémoire, sans l’écrire sur le disque.

Le serveur MCP de GitHub permet à l’agent de parcourir le code, de gérer issues et pull requests, et de suivre les exécutions de GitHub Actions. GitHub l’héberge à l’adresse https://api.githubcopilot.com/mcp/, et une version locale existe en image Docker, ghcr.io/github/github-mcp-server. Sa version 2.2.0 a été publiée le 16 novembre 2026.

Sans réglage, il charge les jeux d’outils context, repos, issues, pull_requests et users. Pour le serveur hébergé, ajouter /readonly à l’adresse ne garde que les outils de lecture : https://api.githubcopilot.com/mcp/readonly. En local, l’option --read-only produit le même effet.

Comment brancher un serveur MCP dans Claude Code

Claude Code ajoute un serveur avec claude mcp add. Pour Playwright, Microsoft donne cette commande :

Terminal
claude mcp add playwright npx @playwright/mcp@latest

Si vous passez des options au serveur, placez -- entre les options de Claude Code et la commande du serveur. Sans ce séparateur, Claude Code tenterait de lire --isolated comme l’une de ses propres options :

Terminal
claude mcp add playwright -- npx @playwright/mcp@latest --isolated

Pour GitHub, la documentation de Claude Code passe par un jeton d’accès personnel à granularité fine, limité aux dépôts utiles :

Terminal
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer ${GITHUB_PAT}"

Le shell remplace ${GITHUB_PAT} au lancement : le jeton est donc écrit dans ~/.claude.json, hors du dépôt avec la portée locale. La commande ne vérifie pas le jeton : lancez /mcp dans une session, la ligne du serveur doit afficher une coche et non un ✘.

Le choix de la portée décide où la configuration est rangée :

  • locale, par défaut (--scope local) : le projet courant, pour vous seul, dans ~/.claude.json ;
  • projet (--scope project) : le projet, partagé via Git, dans .mcp.json à la racine ;
  • utilisateur (--scope user) : tous vos projets, dans ~/.claude.json.

Pour partager le serveur GitHub avec votre équipe sans livrer de jeton, .mcp.json accepte des variables d’environnement dans url et headers :

.mcp.json
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${GITHUB_PAT}"
      }
    }
  }
}

En session interactive, Claude Code demande votre accord avant d’utiliser les serveurs d’un .mcp.json de projet, et un dépôt cloné ne peut pas approuver ses propres serveurs. Attention : avec claude -p, l’Agent SDK ou une session cloud hors projet, cette question n’apparaît pas et les serveurs du projet se chargent sans demander. Pour en écarter un, ajoutez-le à la liste disabledMcpjsonServers des réglages de Claude Code.

Ensuite, claude mcp list, claude mcp get github et claude mcp remove github suffisent à gérer la liste. Le détail des options figure dans la documentation MCP de Claude Code.

Ajouter un serveur MCP à Codex

Codex CLI, que nous détaillons dans notre tutoriel d’installation de Codex CLI, a sa propre commande codex mcp add :

Terminal
codex mcp add playwright npx "@playwright/mcp@latest"
codex mcp add github --url https://api.githubcopilot.com/mcp/ --bearer-token-env-var GITHUB_PAT

La documentation de Codex écrit aussi la forme avec -- avant la commande du serveur, celle du tableau plus bas. La seconde ligne n’écrit pas le jeton : Codex envoie le contenu de la variable d’environnement GITHUB_PAT dans l’en-tête Authorization. Les serveurs sont enregistrés dans ~/.codex/config.toml, que partagent la CLI et l’extension IDE. Ce fichier règle aussi la confirmation des outils :

~/.codex/config.toml
[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"
bearer_token_env_var = "GITHUB_PAT"
default_tools_approval_mode = "writes"

default_tools_approval_mode accepte auto, prompt, writes et approve. Avec writes, Codex demande votre accord pour tout outil qui n’est pas marqué en lecture seule. Les clés enabled_tools et disabled_tools filtrent les outils exposés.

Pour un serveur qui utilise OAuth, lancez codex mcp login <nom>, avec --no-browser sur une machine sans navigateur. codex mcp list affiche les serveurs configurés, et /mcp les serveurs actifs dans l’interface.

Gemini CLI et Antigravity CLI : la même logique

Gemini CLI, dont la version 0.70.0 a été publiée le 19 novembre 2026, propose gemini mcp add. Les options se placent avant le nom du serveur :

Terminal
gemini mcp add playwright npx @playwright/mcp@latest
gemini mcp add -s user --transport http --header "Authorization: Bearer ${GITHUB_PAT}" github https://api.githubcopilot.com/mcp/readonly

Attention à la portée : par défaut, Gemini CLI écrit dans le fichier du projet, .gemini/settings.json. Avec -s user, le serveur va dans ~/.gemini/settings.json, hors du dépôt, ce qui convient mieux à une configuration qui contient un jeton. Les options --include-tools et --exclude-tools filtrent les outils, et gemini mcp list liste les serveurs. Évitez --trust, qui supprime toutes les demandes de confirmation : la documentation le réserve aux serveurs que vous contrôlez entièrement.

Google publie aussi une procédure de migration vers Antigravity CLI, la commande agy, dont nous parlons dans notre article sur Gemini 4 Neon. Les serveurs MCP y quittent settings.json pour ~/.gemini/config/mcp_config.json (global) ou .agents/mcp_config.json (espace de travail). Un serveur distant doit utiliser Streamable HTTP, avec la clé serverUrl. Dans la session, /mcp ouvre le gestionnaire de serveurs.

Les commandes MCP des trois outils

Action Claude Code Codex CLI Gemini CLI
Serveur local claude mcp add <nom> -- <commande> codex mcp add <nom> -- <commande> gemini mcp add <nom> <commande>
Serveur HTTP claude mcp add --transport http <nom> <url> codex mcp add <nom> --url <url> gemini mcp add --transport http <nom> <url>
Lister claude mcp list codex mcp list gemini mcp list
État en session /mcp /mcp /mcp
Fichier ~/.claude.json, .mcp.json ~/.codex/config.toml .gemini/settings.json, ~/.gemini/settings.json

Où trouver un serveur MCP : le registre officiel

Le registre MCP est le catalogue officiel des métadonnées des serveurs MCP accessibles publiquement. Il est encore en préversion, et des changements incompatibles restent possibles. Il ne stocke pas de code, seulement des métadonnées qui pointent vers npm, PyPI, Docker Hub ou l’adresse d’un serveur distant.

Les noms suivent un format DNS inversé, comme io.github.github/github-mcp-server, rattaché à un compte GitHub ou à un domaine vérifié. En revanche, le registre délègue l’analyse de sécurité aux registres de paquets et aux catalogues qui le reprennent. Une recherche « github-mcp-server » y renvoie, à côté du serveur officiel de GitHub, des serveurs d’autres éditeurs au nom presque identique. Vérifiez l’espace de noms avant d’installer un serveur.

Limites et points de vigilance

Un protocole encore jeune

MCP change vite, et vos outils doivent suivre. Le transport HTTP+SSE, déprécié depuis la spécification du 28 juillet 2026, ne bénéficie que d’une transition d’un an : un serveur distant qui l’utilise encore devra passer à Streamable HTTP, que la migration vers Antigravity CLI exige déjà. Avec une nouvelle version de la spécification tous les six mois, prévoyez aussi de tester vos serveurs et clients à chaque cycle, sur les bêtas des SDK.

Les trois outils n’appliquent pas non plus les mêmes règles par défaut : portée du fichier, confirmation des outils, chargement des serveurs d’un projet. Un serveur bien réglé dans Claude Code ne l’est pas forcément dans Codex ou Gemini CLI : vérifiez chaque client.

Permissions : un serveur MCP agit avec vos droits

Anthropic recommande de vérifier que chaque serveur est digne de confiance avant de le connecter, car un serveur qui récupère du contenu externe vous expose à l’injection de prompt. Quelques réglages réduisent le risque :

  • Jetons au plus juste : un jeton GitHub à granularité fine, limité aux dépôts nécessaires ; pour une base de données, un utilisateur en lecture seule, comme le conseille la documentation de Claude Code.
  • Lecture seule d’abord : l’adresse /readonly ou l’option --read-only pour GitHub, puis l’écriture seulement si le besoin est réel.
  • Contenu public filtré : en local, l’option --lockdown-mode du serveur GitHub masque, dans les dépôts publics, le contenu des auteurs sans droit d’écriture. Selon GitHub, ce filtre, appliqué au mieux, vise à réduire le risque d’injection de prompt, sans limiter les droits du jeton.
  • Confirmations conservées : writes ou prompt dans Codex, pas de --trust dans Gemini CLI, approbation des .mcp.json en session interactive dans Claude Code, disabledMcpjsonServers pour les exécutions automatisées.

Playwright MCP prévient lui-même qu’il n’est pas une frontière de sécurité, et ses options --allowed-origins et --blocked-origins non plus. Sa limite d’accès aux fichiers du dossier de travail n’est qu’un garde-fou : son README conseille de s’appuyer sur les permissions du client.

MCP ou simple CLI : que choisir pour un agent de code ?

Microsoft donne son avis dans le README de Playwright MCP : pour un agent de code, il conseille plutôt Playwright CLI avec des skills. Selon lui, un appel en ligne de commande coûte moins de jetons : l’agent ne charge ni gros schémas d’outils ni arbres d’accessibilité verbeux dans son contexte. MCP garde l’avantage pour les boucles qui ont besoin d’un état persistant et d’une analyse fine de la page : exploration, tests qui se réparent, longues tâches autonomes.

Les clients réduisent aussi ce coût. Claude Code active par défaut la recherche d’outils : seuls les noms des outils et les consignes des serveurs sont chargés au démarrage. Antigravity CLI charge les outils MCP à la demande par défaut.

En pratique, si l’agent a déjà un terminal et qu’une CLI éprouvée existe, comme git, gh ou psql, elle suffit souvent. Un serveur MCP se justifie pour un service distant sans CLI ou protégé par OAuth, une configuration partagée par plusieurs clients, des outils à confirmer un par un, ou une session qui garde un état, comme un navigateur. D’autres outils pour agents sont présentés dans notre rubrique agents IA.

Questions fréquentes

MCP est-il réservé à Claude ?

Non. MCP est un standard open source, que Claude Code, Codex, Gemini CLI et Antigravity CLI savent tous utiliser. La documentation du protocole cite aussi ChatGPT, Visual Studio Code et Cursor parmi les clients compatibles. Un même serveur MCP sert donc dans plusieurs outils, seule la commande d’ajout change.

Comment installer Playwright MCP ?

Déclarez la commande npx @playwright/mcp@latest dans votre client, par exemple avec gemini mcp add playwright npx @playwright/mcp@latest dans Gemini CLI, ou collez la configuration JSON standard. Il faut Node.js 20 ou plus récent.

Comment connecter le GitHub MCP server à Claude Code ?

Créez un jeton GitHub à granularité fine, placez-le dans la variable GITHUB_PAT, puis ajoutez le serveur hébergé avec claude mcp add --transport http et l’en-tête Authorization. Vérifiez la connexion avec /mcp. Pour commencer sans risque d’écriture, utilisez l’adresse qui se termine par /readonly.

Où trouver des MCP servers fiables ?

Commencez par le registre officiel, qui vérifie l’espace de noms de chaque éditeur, puis privilégiez les serveurs publiés par l’éditeur du service lui-même, comme GitHub ou Microsoft. Le registre ne contrôle pas le code : lisez le README et les permissions demandées avant d’installer.

Partager cet article