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é. »
• Réagir aux événements externes : Un serveur MCP peut également agir comme un canal qui pousse des messages dans votre session, afin que Claude réagisse aux messages Telegram, aux discussions Discord ou aux événements webhook pendant que vous êtes absent.

​

Trouver et créer des serveurs MCP

/plugin install mcp-server-dev@claude-plugins-official

/mcp-server-dev:build-mcp-server

​

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 --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

​

Option 4 : Ajouter un serveur WebSocket distant

claude mcp add-json events-server \
  '{"type":"ws","url":"wss://mcp.example.com/socket","headers":{"Authorization":"Bearer YOUR_TOKEN"}}'

​

Ajouter un serveur à partir d’instructions de configuration écrites pour un autre client

• Une URL telle que https://mcp.example.com/mcp : le serveur est distant.
• Une commande de lancement telle que npx -y @example/mcp-server : le serveur s’exécute sur votre machine.
• Un bloc JSON mcpServers : configuration écrite pour le fichier de paramètres d’un autre client.

​

À partir d’une URL

claude mcp add --transport http example https://mcp.example.com/mcp

​

À partir d’une commande npx, uvx, ou binaire

claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server

​

À partir d’un bloc JSON mcpServers

• Une url sans type : ajoutez "type": "http", "type": "sse", ou "type": "ws" pour correspondre au point de terminaison. Claude Code lit une entrée sans type comme un serveur stdio, donc une entrée url sans type échoue.
• Une clé avec des caractères autres que des lettres, des chiffres, des tirets, et des traits de soulignement : choisissez un nom de serveur qui utilise uniquement ces caractères. Sinon, la clé est le nom du serveur.

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"]
    }
  }
}

claude mcp add-json example '{"command":"npx","args":["-y","@example/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 notion

# Supprimer un serveur
claude mcp remove notion

# (dans Claude Code) Vérifier le statut du serveur
/mcp

​

Statut du serveur

• ⏸ Pending approval (run `claude` to approve) : un serveur scoped au projet depuis .mcp.json que vous n’avez pas encore approuvé. Claude Code l’affiche à la fois dans claude mcp list et claude mcp get <name>. Exécutez claude de manière interactive pour l’examiner et l’approuver.
• ✘ Rejected (see disabledMcpjsonServers in settings) : un serveur .mcp.json qu’une entrée disabledMcpjsonServers rejette. Claude Code l’affiche uniquement dans claude mcp get <name>.
• ⊘ Disabled for this project (re-enable via /mcp) : un serveur que la liste disabledMcpServers du projet nomme. Claude Code l’affiche à la fois dans claude mcp list et claude mcp get <name>. Réactivez le serveur depuis le panneau /mcp. Avant la v2.1.238, les deux commandes se connectaient à un serveur désactivé pour le vérifier et rapportaient le résultat de la connexion.

​

Approbations des serveurs de projet et confiance de l’espace de travail

• votre ~/.claude/settings.json utilisateur
• paramètres gérés
• paramètres passés avec --settings

​

Détail du statut du serveur

• Reconnect : sur un serveur cached, Claude Code le connecte maintenant plutôt que lors de son premier appel d’outil et conserve l’entrée. Sur un serveur connecté ou échoué, Claude Code le reconnecte et supprime également l’entrée.
• Clear authentication : Claude Code révoque l’authentification du serveur et supprime également l’entrée.

• Le chemin et la requête n’apparaissent jamais dans ce message.
• Pour un serveur dans la portée locale, de projet, ou utilisateur scope ou dans la configuration MCP gérée, l’origine affiche l’hôte tel qu’écrit dans cette configuration, donc une référence ${VAR} dans l’hôte n’est pas développée dans le message.
• Pour un échec sans code de statut ou d’erreur, Claude Code affiche le texte d’erreur sans l’origine.

​

Avertissements de configuration

• Espaces blancs cachés : Claude Code avertit lorsqu’une valeur de configuration MCP porte des espaces blancs cachés en début ou en fin, ce qui provient souvent du collage d’un jeton avec une nouvelle ligne de fin. Claude Code vérifie command, url, chaque entrée args, et les valeurs et noms de clés sous env et headers. Claude Code affiche l’avertissement dans la sortie claude mcp list et dans /mcp, nommant les champs affectés sans répéter leurs valeurs, par exemple Leading or trailing whitespace in: headers.Authorization. Claude Code ne supprime pas les espaces blancs et utilise les valeurs exactement comme écrites, donc modifiez la configuration pour les supprimer.
• Même nom dans plus d’une portée : si vous définissez le même nom de serveur dans plus d’une portée avec des points de terminaison différents, Claude Code avertit du conflit dans la sortie claude mcp list et dans /mcp. Claude Code stocke les connexions OAuth par point de terminaison, donc lorsque vous authentifiez la définition qui se charge dans un projet, vous devez toujours vous connecter séparément dans un projet où une définition différente se charge. Conservez le point de terminaison que vous voulez et supprimez les autres avec claude mcp remove <name> --scope <scope>. Dans l’avertissement, Claude Code cite le point de terminaison de chaque portée tel qu’écrit dans votre configuration, avec les références ${VAR} non développées, donc il n’affiche jamais une valeur résolue telle qu’une clé API.
• Noms réservés : Claude Code réserve les noms de ses serveurs intégrés, y compris workspace, claude-in-chrome, computer-use, Claude Preview, et Claude Browser. Si votre configuration définit un serveur avec un nom réservé, Claude Code le saute au moment du chargement et affiche un avertissement vous demandant de le renommer. claude mcp add rejette un nom réservé avec une erreur. Claude Preview et Claude Browser nomment tous deux le serveur intégré que le volet d’aperçu de l’application de bureau Claude Code utilise. Avant la v2.1.205, Claude Browser n’était pas réservé, donc un serveur configuré par l’utilisateur pouvait s’enregistrer sous ce nom.
• Variable d’environnement manquante : si une référence ${VAR} dans la configuration d’un serveur nomme une variable qui n’est pas définie et n’a pas de :-default, Claude Code avertit dans la sortie claude mcp list et dans /mcp, nommant la variable, et charge toujours le serveur avec le texte ${VAR} non développé. Définissez la variable ou ajoutez un fallback ${VAR:-default}. Dans l’url et les headers d’un serveur distant, certaines variables d’identifiants lisent comme vides à la place, sans avertissement.

​

Disponibilité des outils

• Avec recherche d’outils, la valeur par défaut : l’attente se produit à l’intérieur de l’appel ToolSearch.
• Sans recherche d’outils : Claude utilise l’outil WaitForMcpServers à la place. Les configurations sans recherche d’outils incluent une ANTHROPIC_BASE_URL personnalisée, ENABLE_TOOL_SEARCH=false, et un modèle antérieur à la génération Claude 4.5 sur la plateforme Agent de Google Cloud.
• Sur un déploiement Microsoft Foundry hébergé sur Azure : Claude commence sur le chemin de recherche d’outils plutôt qu’avec WaitForMcpServers, car Claude Code découvre le rejet côté serveur du déploiement uniquement à partir de l’API. Après que Claude Code bascule ce déploiement vers chargement en amont, les outils d’un serveur qui termine la connexion deviennent disponibles à la prochaine demande de Claude.

​

Désactiver un serveur sans le supprimer

• disabledMcpServers : une liste d’exclusion pour les serveurs configurés par l’utilisateur, les serveurs de plugins, les serveurs que votre organisation fournit via les paramètres gérés, les connecteurs claude.ai que Claude Code récupère lui-même, et les serveurs intégrés qui sont activés par défaut. Claude Code ne se connecte pas à un serveur que vous listez ici. Lorsque vous désactivez un connecteur claude.ai avec le basculement /mcp par projet décrit dans Désactiver les connecteurs claude.ai, Claude Code l’écrit dans cette liste sous son nom d’affichage, par exemple claude.ai Slack.
• enabledMcpServers : une liste d’inclusion pour les serveurs intégrés qui sont désactivés par défaut, tels que computer-use. Claude Code se connecte à un serveur désactivé par défaut uniquement lorsque vous le listez ici.

​

Runtimes clients MCP

• Sessions sur Amazon Bedrock, Claude Platform sur AWS, la plateforme Agent de Google Cloud, ou Microsoft Foundry, sauf si une plateforme hôte qui intègre Claude Code définit CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• Sessions connectées via une passerelle d’applications Claude
• Sessions où vous désactivez la télémétrie ou la récupération des drapeaux de fonctionnalité, par exemple avec DISABLE_TELEMETRY

• Demande aux serveurs HTTP s’ils supportent la révision plus récente, et l’utilise avec ceux qui le font. Il demande également aux serveurs connecteurs claude.ai dans les sessions où il récupère les drapeaux de fonctionnalité. Pour qu’il demande aux serveurs stdio, ou aux serveurs connecteurs dans chaque session, définissez MCP_PROTOCOL_NEGOTIATION sur auto. Il se connecte à tous les autres serveurs comme v1 le fait.
• Reçoit les notifications list_changed des serveurs sur la révision plus récente sur un flux qu’il maintient ouvert.
• N’enregistre pas un serveur de canal qui se connecte sur la révision plus récente, car cette révision ne peut pas transporter les messages de canal.
• Échoue une connexion OAuth MCP dont la réponse d’autorisation nomme un émetteur inattendu.

​

Mises à jour dynamiques des outils

​

Flux de notification sur le runtime v2

• Le flux se ferme à nouveau dans les 10 secondes : Claude Code le rouvre jusqu’à trois fois, puis s’arrête pour cette connexion.
• Le flux reste ouvert plus de 10 secondes, puis se ferme, comme les flux vers les hôtes sans serveur le font couramment : après cinq réouvertures en une heure, Claude Code attend environ six heures avant la suivante.

​

Reconnexion automatique

​

Déconnexions en cours de session d’un serveur distant

• Dans une session interactive : /mcp affiche le serveur comme en attente pendant que Claude Code se reconnecte. Après cinq tentatives échouées, Claude Code marque le serveur comme échoué, ou comme ayant besoin d’authentification lorsque le serveur a besoin d’être autorisé à nouveau. Vous pouvez réessayer manuellement depuis /mcp.
• Dans les exécutions claude -p et les sessions Agent SDK : Claude Code se reconnecte selon le même calendrier, sans panneau /mcp pour afficher les tentatives.

​

Échecs de première connexion

• La première connexion d’un serveur WebSocket
• Une erreur d’authentification ou non trouvée, car elle nécessite un changement de configuration pour être résolue. Lorsqu’un headersHelper est la seule source du serveur de l’en-tête Authorization, Claude Code réessaie quand même une erreur d’authentification, car il réexécute l’assistant à chaque tentative et peut récupérer une nouvelle identifiant

​

Demandes de découverte échouées

​

Comment Claude apprend qu’un serveur a échoué

• Avec la recherche d’outils, Claude Code dit à Claude quel serveur a échoué et son erreur de connexion, donc Claude rapporte l’échec de la connexion dans sa réponse. Claude Code inclut les mêmes informations dans les résultats ToolSearch qui ne trouvent aucun outil correspondant.
• Dans toute configuration sans recherche d’outils, Claude Code ne rapporte pas les échecs de connexion du serveur à Claude.

​

Pousser des messages avec des canaux

​

Arrière-plan automatique des appels d’outil longs

• Les appels des sous-agents ; Claude Code met en arrière-plan uniquement les appels de conversation principale
• Les appels aux serveurs IDE
• Les appels en mode non interactif, sauf si CLAUDE_AUTO_BACKGROUND_TASKS est défini sur 1, car une exécution unique peut se terminer avant l’arrivée du résultat

​

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
• Lorsque vous activez un plugin, Claude Code démarre automatiquement ses serveurs MCP
• Claude Code offre les outils MCP du plugin aux côtés des outils MCP configurés manuellement
• Vous ajoutez et supprimez les serveurs de plugins en installant ou en désinstallant le plugin, pas avec les commandes /mcp. Vous pouvez toujours basculer un serveur de plugin installé dans /mcp, ce qui arrête Claude Code de s’y connecter sans supprimer le plugin

{
  "mcpServers": {
    "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 se connectent et se déconnectent à ces points :
  • Au démarrage de la session, Claude Code connecte automatiquement les serveurs des plugins activés. Dans /mcp, un serveur de plugin distant (HTTP ou SSE) que vous avez utilisé auparavant peut afficher le statut cached à la place ; Claude Code le connecte lorsque Claude appelle pour la première fois l’un de ses outils
  • Si vous activez ou désactivez un plugin pendant une session, Claude Code connecte ou déconnecte ses serveurs MCP lorsque la modification s’applique. Appliquer les modifications de plugin sans redémarrer décrit quand c’est le cas. Dans une session sans terminal interactif, /reload-plugins ne connecte ou ne déconnecte pas les serveurs MCP du plugin ; ces modifications prennent effet dans votre prochaine session
  • Lorsque vous rechargez, Claude Code conserve les connexions en direct des serveurs de plugins dont la configuration est inchangée, et fait de même lorsque vous remplacez la liste des serveurs MCP de la session à partir du Agent SDK sans les nommer
  • Lorsque vous déplacez la session avec /cd sur v2.1.246 ou ultérieur, Claude Code connecte les serveurs des plugins que les paramètres du nouveau répertoire activent et déconnecte les serveurs des plugins qui ne sont plus activés, donc vous n’avez pas besoin d’exécuter /reload-plugins après le déplacement
  • Dans les sessions web, un appel MCP à un serveur de plugin qui n’est pas encore connecté, comme juste après qu’une session inactive se réveille, démarre le serveur à la demande et attend qu’il se connecte
• Espaces réservés de chemin : ${CLAUDE_PLUGIN_ROOT} se résout au répertoire d’installation du plugin, ${CLAUDE_PLUGIN_DATA} à son répertoire d’état persistant, et ${CLAUDE_PROJECT_DIR} à la racine du projet stable. La substitution s’applique à :
  • serveurs stdio : command, args, env
  • serveurs http, sse, et ws : url, headers, et headersHelper. Avant la v2.1.195, headersHelper transmettait l’espace réservé comme une chaîne littérale
• Accès à l’environnement utilisateur : accès aux mêmes variables d’environnement que les serveurs configurés manuellement
• Types de transport multiples : support pour les transports stdio, SSE, HTTP, et WebSocket, bien que le support du transport puisse varier selon le serveur

mcp__plugin_my-plugin_database-tools__query

​

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

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com"
        }
      }
    }
  }
}

​

Portée du projet

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

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

• Ajoutez-le à disabledMcpjsonServers, qui le bloque dans tous les modes de permission.
• Excluez entièrement les paramètres du projet avec --setting-sources ou l’option settingSources du SDK.
• Démarrez la session avec --strict-mcp-config. Claude Code utilise alors uniquement les serveurs MCP que vous transmettez avec --mcp-config. Ignorer l’invite d’approbation pour les serveurs à portée de projet que Claude Code ne charge pas nécessite Claude Code v2.1.246 ou ultérieur ; avant v2.1.246, une session stricte attendait toujours l’approbation pour eux, ce qui laissait les sessions en arrière-plan en attente au démarrage. Consultez Contrôle exclusif avec managed-mcp.json pour voir ce que le drapeau fait sous un fichier MCP géré.

​

Portée utilisateur

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

​

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

1. Portée locale
2. Portée du projet
3. Portée utilisateur
4. Serveurs fournis par les plugins
5. Connecteurs claude.ai

​

Expansion des variables d’environnement dans .mcp.json

​

Syntaxe supportée

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

​

Emplacements d’expansion

• 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

​

Exemple avec expansion de variable

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

​

Variables non définies sans valeur par défaut

​

Variables d’identification qui se lisent comme vides

• Les identifiants propres de Claude Code, tels que ANTHROPIC_API_KEY et ANTHROPIC_AUTH_TOKEN
• Les identifiants de votre fournisseur cloud, tels que AWS_BEARER_TOKEN_BEDROCK
• Autres identifiants que votre environnement porte, tels que HTTPS_PROXY et NPM_TOKEN

​

Comment les références apparaissent dans /mcp et la sortie CLI

• L’URL ou la ligne de commande dans la vue de détail /mcp d’un serveur
• Sortie claude mcp list et claude mcp get

​

Exemples pratiques

​

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

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

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:pass@prod.db.com: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

• Pour un serveur auprès duquel vous ne vous êtes pas connecté, l’un ou l’autre code de statut le signale dans /mcp afin que vous puissiez compléter le flux OAuth.
• Pour un connecteur claude.ai, un 401 causé par le rejet de votre jeton de session par claude.ai ne signale pas le connecteur, car la réautorisation du connecteur ne peut pas corriger votre connexion. Claude Code affiche plutôt l’état de rejet du jeton de session.
• Pour un serveur dont vous avez configuré l’en-tête Authorization, dans headers ou via un headersHelper, un 401 ou 403 lors de la connexion ne signale pas le serveur, car l’identifiant à corriger est celui que vous avez configuré. Claude Code signale plutôt la connexion comme échouée. Si vous avez défini cet en-tête à partir d’une référence ${VAR}, vérifiez si cette variable est l’une que Claude Code lit comme vide.
• Pour un connecteur livré à une session cloud, Claude Code n’exécute pas de flux de connexion, car le proxy de la session s’authentifie auprès du connecteur avec l’autorisation que vous avez accordée dans claude.ai. Lorsqu’un connecteur là-bas a besoin d’être autorisé à nouveau, reconnectez-le à claude.ai/customize/connectors plutôt que depuis la session.

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

/mcp

​

S’authentifier à partir de la ligne de commande

claude mcp login sentry

claude mcp login sentry --no-browser

​

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"
      }
    }
  }
}

​

Restreindre les portées OAuth

{
  "mcpServers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "scopes": "channels:read chat:write search:read"
      }
    }
  }
}

​

Utiliser des en-têtes dynamiques pour l’authentification personnalisée

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "echo '{\"Authorization\": \"Bearer '\"$(get-token)\"'\"}'"
    }
  }
}

• La commande doit écrire un objet JSON de paires clé-valeur de chaîne sur stdout
• Claude Code exécute la commande dans un shell et abandonne après 10 secondes
• Claude Code choisit le répertoire de travail de la commande en fonction de l’endroit où vous avez configuré le serveur, donc fournissez le script comme chemin absolu ou mettez-le sur PATH
• Les en-têtes dynamiques remplacent tous les headers statiques portant le même nom

​

Où l’assistant s’exécute

​

Quelles variables un assistant peut lire

• Supprimées : un serveur dans un .mcp.json de projet ou dans un plugin, et un serveur en ligne dans un fichier agent de votre projet ou d’un répertoire --add-dir
• Non supprimées : un serveur à portée utilisateur ou portée locale, dans MCP géré, à partir d’un connecteur claude.ai, ou fourni par le SDK ou --mcp-config, et un serveur en ligne dans un fichier agent de ~/.claude/agents/, à partir des paramètres gérés, ou passé avec --agents

​

Faire confiance à un dossier avant que son headersHelper s’exécute

• Confiance qui ne compte pas : la confiance d’un dossier parent, et la confiance automatique qu’une session claude -p ou SDK obtient pour les hooks dans les fichiers de paramètres
• Jusqu’à ce que vous fassiez confiance au dossier : Claude Code connecte le serveur avec ses headers statiques seuls. Dans une session claude -p ou SDK, il imprime également une ligne headersHelper not run par serveur sur stderr, vous indiquant comment accorder la confiance.
• Confiance sans boîte de dialogue : définissez projects["<path>"].hasTrustDialogAccepted à true dans ~/.claude.json. <path> est le dossier sur lequel Règles d’autorisation de projet et confiance de l’espace de travail dit que Claude Code base la confiance.

​

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 depuis claude.ai

/mcp

• ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, ou apiKeyHelper est actif
• Un fournisseur tiers tel qu’Amazon Bedrock ou Agent Platform de Google Cloud est actif
• ANTHROPIC_PROFILE, les variables de fédération, ou un profil Anthropic actif fournit les identifiants
• CLAUDE_CODE_OAUTH_TOKEN contient un jeton de claude setup-token, qui ne peut faire que des demandes de modèle

1. Exécutez /login pour vous reconnecter.
2. Reconnectez le connecteur depuis /mcp.

​

Comment les connecteurs atteignent Claude Code

• Sessions cloud : les entrées allowedMcpServers et deniedMcpServers qui atteignent la session, par exemple via les paramètres gérés par le serveur, filtrent également les connecteurs livrés. Le proxy de la session réécrit l’URL de chaque connecteur, donc un motif serverUrl écrit pour l’URL propre du connecteur ne le correspond pas. Pour admettre les connecteurs livrés aux côtés d’une liste blanche d’URL dans un environnement auto-hébergé, ajoutez les entrées serverUrl listées sous Le trafic des connecteurs quitte votre réseau. Claude Code supprime les connecteurs livrés quand un managed-mcp.json est présent sur l’hôte qui exécute la session, comme un hôte de runner auto-hébergé, que vous ayez défini allowAllClaudeAiMcps ou non.
• Sessions locales et SSH de l’application de bureau : l’application de bureau enregistre les connecteurs en tant que serveurs type: "sdk" en processus, et aucun paramètre MCP ou managed-mcp.json ne les atteint. Un utilisateur garde un connecteur hors de ses propres sessions en le déconnectant à claude.ai/customize/connectors. Une organisation bloque les outils d’un connecteur ou désactive entièrement Claude Code dans l’application de bureau.

​

Contrôles d’organisation sur les outils de connecteur

• Outil défini sur ask : Claude Code demande à chaque appel avec la raison Your organization requires approval for this tool. L’invite apparaît même dans les modes de permission acceptEdits, auto, et bypassPermissions modes de permission, et n’offre jamais une option pour mémoriser votre choix. Les règles Allow qui correspondent à l’outil ne sautent pas non plus l’invite. En mode dontAsk, qui ne demande jamais, Claude Code refuse l’appel à la place.
• Outil défini sur blocked : Claude Code filtre l’outil avant que Claude ne le voie, donc il n’apparaît jamais dans la liste des outils. L’application de bureau et le chat claude.ai appliquent le même paramètre blocked, donc Claude ne peut pas utiliser l’outil là non plus, et vous ne pouvez pas retenir un outil des sessions de l’application de bureau tout en le gardant disponible dans le chat. L’application de bureau saute un connecteur dont tous les outils sont bloqués.

​

Désactiver les connecteurs claude.ai

{
  "disableClaudeAiConnectors": true
}

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 tokens
• Limite configurable : vous pouvez ajuster le nombre maximum de tokens de sortie MCP autorisés à l’aide de la variable d’environnement MAX_MCP_OUTPUT_TOKENS
• Limite par défaut : le maximum par défaut est de 25 000 tokens
• Portée : la variable d’environnement s’applique aux outils qui ne déclarent pas leur propre limite. Les outils qui définissent anthropic/maxResultSizeChars utilisent cette valeur à la place pour le contenu textuel, indépendamment de la valeur définie pour MAX_MCP_OUTPUT_TOKENS. Les outils qui retournent des données d’image restent soumis à MAX_MCP_OUTPUT_TOKENS
• Au-delà de la limite : lorsqu’un résultat sans contenu d’image dépasse la limite, Claude Code l’enregistre dans un fichier et le remplace dans la conversation par un message qui indique le chemin du fichier, de sorte que Claude lit le fichier lorsqu’il a besoin du contenu. Le fichier se trouve dans le répertoire tool-results de la session sous ~/.claude/projects/.

export MAX_MCP_OUTPUT_TOKENS=50000
claude

​

Augmenter la limite pour un outil spécifique

{
  "name": "get_schema",
  "description": "Returns the full database schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 200000
  }
}

​

Schémas d’entrée d’outil avec un combinateur au niveau racine

• allOf : les propriétés de chaque branche sont fusionnées, et la liste required de chaque branche s’applique toujours
• anyOf et oneOf : les propriétés de chaque branche sont fusionnées, et la liste required de chaque branche est décrite dans la description de l’outil au lieu d’être appliquée par le schéma

​

Outils avec des schémas d’entrée invalides

• Les noms de propriétés au niveau supérieur doivent faire entre 1 et 64 caractères et utiliser uniquement des lettres ASCII et des chiffres, _, . et -
• Le schéma doit être valide par rapport au méta-schéma JSON Schema draft 2020-12. Claude Code applique cette vérification aux schémas qui ne déclarent pas de $schema et aux schémas qui déclarent draft 2020-12. Un schéma qui déclare un autre dialecte ignore cette vérification, bien que la vérification du nom de propriété ci-dessus s’applique toujours

​

Exiger une approbation pour un outil spécifique

{
  "name": "grant_access",
  "description": "Requests access to a protected resource",
  "_meta": {
    "anthropic/requiresUserInteraction": true
  }
}

​

Répondre aux demandes d’élicitation MCP

• Mode formulaire : Claude Code affiche un dialogue avec des champs de formulaire définis par le serveur (par exemple, une invite de nom d’utilisateur et de mot de passe). Remplissez les champs et soumettez.
• Mode URL : Claude Code ouvre une URL de navigateur pour l’authentification ou l’approbation. Complétez le flux dans le navigateur, puis confirmez dans l’interface de ligne de commande.

​

Utiliser les ressources MCP

​

Référencer les ressources MCP

Can you analyze @github:issue://123 and suggest a fix?

Please review the API documentation at @docs:file://api/authentication

Compare @postgres:schema://users with @docs:file://database/user-model

​

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

​

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 que votre serveur fournit

​

Configurer la recherche d’outils

• Claude Opus 4.5, Sonnet 4.5, Haiku 4.5, et ultérieur : la recherche d’outils est activée par défaut, comme sur l’API Anthropic.
• Modèles Agent Platform antérieurs : Claude Code charge tous les outils MCP en amont, car leurs piles de service rejettent l’en-tête bêta requis. ENABLE_TOOL_SEARCH=true ne contourne pas cela.

# 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": ["ToolSearch"]
  }
}

​

Exempter un serveur du report

{
  "mcpServers": {
    "core-tools": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "alwaysLoad": true
    }
  }
}

​

Utiliser les invites MCP comme commandes

​

Exécuter les invites MCP

/mcp__github__list_prs

/mcp__github__pr_review 456

/mcp__jira__create_issue login-bug high

​

Configuration MCP gérée