MCP, c'est quoi ? Connecter son premier serveur pas à pas

MCP, c’est quoi ? MCP (Model Context Protocol) est un standard ouvert qui permet à une application d’IA comme Claude, ChatGPT ou Cursor de se connecter à des systèmes externes : fichiers, bases de données, agenda, Notion ou GitHub. Ses créateurs le comparent, dans la documentation officielle, à un port USB-C : une seule prise qui s’adapte à de nombreux appareils.

Dans ce tutoriel, j’explique comment MCP fonctionne sous le capot, puis on connecte un premier serveur MCP dans Claude Code (distant et local) et dans l’application Claude. Les commandes viennent de la documentation de Claude Code et du dépôt des serveurs de référence MCP.

MCP, c’est quoi en pratique ?

Un modèle de langage ne voit pas, à lui seul, vos fichiers ni votre agenda. Pour qu’un agent IA puisse agir dans le monde, il lui faut des outils (j’ai expliqué ce qu’est un agent dans Qu’est-ce qu’un agent IA). Sans standard commun, chaque application devrait brancher chaque outil à sa façon.

MCP change la donne : quelqu’un écrit une fois un serveur MCP pour un service, et toute application compatible avec le protocole peut ensuite s’en servir. La documentation donne des exemples de ce que ça permet :

1. un agent qui a accès à votre Google Agenda et à Notion,
2. Claude Code qui construit une application web complète à partir d’une maquette Figma,
3. un chatbot d’entreprise branché sur plusieurs bases de données à la fois,
4. un modèle qui conçoit un objet 3D dans Blender et l’envoie à l’imprimante.

D’où vient MCP ?

Anthropic a publié MCP en open source le 25 novembre 2024. Un an plus tard, le 9 décembre 2025, l’entreprise a confié le protocole à l’Agentic AI Foundation, un fonds rattaché à la Linux Foundation que cofondent aussi OpenAI et Block. MCP n’appartient donc plus à une seule entreprise.

Aujourd’hui, le protocole est pris en charge entre autres par Claude, ChatGPT, Visual Studio Code et Cursor : un serveur écrit une fois fonctionne donc à plein d’endroits.

Comment fonctionne MCP sous le capot ?

D’après la description de l’architecture, MCP compte trois rôles :

1. l’hôte (host), c’est-à-dire l’application d’IA que vous utilisez (par exemple Claude Code ou Claude Desktop),
2. le client, un composant à l’intérieur de l’hôte. L’hôte crée un client distinct pour chaque serveur,
3. le serveur, le programme qui fournit les données et les outils.

Un serveur peut tourner en local (sur votre machine, en communiquant via l’entrée et la sortie standard, ce qu’on appelle « stdio ») ou à distance (sur internet, via « Streamable HTTP »). Les messages utilisent le format JSON-RPC 2.0.

Un serveur expose trois types d’éléments :

1. des outils (tools), c’est-à-dire des fonctions que le modèle peut appeler, comme une requête en base de données ou l’écriture d’un fichier,
2. des ressources (resources), c’est-à-dire des données de contexte, comme le contenu d’un fichier ou le schéma d’une base,
3. des prompts, c’est-à-dire des modèles d’interaction prêts à l’emploi.

Le principe est simple : le client demande au serveur la liste de ses outils (tools/list), le modèle en choisit un, puis le client l’appelle (tools/call) et renvoie le résultat au modèle. Détail intéressant : dans la version actuelle de la spécification (2026-07-28), le protocole est sans état. Chaque requête transporte tout ce dont le serveur a besoin pour la traiter.

Étape 1 : comment connecter un serveur MCP distant à Claude Code ?

Je pars du principe que Claude Code est déjà installé (sinon, commencez par mon tutoriel Claude Code). D’après la documentation, un serveur HTTP distant est l’option recommandée. La syntaxe de base ressemble à ceci :

claude mcp add --transport http <nom> <url>

L’exemple de la documentation, la connexion à Notion :

claude mcp add --transport http notion https://mcp.notion.com/mcp

La plupart des serveurs distants demandent une connexion. Dans ce cas, tapez /mcp dans la session Claude Code et connectez-vous dans le navigateur. La même commande affiche aussi l’état de tous les serveurs connectés.

Si le serveur utilise un jeton plutôt qu’une connexion, ajoutez un en-tête :

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Étape 2 : comment lancer un serveur MCP local ?

Un serveur local tourne sur votre ordinateur comme un processus ordinaire. Un bon premier exemple est le serveur de fichiers de référence, qui ne donne au modèle accès qu’aux dossiers indiqués. Il vous faut Node.js (pour npx).

La commande du serveur se place après --, et tout ce qui suit ce signe est transmis tel quel au serveur :

claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/notes

Le dernier argument est le dossier auquel le serveur a accès (vous pouvez en indiquer plusieurs). Le serveur fournit notamment les outils read_text_file, write_file, edit_file, list_directory et search_files. Vous pouvez maintenant demander à Claude Code, par exemple : « trouve dans mes notes tout ce qui concerne MCP et fais-en une liste ».

Si le serveur a besoin d’une clé API, passez-la avec --env. Un exemple tiré de la documentation :

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Étape 3 : comment gérer ses serveurs MCP ?

Trois commandes simples suffisent pour la gestion :

claude mcp list          # liste des serveurs
claude mcp get notion    # détails d'un serveur
claude mcp remove notion # suppression d'un serveur

La portée (scope) compte aussi, c’est-à-dire l’endroit où le serveur est enregistré :

Portée	Où il fonctionne	Partagé avec l’équipe ?	Où il est enregistré
local (par défaut)	projet en cours uniquement	non	~/.claude.json
project	projet en cours uniquement	oui, via le dépôt	.mcp.json dans le dossier du projet
user	tous vos projets	non	~/.claude.json

On choisit la portée avec l’option --scope, par exemple --scope user. Avec la portée project, gardez les clés API dans des variables d’environnement (${VAR} dans le fichier .mcp.json) pour qu’elles ne finissent pas dans le dépôt.

Étape 4 : comment ajouter un serveur MCP dans l’application Claude ?

Dans l’application Claude (web et desktop), les serveurs MCP s’appellent des connecteurs. On trouve des connecteurs prêts à l’emploi dans le répertoire des connecteurs, et on ajoute son propre serveur distant comme « custom connector ». D’après le centre d’aide de Claude :

1. allez dans Customize > Connectors,
2. cliquez sur « + Add », puis sur « Add custom connector »,
3. saisissez un nom et l’URL du serveur MCP distant,
4. vérifiez les paramètres d’authentification et cliquez sur « Add ».

Les connecteurs fonctionnent avec toutes les offres, mais l’offre gratuite ne permet d’ajouter qu’un seul connecteur personnalisé. Attention : Claude se connecte au serveur depuis le cloud d’Anthropic, le serveur doit donc être accessible depuis internet. D’autres fonctions de Claude utilisent aussi les connecteurs, par exemple l’agent Claude Duet.

À quoi faire attention ?

D’abord, à qui vous faites confiance. Un serveur MCP donne au modèle un vrai pouvoir d’action, et la documentation de Claude Code prévient clairement que les serveurs qui récupèrent du contenu externe vous exposent à l’injection de prompt (prompt injection). Le centre d’aide ajoute que des serveurs malveillants peuvent contenir des instructions cachées qui tentent de pousser Claude à des actions non voulues. Ne connectez que des serveurs d’entreprises et d’auteurs de confiance.

Ensuite, aux autorisations. Ne cliquez sur « Allow always » que pour les outils auxquels vous faites assez confiance pour les laisser agir sans surveillance. Bonne nouvelle : un dépôt cloné ne peut pas approuver lui-même ses serveurs de .mcp.json, Claude Code vous demande d’abord votre accord.

Enfin, à l’étendue de l’accès. Donnez au serveur de fichiers un dossier précis, pas tout le disque. J’en dis plus sur la protection des clés et des agents dans Sécurité des agents IA.

FAQ

MCP, c’est quoi en termes simples ?

C’est un standard commun grâce auquel les applications d’IA se connectent à des outils et à des données. Un serveur MCP écrit une fois fonctionne dans de nombreuses applications, comme un appareil USB-C fonctionne avec de nombreux ordinateurs.

MCP ne fonctionne-t-il qu’avec Claude ?

Non. Anthropic a créé le protocole, mais c’est aujourd’hui l’Agentic AI Foundation, au sein de la Linux Foundation, qui le fait évoluer, et il est pris en charge entre autres par ChatGPT, Visual Studio Code et Cursor.

Quelle différence entre un serveur MCP local et distant ?

Le serveur local tourne sur votre ordinateur et communique via stdio, généralement avec une seule application. Le serveur distant tourne sur internet (Streamable HTTP) et sert généralement plusieurs clients à la fois. Pour l’authentification, la spécification recommande OAuth.

MCP est-il gratuit ?

Le protocole lui-même est ouvert et gratuit. Vous payez l’application d’IA que vous utilisez et, le cas échéant, le service auquel le serveur se connecte.