Tutoriel serveur MCP 2026 : installer, configurer, exécuter

Ce qu'est réellement MCP

Le Model Context Protocol est une spécification publiée par Anthropic en novembre 2024. Il définit une manière standard pour les modèles de langage d'appeler des outils externes — et pour les outils externes de s'exposer aux modèles. Avant MCP, chaque intégration d'outil IA était sur mesure ; MCP rend les intégrations composables.

L'architecture est plus simple que son nom le laisse penser. Un serveur MCP est un processus qui s'exécute sur votre machine (ou à distance, pour les serveurs hébergés). Au démarrage de Claude Code, chaque serveur MCP configuré est lancé, Claude reçoit la liste des outils que ce serveur expose, puis peut appeler ces outils par leur nom au cours de n'importe quelle session. Toute la communication passe par stdin/stdout en JSON-RPC 2.0. Pas de HTTP, pas de ports, aucune configuration réseau pour les serveurs locaux.

Une présentation conceptuelle plus approfondie figure dans le primer Qu'est-ce que MCP. Ce billet se concentre sur la mise en place pratique.

Où vit la configuration

La configuration des serveurs MCP réside dans un fichier settings.json. Deux emplacements possibles :

• ~/.claude/settings.json — global ; s'applique à toutes les sessions Claude Code de cette machine
• .claude/settings.json (dans un répertoire de projet) — au niveau du projet ; s'applique uniquement quand Claude Code s'exécute dans ce répertoire et remplace la configuration globale pour les clés concernées

Le fichier au niveau projet est à privilégier pour les serveurs spécifiques au projet (un serveur de base de données limité à la chaîne de connexion d'un seul projet). Le fichier global convient aux serveurs que vous voulez voir partout (Fetch, GitHub).

La structure de configuration de base

La clé mcpServers dans settings.json est une table associative reliant un nom de serveur à sa configuration. Chaque configuration de serveur précise comment démarrer le processus.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_fine_grained_token_here"
      }
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Quelques remarques sur cette structure :

• Le drapeau -y sur npx installe le paquet s'il est absent. Pratique au moment de la mise en place, mais légèrement plus lent au premier lancement. Vous pouvez épingler une version pour éviter cela : @modelcontextprotocol/server-filesystem@0.6.0.
• Les identifiants vont dans l'objet env, jamais comme arguments en ligne de commande. Les arguments sont journalisés ; les variables d'environnement, par défaut, ne le sont pas.
• Les noms de serveur (les clés) sont arbitraires — ils servent uniquement dans les messages d'erreur et les descriptions d'outils côté Claude.

Les cinq serveurs à installer en premier

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_TOKEN": "github_pat_..."
    }
  }
}

{
  "playwright": {
    "command": "npx",
    "args": ["-y", "@playwright/mcp@latest"]
  }
}

{
  "fetch": {
    "command": "uvx",
    "args": ["mcp-server-fetch"]
  }
}

Vérifier qu'un serveur fonctionne

Après avoir modifié votre settings.json, démarrez une nouvelle session Claude Code. Au prompt, demandez à Claude la liste des outils disponibles :

Quels outils MCP as-tu à ta disposition ?

Claude doit alors énumérer les serveurs configurés et les outils qu'ils exposent. Si un serveur manque à l'appel, la cause se résume presque toujours à l'une de ces trois pannes :

1. Le paquet n'est pas installé. Le drapeau -y de npx l'installe, mais la première exécution peut échouer si le registre npm est lent ou si votre réseau est filtré par un pare-feu. Lancez la commande npx manuellement dans un terminal pour voir l'erreur.
2. Le chemin est incorrect. Le serveur Filesystem prend un chemin absolu. Un chemin relatif ou comportant une faute de frappe provoque un échec au démarrage. Claude Code journalise les erreurs des serveurs MCP dans ~/.claude/logs/ — c'est le premier endroit à inspecter.
3. L'identifiant est invalide. Si le serveur démarre mais que ses outils renvoient des erreurs, la cause la plus fréquente est une clé d'API expirée ou mal configurée. Testez l'identifiant directement avec curl ou dans le bac à sable d'API du fournisseur avant de déboguer la couche MCP.

Configuration projet ou globale

Un schéma courant chez Septim : la configuration globale embarque Fetch, Memory et Playwright — des serveurs utiles dans n'importe quel projet. La configuration projet héberge Filesystem (avec la racine du projet en chemin autorisé), le serveur de base de données du projet et GitHub (limité au dépôt du projet).

Cette structure permet d'entrer dans n'importe quel répertoire de projet et d'avoir Claude Code qui charge automatiquement les bons serveurs sans que vous ayez à basculer manuellement entre des configurations. Le fichier projet remplace le fichier global pour les serveurs de même nom : vous pouvez ainsi avoir des connexions de bases de données différentes par projet sans qu'elles n'entrent en conflit.

Serveurs MCP distants

Anthropic a ajouté début 2026 la prise en charge des serveurs MCP distants (accédés en SSE plutôt qu'en stdio). La configuration utilise alors une clé url à la place de command et args :

{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Les serveurs distants sont pratiques pour les services qui maintiennent leur propre point d'entrée MCP hébergé (Stripe et plusieurs autres en proposent). Le compromis : un aller-retour réseau par appel d'outil et un identifiant qui circule sur le réseau — n'utilisez que des hôtes distants en HTTPS et traitez l'en-tête d'autorisation comme une clé d'API placée dans une variable d'environnement.

Considérations de sécurité avant d'ajouter d'autres serveurs

Chaque serveur que vous ajoutez élargit la surface d'attaque de votre session Claude Code. La checklist de vulnérabilité serveur MCP couvre le référentiel d'évaluation en 24 points. La version courte pour les tutoriels :

• N'installez que des serveurs portés par une organisation active ou par une entreprise éditrice
• Lisez les descriptions d'outils dans le code source avant l'installation — des instructions malveillantes intégrées aux métadonnées d'outils sont un vecteur d'attaque documenté (arXiv 2603.22489)
• Utilisez la portée d'identifiant minimale — un jeton GitHub destiné à lire un seul dépôt ne doit pas avoir d'accès en écriture sur tous les dépôts
• Maintenez .claude/settings.json hors de git s'il contient des identifiants

La liste curatée complète des serveurs qui méritent d'être lancés — chacun avec sa réserve de sécurité — figure dans le billet meilleurs serveurs MCP 2026.