MCP dans Claude Code : connexion de serveurs, portées, MCP distant et exemples concrets

Ajouter un serveur

# local server over stdio (runs the command, talks over its stdin/stdout)
claude mcp add playwright -- npx @playwright/mcp@latest

# remote server over HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# with a header (API-key style auth)
claude mcp add --transport http posthog https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer $POSTHOG_API_KEY"

claude mcp list      # what is configured
claude mcp remove playwright

Les serveurs stdio sont des programmes que Claude Code lance pour vous — la plupart des serveurs communautaires sont des paquets npm ou Python exécutés de cette manière. Les serveurs distants sont des URL ; ils s’authentifient avec OAuth (exécutez /mcp dans une session et suivez le parcours dans le navigateur) ou avec un en-tête que vous fournissez lors de l’ajout, comme dans l’exemple PostHog. Consultez la documentation de chaque fournisseur pour connaître l’URL actuelle — les points de terminaison distants changent.

Portées et .mcp.json

• local (par défaut) — stocké dans vos paramètres utilisateur, uniquement pour ce projet. Serveurs personnels et privés.
• project (--scope project) — enregistré dans .mcp.json à la racine du dépôt et partagé avec toute personne qui le clone. Claude Code demande votre accord avant de faire confiance aux serveurs d’un projet pour la première fois.
• user (--scope user) — disponible dans tous les projets sur votre machine.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}

.mcp.json prend en charge l’expansion des variables d’environnement, ce qui permet au dépôt de fournir la définition du serveur tandis que chaque développeur fournit ses propres identifiants.

Utiliser un serveur dans une session

Une fois la connexion établie, les outils du serveur sont simplement disponibles — demandez « les erreurs des 24 dernières heures dans PostHog » et Claude Code appelle l’outil. Les ressources exposées par le serveur peuvent être référencées avec des mentions @ (@github:issue://123), ce qui les ajoute au contexte à la demande. Les prompts définis par un serveur apparaissent sous forme de commandes slash sous /mcp__<server>__<prompt>. /mcp affiche l’état de la connexion, vous permet de vous reconnecter ou de vous authentifier, et répertorie chaque outil avec sa description.

Exemples à reprendre

• PostHog MCP — analyse produit depuis l’agent : « quel indicateur de fonctionnalité contrôle ce code, et où en est son déploiement ? » PostHog publie un serveur MCP distant ; ajoutez-le avec --transport http et votre clé API personnelle dans un en-tête bearer.
• GitHub — tickets et pull requests comme contexte ; associez-le à l’Action du guide GitHub pour le cycle de revue.
• Playwright — un véritable navigateur pour les tests de bout en bout et pour vérifier l’interface que vous venez de modifier ; consultez le guide d’automatisation de l’assurance qualité.
• Postgres / SQLite — requêtes et migrations tenant compte du schéma ; attribuez-lui un utilisateur en lecture seule, sauf si vous souhaitez explicitement autoriser les modifications.
• Système de fichiers hors du dépôt — --add-dir est plus simple pour les répertoires supplémentaires ; MCP sert à accéder à ce qui n’est pas un fichier.

Coût et contexte

Chaque résultat d’outil renvoyé par un serveur MCP entre dans la conversation et est renvoyé à chaque échange ultérieur. Un serveur qui renvoie 5,000 lignes fait exploser le contexte. Privilégiez les outils avec des limites, demandez des résumés et /compact après une requête volumineuse. Les serveurs s’exécutent localement ou auprès du fournisseur ; ils ne passent pas par le point de terminaison du modèle, donc ANTHROPIC_BASE_URL=https://aiprimetech.io n’est pas affecté — seuls les tokens consommés par les résultats sont facturés.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Questions fréquentes

AI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.