Connecter Claude Code aux outils via MCP

​

Ce que vous pouvez faire avec MCP

• Implémenter des fonctionnalités à partir de suivi de problèmes : « Ajouter la fonctionnalité décrite dans le problème JIRA ENG-4521 et créer une PR sur GitHub. »
• Analyser les données de surveillance : « Vérifier Sentry et Statsig pour vérifier l’utilisation de la fonctionnalité décrite dans ENG-4521. »
• Interroger les bases de données : « Trouver les e-mails de 10 utilisateurs aléatoires qui ont utilisé la fonctionnalité ENG-4521, en fonction de notre base de données PostgreSQL. »
• Intégrer les conceptions : « Mettre à jour notre modèle d’e-mail standard en fonction des nouvelles conceptions Figma qui ont été publiées sur Slack »
• Automatiser les flux de travail : « Créer des brouillons Gmail invitant ces 10 utilisateurs à une session de rétroaction sur la nouvelle fonctionnalité. »

​

Serveurs MCP populaires

​

Installation des serveurs MCP

​

Option 1 : Ajouter un serveur HTTP distant

# Syntaxe de base
claude mcp add --transport http <name> <url>

# Exemple réel : Se connecter à Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

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

​

Option 2 : Ajouter un serveur SSE distant

# Syntaxe de base
claude mcp add --transport sse <name> <url>

# Exemple réel : Se connecter à Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Exemple avec en-tête d'authentification
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

​

Option 3 : Ajouter un serveur stdio local

# Syntaxe de base
claude mcp add [options] <name> -- <command> [args...]

# Exemple réel : Ajouter un serveur Airtable
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

​

Gestion de vos serveurs

# Lister tous les serveurs configurés
claude mcp list

# Obtenir les détails d'un serveur spécifique
claude mcp get github

# Supprimer un serveur
claude mcp remove github

# (dans Claude Code) Vérifier l'état du serveur
/mcp

​

Mises à jour dynamiques des outils

# Cela crée command="cmd" que Windows peut exécuter
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

​

Serveurs MCP fournis par les plugins

• Les plugins définissent les serveurs MCP dans .mcp.json à la racine du plugin ou en ligne dans plugin.json
• Lorsqu’un plugin est activé, ses serveurs MCP démarrent automatiquement
• Les outils MCP des plugins apparaissent aux côtés des outils MCP configurés manuellement
• Les serveurs des plugins sont gérés via l’installation du plugin (pas via les commandes /mcp)

{
  "database-tools": {
    "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
    "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
    "env": {
      "DB_URL": "${DB_URL}"
    }
  }
}

{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}

• Cycle de vie automatique : Les serveurs démarrent lorsque le plugin s’active, mais vous devez redémarrer Claude Code pour appliquer les modifications du serveur MCP (activation ou désactivation)
• Variables d’environnement : Utilisez ${CLAUDE_PLUGIN_ROOT} pour les chemins relatifs au plugin
• Accès aux variables d’environnement utilisateur : Accès aux mêmes variables d’environnement que les serveurs configurés manuellement
• Types de transport multiples : Support des transports stdio, SSE et HTTP (le support des transports peut varier selon le serveur)

# Dans Claude Code, voir tous les serveurs MCP y compris ceux du plugin
/mcp

• Distribution groupée : Outils et serveurs emballés ensemble
• Configuration automatique : Aucune configuration MCP manuelle nécessaire
• Cohérence d’équipe : Tout le monde obtient les mêmes outils lorsque le plugin est installé

​

Portées d’installation MCP

​

Portée locale

# Ajouter un serveur à portée locale (par défaut)
claude mcp add --transport http stripe https://mcp.stripe.com

# Spécifier explicitement la portée locale
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

​

Portée du projet

# Ajouter un serveur à portée de projet
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

​

Portée utilisateur

# Ajouter un serveur utilisateur
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

​

Choisir la bonne portée

• Portée locale : Serveurs personnels, configurations expérimentales ou identifiants sensibles spécifiques à un projet
• Portée du projet : Serveurs partagés par l’équipe, outils spécifiques au projet ou services requis pour la collaboration
• Portée utilisateur : Utilitaires personnels nécessaires dans plusieurs projets, outils de développement ou services fréquemment utilisés

​

Hiérarchie de portée et précédence

​

Expansion des variables d’environnement dans .mcp.json

• ${VAR} - Se développe à la valeur de la variable d’environnement VAR
• ${VAR:-default} - Se développe à VAR si défini, sinon utilise default

• command - Le chemin de l’exécutable du serveur
• args - Arguments de la ligne de commande
• env - Variables d’environnement passées au serveur
• url - Pour les types de serveur HTTP
• headers - Pour l’authentification du serveur HTTP

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

​

Exemples pratiques

​

Exemple : Surveiller les erreurs avec Sentry

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

/mcp

Quelles sont les erreurs les plus courantes au cours des 24 dernières heures ?

Montrez-moi la trace de pile pour l'erreur ID abc123

Quel déploiement a introduit ces nouvelles erreurs ?

​

Exemple : Se connecter à GitHub pour les révisions de code

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

/mcp

Examinez la PR #456 et suggérez des améliorations

Créer un nouveau problème pour le bogue que nous venons de trouver

Montrez-moi toutes les PR ouvertes qui me sont assignées

​

Exemple : Interroger votre base de données PostgreSQL

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:[email protected]:5432/analytics"

Quel est notre revenu total ce mois-ci ?

Montrez-moi le schéma de la table des commandes

Trouver les clients qui n'ont pas effectué d'achat depuis 90 jours

​

S’authentifier auprès des serveurs MCP distants

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

/mcp

​

Utiliser un port de rappel OAuth fixe

# Port de rappel fixe avec enregistrement dynamique du client
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Utiliser les identifiants OAuth pré-configurés

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
  --client-secret

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Remplacer la découverte des métadonnées OAuth

{
  "mcpServers": {
    "my-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "authServerMetadataUrl": "https://auth.example.com/.well-known/openid-configuration"
      }
    }
  }
}

​

Ajouter des serveurs MCP à partir de la configuration JSON

# Syntaxe de base
claude mcp add-json <name> '<json>'

# Exemple : Ajouter un serveur HTTP avec configuration JSON
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# Exemple : Ajouter un serveur stdio avec configuration JSON
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# Exemple : Ajouter un serveur HTTP avec identifiants OAuth pré-configurés
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

claude mcp get weather-api

​

Importer les serveurs MCP à partir de Claude Desktop

# Syntaxe de base 
claude mcp add-from-claude-desktop 

claude mcp list 

​

Utiliser les serveurs MCP à partir de Claude.ai

/mcp

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

​

Utiliser Claude Code comme serveur MCP

# Démarrer Claude en tant que serveur MCP stdio
claude mcp serve

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

which claude

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

Limites de sortie MCP et avertissements

• Seuil d’avertissement de sortie : Claude Code affiche un avertissement lorsque la sortie de tout outil MCP dépasse 10 000 jetons
• Limite configurable : Vous pouvez ajuster le nombre maximum de jetons de sortie MCP autorisés en utilisant la variable d’environnement MAX_MCP_OUTPUT_TOKENS
• Limite par défaut : La limite maximale par défaut est de 25 000 jetons

# Définir une limite plus élevée pour les sorties des outils MCP
export MAX_MCP_OUTPUT_TOKENS=50000
claude

• Interrogent de grands ensembles de données ou des bases de données
• Génèrent des rapports ou des documentations détaillés
• Traitent des fichiers journaux ou des informations de débogage étendus

​

Utiliser les ressources MCP

​

Référencer les ressources MCP

Pouvez-vous analyser @github:issue://123 et suggérer un correctif ?

Veuillez examiner la documentation API à @docs:file://api/authentication

Comparez @postgres:schema://users avec @docs:file://database/user-model

​

Mettre à l’échelle avec la recherche d’outils MCP

​

Comment cela fonctionne

1. Les outils MCP sont différés plutôt que chargés dans le contexte à l’avance
2. Claude utilise un outil de recherche pour découvrir les outils MCP pertinents si nécessaire
3. Seuls les outils dont Claude a réellement besoin sont chargés dans le contexte
4. Les outils MCP continuent à fonctionner exactement comme avant de votre point de vue

​

Pour les auteurs de serveurs MCP

• Quelle catégorie de tâches vos outils gèrent
• Quand Claude doit rechercher vos outils
• Les capacités clés de votre serveur

​

Configurer la recherche d’outils

# Utiliser un seuil personnalisé de 5 %
ENABLE_TOOL_SEARCH=auto:5 claude

# Désactiver complètement la recherche d'outils
ENABLE_TOOL_SEARCH=false claude

{
  "permissions": {
    "deny": ["MCPSearch"]
  }
}

​

Utiliser les prompts MCP comme commandes

​

Exécuter les prompts MCP

/mcp__github__list_prs

/mcp__github__pr_review 456

/mcp__jira__create_issue "Bug in login flow" high

​

Configuration MCP gérée

1. Contrôle exclusif avec managed-mcp.json : Déployer un ensemble fixe de serveurs MCP que les utilisateurs ne peuvent pas modifier ou étendre
2. Contrôle basé sur les politiques avec listes blanches/noires : Permettre aux utilisateurs d’ajouter leurs propres serveurs, mais restreindre lesquels sont autorisés

• Contrôler les serveurs MCP auxquels les employés peuvent accéder : Déployer un ensemble standardisé de serveurs MCP approuvés dans toute l’organisation
• Empêcher les serveurs MCP non autorisés : Restreindre les utilisateurs d’ajouter des serveurs MCP non approuvés
• Désactiver complètement MCP : Supprimer complètement la fonctionnalité MCP si nécessaire

​

Option 1 : Contrôle exclusif avec managed-mcp.json

• macOS : /Library/Application Support/ClaudeCode/managed-mcp.json
• Linux et WSL : /etc/claude-code/managed-mcp.json
• Windows : C:\Program Files\ClaudeCode\managed-mcp.json

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "company-internal": {
      "type": "stdio",
      "command": "/usr/local/bin/company-mcp-server",
      "args": ["--config", "/etc/company/mcp-config.json"],
      "env": {
        "COMPANY_API_URL": "https://internal.company.com"
      }
    }
  }
}

​

Option 2 : Contrôle basé sur les politiques avec listes blanches et noires

​

Options de restriction

1. Par nom de serveur (serverName) : Correspond au nom configuré du serveur
2. Par commande (serverCommand) : Correspond à la commande exacte et aux arguments utilisés pour démarrer les serveurs stdio
3. Par modèle d’URL (serverUrl) : Correspond aux URL des serveurs distants avec support des caractères génériques

​

Exemple de configuration

{
  "allowedMcpServers": [
    // Autoriser par nom de serveur
    { "serverName": "github" },
    { "serverName": "sentry" },

    // Autoriser par commande exacte (pour les serveurs stdio)
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem"] },
    { "serverCommand": ["python", "/usr/local/bin/approved-server.py"] },

    // Autoriser par modèle d'URL (pour les serveurs distants)
    { "serverUrl": "https://mcp.company.com/*" },
    { "serverUrl": "https://*.internal.corp/*" }
  ],
  "deniedMcpServers": [
    // Bloquer par nom de serveur
    { "serverName": "dangerous-server" },

    // Bloquer par commande exacte (pour les serveurs stdio)
    { "serverCommand": ["npx", "-y", "unapproved-package"] },

    // Bloquer par modèle d'URL (pour les serveurs distants)
    { "serverUrl": "https://*.untrusted.com/*" }
  ]
}

​

Comment fonctionnent les restrictions basées sur les commandes

• Les tableaux de commandes doivent correspondre exactement - à la fois la commande et tous les arguments dans le bon ordre
• Exemple : ["npx", "-y", "server"] ne correspondra PAS à ["npx", "server"] ou ["npx", "-y", "server", "--flag"]

• Lorsque la liste blanche contient n’importe quelle entrée serverCommand, les serveurs stdio doivent correspondre à l’une de ces commandes
• Les serveurs stdio ne peuvent pas passer par le nom seul lorsque des restrictions de commande sont présentes
• Cela garantit que les administrateurs peuvent appliquer les commandes autorisées à s’exécuter

• Les serveurs distants (HTTP, SSE, WebSocket) utilisent la correspondance basée sur l’URL lorsque des entrées serverUrl existent dans la liste blanche
• Si aucune entrée d’URL n’existe, les serveurs distants reviennent à la correspondance basée sur le nom
• Les restrictions de commande ne s’appliquent pas aux serveurs distants

​

Comment fonctionnent les restrictions basées sur l’URL

• https://mcp.company.com/* - Autoriser tous les chemins sur un domaine spécifique
• https://*.example.com/* - Autoriser n’importe quel sous-domaine de example.com
• http://localhost:*/* - Autoriser n’importe quel port sur localhost

• Lorsque la liste blanche contient n’importe quelle entrée serverUrl, les serveurs distants doivent correspondre à l’un de ces modèles d’URL
• Les serveurs distants ne peuvent pas passer par le nom seul lorsque des restrictions d’URL sont présentes
• Cela garantit que les administrateurs peuvent appliquer les points de terminaison distants autorisés

{
  "allowedMcpServers": [
    { "serverUrl": "https://mcp.company.com/*" },
    { "serverUrl": "https://*.internal.corp/*" }
  ]
}

{
  "allowedMcpServers": [
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "internal-tool" }
  ]
}

​

Comportement de la liste blanche (allowedMcpServers)

• undefined (par défaut) : Aucune restriction - les utilisateurs peuvent configurer n’importe quel serveur MCP
• Tableau vide [] : Verrouillage complet - les utilisateurs ne peuvent configurer aucun serveur MCP
• Liste d’entrées : Les utilisateurs ne peuvent configurer que les serveurs qui correspondent par nom, commande ou modèle d’URL

​

Comportement de la liste noire (deniedMcpServers)

• undefined (par défaut) : Aucun serveur n’est bloqué
• Tableau vide [] : Aucun serveur n’est bloqué
• Liste d’entrées : Les serveurs spécifiés sont explicitement bloqués dans toutes les portées

​

Notes importantes

• L’option 1 et l’option 2 peuvent être combinées : Si managed-mcp.json existe, il a le contrôle exclusif et les utilisateurs ne peuvent pas ajouter de serveurs. Les listes blanches/noires s’appliquent toujours aux serveurs gérés eux-mêmes.
• La liste noire a une précédence absolue : Si un serveur correspond à une entrée de liste noire (par nom, commande ou URL), il sera bloqué même s’il est sur la liste blanche
• Les restrictions basées sur le nom, la commande et l’URL fonctionnent ensemble : un serveur passe s’il correspond à soit une entrée de nom, une entrée de commande, ou un modèle d’URL (sauf s’il est bloqué par la liste noire)