EN

Guides pratiques

Configurer un serveur MCP dans Claude Code, Cursor et VS Code

Ce qu'est le Model Context Protocol, comment ajouter un serveur à Claude Code, Cursor et VS Code, les serveurs de référence et les règles de sécurité, d'après les documentations officielles.

Par ·

Un serveur MCP donne à un agent de code un accès à un outil extérieur : un dépôt GitHub, une base de données, un navigateur, la documentation d'une bibliothèque. Ce guide explique le protocole puis la configuration dans trois clients courants. Les commandes et fichiers sont repris des documentations officielles, vérifiées le 2026-10-20.

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est un standard open source qui relie des applications d'IA à des systèmes extérieurs : fichiers locaux, bases de données, outils comme un moteur de recherche, ou flux de travail. Ses auteurs le comparent à un port USB-C pour les applications d'IA (modelcontextprotocol.io). Voir aussi l'entrée MCP du glossaire.

Ajouter un serveur à Claude Code

Claude Code se configure en ligne de commande (Anthropic). Si l'agent n'est pas encore installé, voir notre guide Installer et prendre en main Claude Code.

Serveur distant (HTTP), l'option recommandée pour les services en ligne :

# Basic syntax
claude mcp add --transport http <name> <url>

# Real example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

Serveur local (stdio) : tout ce qui suit le -- est la commande qui lance le serveur.

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

Le transport SSE est déprécié : Anthropic conseille HTTP quand le serveur le permet. Pour gérer les serveurs :

# List all configured servers
claude mcp list

# Get details for a specific server
claude mcp get notion

# Remove a server
claude mcp remove notion

# (within Claude Code) Check server status
/mcp

Trois portées (option --scope) :

Un dépôt cloné ne peut pas approuver lui-même ses serveurs .mcp.json : ils restent en attente tant que vous n'avez pas accepté la fenêtre de confiance de l'espace de travail. Exemple officiel avec le serveur distant de GitHub, authentifié par un jeton d'accès personnel à portée limitée :

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

claude mcp add enregistre la configuration sans vérifier le jeton : contrôlez la connexion avec /mcp.

Ajouter un serveur à Cursor

Cursor propose une installation en un clic depuis sa Marketplace (page Customize, bouton « Add to Cursor », authentification OAuth), ou une configuration manuelle dans un fichier mcp.json (Cursor) :

Serveur local lancé par Node.js, tel que le montre la documentation de Cursor :

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Pour un serveur distant, l'entrée porte une clé url (et éventuellement headers) au lieu de command. Cursor prend en charge stdio, SSE et Streamable HTTP, et résout la syntaxe ${env:NAME} pour lire un secret dans une variable d'environnement plutôt que de l'écrire en clair.

Ajouter un serveur à VS Code

Dans VS Code, ouvrez la palette de commandes (⇧⌘P sur Mac, Ctrl+Shift+P sous Windows et Linux) et lancez MCP: Add Server (Microsoft). Choisissez HTTP si l'éditeur du serveur fournit une URL, Command (stdio) s'il fournit une commande. L'exemple de la documentation, le serveur Playwright, demande Node.js 18 ou plus récent :

node --version
npx --version

Choisissez Command (stdio) et saisissez :

npx -y @playwright/mcp@latest

Donnez un identifiant au serveur (par exemple playwright), puis choisissez où l'enregistrer :

Attention au format : les fichiers portables utilisent la clé mcpServers, le format propre à VS Code utilise servers. La galerie de serveurs (préversion) s'ouvre en tapant @mcp dans la vue Extensions. Microsoft recommande enfin de vérifier qu'un outil du serveur a bien été appelé dans la session : une configuration ajoutée ne prouve pas que l'agent s'en sert.

Les serveurs de référence

Le projet MCP maintient des serveurs de référence pour tester le protocole : Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking et Time (exemples officiels). Les serveurs TypeScript se lancent avec npx, les serveurs Python avec uvx :

npx -y @modelcontextprotocol/server-memory
uvx mcp-server-git

Les serveurs maintenus par les entreprises pour leurs propres plateformes sont listés dans le dépôt modelcontextprotocol/servers.

Sécurité : les règles à appliquer

Un serveur MCP local n'est pas un module isolé : c'est un processus ordinaire qui hérite de vos variables d'environnement, peut lire tout ce que votre compte peut lire (clés SSH, identifiants cloud, dossier personnel) et ouvrir des connexions réseau (modelcontextprotocol.io). Les recommandations officielles :

Anthropic demande aussi de vérifier qu'un serveur est digne de confiance avant de le connecter, en particulier s'il récupère du contenu extérieur (Anthropic). Cursor conseille des clés d'API à droits minimaux et, pour les intégrations critiques, la lecture du code source (Cursor).

Pour aller plus loin

Sources

À retenir : un serveur MCP s'ajoute en une commande ou quelques lignes de JSON, mais un serveur local tourne avec vos droits : n'installez que des serveurs d'éditeurs identifiés, à version figée, avec des accès limités.

Une erreur dans cet article ? Signalez-la · Notre politique de corrections

La lettre OrigoTech

Un résumé sourcé de l'actualité des outils IA, chaque semaine.

À lire aussi