Qu’est-ce que MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA d’utiliser des outils et des données par l’intermédiaire de serveurs. Un serveur est soit un programme local que l’assistant lance sur votre ordinateur et avec lequel il communique via l’entrée et la sortie standard (stdio), soit un serveur distant que l’assistant joint via HTTP. Chaque assistant enregistre ses serveurs dans son propre fichier de configuration, et chaque fichier se présente un peu différemment.

Comment l’utiliser

  1. Choisissez votre client : l’assistant ou l’éditeur que vous utilisez.
  2. Donnez au serveur un nom composé de lettres, de chiffres, de tirets et de traits de soulignement.
  3. Pour un serveur local, saisissez la commande qui le lance (par exemple npx, uvx ou docker), ses arguments, un par ligne, et les éventuelles variables d’environnement, comme des clés d’API, au format KEY=value. Si vous avez collé une ligne de commande complète dans le champ de commande, le bouton de séparation situé à l’intérieur déplace tout ce qui suit le premier mot vers les arguments.
  4. Pour un serveur distant, choisissez URL distante et saisissez l’URL du serveur ainsi que les éventuels en-têtes, comme Authorization: Bearer <token>.
  5. Copiez la configuration dans le fichier indiqué sous Où l’ajouter, ou téléchargez-la. Si le fichier contient déjà des serveurs, ajoutez la nouvelle entrée à la suite des autres dans mcpServers ([mcp_servers] dans Codex) plutôt que de remplacer tout le fichier.
  6. Redémarrez l’application ou rechargez ses serveurs MCP.

Pour Claude Code, Codex CLI, Gemini CLI et VS Code, le champ Commande fournit aussi la commande de terminal qui ajoute le serveur à votre place.

Clients

Client Fichier de configuration Bon à savoir
Claude Desktop claude_desktop_config.json Ne contient que des serveurs locaux. Les serveurs distants s’ajoutent dans l’application, sous Paramètres > Connecteurs > Ajouter un connecteur personnalisé.
Claude Code .mcp.json à la racine du projet claude mcp add enregistre plutôt les serveurs dans ~/.claude.json, pour vous seul.
Cursor .cursor/mcp.json dans le projet, ou ~/.cursor/mcp.json
VS Code avec GitHub Copilot .mcp.json à la racine de l’espace de travail, ou ~/.copilot/mcp-config.json L’ancien format servers de .vscode/mcp.json ne sert qu’à l’environnement local de VS Code, désormais obsolète.
Codex CLI ~/.codex/config.toml Un fichier TOML. Les en-têtes d’un serveur distant ne peuvent être définis que dans le fichier, pas avec codex mcp add.
Gemini CLI .gemini/settings.json dans le projet, ou ~/.gemini/settings.json Les serveurs distants utilisent httpUrl.
Devin Desktop (Windsurf) ~/.config/devin/mcp_config.json, ou .devin/mcp_config.json Windsurf a été renommé Devin Desktop. Les clés personnelles vont dans .devin/mcp_config.local.json, qui reste en dehors du contrôle de version.

Chrome enregistre un téléchargement nommé .mcp.json sous le nom mcp.json : rajoutez donc le point initial lorsque vous placez le fichier à son emplacement.

Protéger vos clés

Les fichiers de configuration stockent les clés d’API en texte clair. Ne versionnez pas un fichier de projet contenant de vraies clés dans un dépôt partagé. La plupart des clients peuvent lire une clé depuis votre environnement plutôt que depuis le fichier, chacun avec sa propre syntaxe, décrite dans sa documentation.

Tout est assemblé dans votre navigateur : les commandes, URL et clés que vous saisissez ne sont donc envoyées nulle part.