SpyBara
Go Premium

mcp.md 2026-05-05 23:00 UTC to 2026-05-07 22:59 UTC

11 added, 1 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

Connecter Claude Code aux outils via MCP

Découvrez comment connecter Claude Code à vos outils avec le Model Context Protocol.

export const MCPServersTable = ({platform = "all"}) => { const ifYouAreAnAiAgentReadingThisYouShouldInsteadFetch = 'https://api.anthropic.com/mcp-registry/docs'; const [servers, setServers] = useState([]); const [loading, setLoading] = useState(true); const [error, setError] = useState(null); useEffect(() => { const fetchServers = async () => { try { setLoading(true); const allServers = []; let cursor = null; do { const url = new URL('https://api.anthropic.com/mcp-registry/v0/servers'); url.searchParams.set('version', 'latest'); url.searchParams.set('visibility', 'commercial'); url.searchParams.set('limit', '100'); if (cursor) { url.searchParams.set('cursor', cursor); } const response = await fetch(url); if (!response.ok) { throw new Error(Failed to fetch MCP registry: ${response.status}); } const data = await response.json(); allServers.push(...data.servers); cursor = data.metadata?.nextCursor || null; } while (cursor); const transformedServers = allServers.map(item => { const server = item.server; const meta = item._meta?.['com.anthropic.api/mcp-registry'] || ({}); const worksWith = meta.worksWith || []; const availability = { claudeCode: worksWith.includes('claude-code'), mcpConnector: worksWith.includes('claude-api'), claudeDesktop: worksWith.includes('claude-desktop') }; const remotes = server.remotes || []; const httpRemote = remotes.find(r => r.type === 'streamable-http'); const sseRemote = remotes.find(r => r.type === 'sse'); const preferredRemote = httpRemote || sseRemote; const remoteUrl = preferredRemote?.url || meta.url; const remoteType = preferredRemote?.type; const isTemplatedUrl = remoteUrl?.includes('{'); let setupUrl; if (isTemplatedUrl && meta.requiredFields) { const urlField = meta.requiredFields.find(f => f.field === 'url'); setupUrl = urlField?.sourceUrl || meta.documentation; } const urls = {}; if (!isTemplatedUrl) { if (remoteType === 'streamable-http') { urls.http = remoteUrl; } else if (remoteType === 'sse') { urls.sse = remoteUrl; } } let envVars = []; if (server.packages && server.packages.length > 0) { const npmPackage = server.packages.find(p => p.registryType === 'npm'); if (npmPackage) { urls.stdio = npx -y ${npmPackage.identifier}; if (npmPackage.environmentVariables) { envVars = npmPackage.environmentVariables; } } } return { name: meta.displayName || server.title || server.name, description: meta.oneLiner || server.description, documentation: meta.documentation, urls: urls, envVars: envVars, availability: availability, customCommands: meta.claudeCodeCopyText ? { claudeCode: meta.claudeCodeCopyText } : undefined, setupUrl: setupUrl }; }); setServers(transformedServers); setError(null); } catch (err) { setError(err.message); console.error('Error fetching MCP registry:', err); } finally { setLoading(false); } }; fetchServers(); }, []); const generateClaudeCodeCommand = server => { if (server.customCommands && server.customCommands.claudeCode) { return server.customCommands.claudeCode.replace('--transport streamable-http', '--transport http'); } const serverSlug = server.name.toLowerCase().replace(/[^a-z0-9]/g, '-'); if (server.urls.http) { return claude mcp add ${serverSlug} --transport http ${server.urls.http}; } if (server.urls.sse) { return claude mcp add ${serverSlug} --transport sse ${server.urls.sse}; } if (server.urls.stdio) { const envFlags = server.envVars && server.envVars.length > 0 ? server.envVars.map(v => --env ${v.name}=YOUR_${v.name}).join(' ') : ''; const baseCommand = claude mcp add ${serverSlug} --transport stdio; return envFlags ? ${baseCommand} ${envFlags} -- ${server.urls.stdio} : ${baseCommand} -- ${server.urls.stdio}; } return null; }; if (loading) { return

Loading MCP servers...
; } if (error) { return
Error loading MCP servers: {error}
; } const filteredServers = servers.filter(server => { if (platform === "claudeCode") { return server.availability.claudeCode; } else if (platform === "mcpConnector") { return server.availability.mcpConnector; } else if (platform === "claudeDesktop") { return server.availability.claudeDesktop; } else if (platform === "all") { return true; } else { throw new Error(Unknown platform: ${platform}); } }); return <> 

  <div className="cards-container">
    {filteredServers.map(server => {
const claudeCodeCommand = generateClaudeCodeCommand(server);
const mcpUrl = server.urls.http || server.urls.sse;
const commandToShow = platform === "claudeCode" ? claudeCodeCommand : mcpUrl;
return <div key={server.name} className="server-card">
          <div>
            {server.documentation ? <a href={server.documentation}>
                <strong>{server.name}</strong>
              </a> : <strong>{server.name}</strong>}
          </div>

          <p style={{
  margin: '0.5rem 0',
  fontSize: '0.9rem'
}}>
            {server.description}
          </p>

          {server.setupUrl && <p style={{
  margin: '0.25rem 0',
  fontSize: '0.8rem',
  fontStyle: 'italic',
  opacity: 0.7
}}>
              Requires user-specific URL.{' '}
              <a href={server.setupUrl} style={{
  textDecoration: 'underline'
}}>
                Get your URL here
              </a>.
            </p>}

          {commandToShow && !server.setupUrl && <>
            <p style={{
  display: 'block',
  fontSize: '0.75rem',
  fontWeight: 500,
  minWidth: 'fit-content',
  marginTop: '0.5rem',
  marginBottom: 0
}}>
              {platform === "claudeCode" ? "Command" : "URL"}
            </p>
            <div className="command-row">
              <code>
                {commandToShow}
              </code>
            </div>
          </>}
        </div>;

})}

</>; };

Claude Code peut se connecter à des centaines d'outils externes et de sources de données via le Model Context Protocol (MCP), une norme open source pour les intégrations IA-outils. Les serveurs MCP donnent à Claude Code accès à vos outils, bases de données et API.

Connectez un serveur lorsque vous vous trouvez à copier des données dans le chat à partir d'un autre outil, comme un suivi de problèmes ou un tableau de bord de surveillance. Une fois connecté, Claude peut lire et agir sur ce système directement au lieu de travailler à partir de ce que vous collez.

Ce que vous pouvez faire avec MCP

Avec les serveurs MCP connectés, vous pouvez demander à Claude Code de :

  • 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.

Serveurs MCP populaires

Voici quelques serveurs MCP couramment utilisés que vous pouvez connecter à Claude Code :

Installation des serveurs MCP

Les serveurs MCP peuvent être configurés de trois façons différentes selon vos besoins :

Option 1 : Ajouter un serveur HTTP distant

Les serveurs HTTP sont l'option recommandée pour se connecter aux serveurs MCP distants. C'est le transport le plus largement supporté pour les services basés sur le cloud.

# 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

Les serveurs Stdio s'exécutent en tant que processus locaux sur votre machine. Ils sont idéaux pour les outils qui ont besoin d'un accès direct au système ou de scripts personnalisés.

# 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

Une fois configurés, vous pouvez gérer vos serveurs MCP avec ces commandes :

# 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

Le panneau /mcp affiche le nombre d'outils à côté de chaque serveur connecté et signale les serveurs qui annoncent la capacité des outils mais n'exposent aucun outil.

Le nom du serveur workspace est réservé à un usage interne. Si votre configuration définit un serveur avec ce nom, Claude Code le saute au chargement et affiche un avertissement vous demandant de le renommer.

Mises à jour dynamiques des outils

Claude Code supporte les notifications MCP list_changed, permettant aux serveurs MCP de mettre à jour dynamiquement leurs outils, prompts et ressources disponibles sans vous obliger à vous déconnecter et reconnecter. Lorsqu'un serveur MCP envoie une notification list_changed, Claude Code actualise automatiquement les capacités disponibles de ce serveur.

Reconnexion automatique

Si un serveur HTTP ou SSE se déconnecte en cours de session, Claude Code se reconnecte automatiquement avec un backoff exponentiel : jusqu'à cinq tentatives, en commençant par un délai d'une seconde et en doublant à chaque fois. Le serveur apparaît comme en attente dans /mcp pendant que la reconnexion est en cours. Après cinq tentatives échouées, le serveur est marqué comme échoué et vous pouvez réessayer manuellement à partir de /mcp. Les serveurs Stdio sont des processus locaux et ne sont pas reconnectés automatiquement.

Le même backoff s'applique lorsqu'un serveur HTTP ou SSE échoue sa connexion initiale au démarrage. À partir de la v2.1.121, Claude Code réessaie la connexion initiale jusqu'à trois fois sur les erreurs transitoires telles qu'une réponse 5xx, une connexion refusée ou un délai d'expiration, puis marque le serveur comme échoué s'il ne peut toujours pas se connecter. Les erreurs d'authentification et les erreurs de non-trouvé ne sont pas réessayées car elles nécessitent une modification de la configuration pour être résolues.

Pousser des messages avec des canaux

Un serveur MCP peut également pousser des messages directement dans votre session afin que Claude puisse réagir aux événements externes comme les résultats CI, les alertes de surveillance ou les messages de chat. Pour activer cela, votre serveur déclare la capacité claude/channel et vous l'activez avec le drapeau --channels au démarrage. Consultez Canaux pour utiliser un canal officiellement supporté, ou Référence des canaux pour créer le vôtre.

Serveurs MCP fournis par les plugins

Les plugins peuvent regrouper des serveurs MCP, fournissant automatiquement des outils et des intégrations lorsque le plugin est activé. Les serveurs MCP des plugins fonctionnent de manière identique aux serveurs configurés par l'utilisateur.

Comment fonctionnent les serveurs MCP des 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)

Exemple de configuration MCP du plugin :

Dans .mcp.json à la racine du plugin :

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

Ou en ligne dans plugin.json :

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

Fonctionnalités MCP du plugin :

  • Cycle de vie automatique : Au démarrage de la session, les serveurs des plugins activés se connectent automatiquement. Si vous activez ou désactivez un plugin pendant une session, exécutez /reload-plugins pour connecter ou déconnecter ses serveurs MCP
  • Variables d'environnement : utilisez ${CLAUDE_PLUGIN_ROOT} pour les fichiers du plugin groupés et ${CLAUDE_PLUGIN_DATA} pour l'état persistant qui survit aux mises à jour du 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)

Affichage des serveurs MCP du plugin :

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

Les serveurs des plugins apparaissent dans la liste avec des indicateurs montrant qu'ils proviennent des plugins.

Avantages des serveurs MCP du plugin :

  • 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é

Consultez la référence des composants du plugin pour plus de détails sur le regroupement des serveurs MCP avec les plugins.

Portées d'installation MCP

Les serveurs MCP peuvent être configurés à trois portées différentes. La portée que vous choisissez contrôle les projets dans lesquels le serveur se charge et si la configuration est partagée avec votre équipe. Les administrateurs peuvent également déployer des serveurs au niveau de l'entreprise via la configuration gérée.

Portée Se charge dans Partagé avec l'équipe Stocké dans
Local Projet actuel uniquement Non ~/.claude.json
Projet Projet actuel uniquement Oui, via le contrôle de version .mcp.json à la racine du projet
Utilisateur Tous vos projets Non ~/.claude.json

Portée locale

La portée locale est la portée par défaut. Un serveur à portée locale se charge uniquement dans le projet où vous l'avez ajouté et reste privé pour vous. Claude Code le stocke dans ~/.claude.json sous le chemin de ce projet, donc le même serveur n'apparaîtra pas dans vos autres projets. Utilisez la portée locale pour les serveurs de développement personnels, les configurations expérimentales ou les serveurs avec des identifiants que vous ne voulez pas dans le contrôle de version.

# 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

La commande écrit le serveur dans l'entrée de votre projet actuel dans ~/.claude.json. L'exemple ci-dessous montre le résultat lorsque vous l'exécutez à partir de /path/to/your/project :

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

Portée du projet

Les serveurs à portée de projet permettent la collaboration d'équipe en stockant les configurations dans un fichier .mcp.json à la racine de votre projet. Ce fichier est conçu pour être archivé dans le contrôle de version, garantissant que tous les membres de l'équipe ont accès aux mêmes outils et services MCP. Lorsque vous ajoutez un serveur à portée de projet, Claude Code crée ou met à jour automatiquement ce fichier avec la structure de configuration appropriée.

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

Le fichier .mcp.json résultant suit un format standardisé :

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

Pour des raisons de sécurité, Claude Code demande une approbation avant d'utiliser les serveurs à portée de projet à partir des fichiers .mcp.json. Si vous devez réinitialiser ces choix d'approbation, utilisez la commande claude mcp reset-project-choices.

Portée utilisateur

Les serveurs à portée utilisateur sont stockés dans ~/.claude.json et offrent une accessibilité inter-projets, les rendant disponibles dans tous les projets de votre machine tout en restant privés pour votre compte utilisateur. Cette portée fonctionne bien pour les serveurs utilitaires personnels, les outils de développement ou les services que vous utilisez fréquemment dans différents projets.

# 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

Lorsque le même serveur est défini à plus d'un endroit, Claude Code s'y connecte une fois, en utilisant la définition de la source avec la plus haute priorité :

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

Les trois portées correspondent aux doublons par nom. Les plugins et les connecteurs correspondent par point de terminaison, donc celui qui pointe vers la même URL ou commande qu'un serveur ci-dessus est traité comme un doublon.

Expansion des variables d'environnement dans .mcp.json

Claude Code supporte l'expansion des variables d'environnement dans les fichiers .mcp.json, permettant aux équipes de partager des configurations tout en maintenant la flexibilité pour les chemins spécifiques à la machine et les valeurs sensibles comme les clés API.

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 : Les variables d'environnement peuvent être développées dans :

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

Si une variable d'environnement requise n'est pas définie et n'a pas de valeur par défaut, Claude Code ne pourra pas analyser la configuration.

Exemples pratiques

{/* ### Exemple : Automatiser les tests de navigateur avec Playwright

claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest

Ensuite, écrivez et exécutez des tests de navigateur :

Test si le flux de connexion fonctionne avec test@example.com

Prendre une capture d'écran de la page de paiement sur mobile

Vérifier que la fonction de recherche retourne des résultats
``` */}

### Exemple : Surveiller les erreurs avec Sentry

```bash theme={null}
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Authentifiez-vous avec votre compte Sentry :

/mcp

Ensuite, déboguez les problèmes de production :

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

Le serveur MCP distant de GitHub s'authentifie avec un jeton d'accès personnel GitHub transmis en tant qu'en-tête. Pour en obtenir un, ouvrez vos paramètres de jeton GitHub, générez un nouveau jeton à granularité fine avec accès aux référentiels avec lesquels vous souhaitez que Claude travaille, puis ajoutez le serveur :

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

Ensuite, travaillez avec GitHub :

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"

Ensuite, interrogez votre base de données naturellement :

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

De nombreux serveurs MCP basés sur le cloud nécessitent une authentification. Claude Code supporte OAuth 2.0 pour les connexions sécurisées.

1

Ajouter le serveur qui nécessite une authentification

Par exemple :

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

Utiliser la commande /mcp dans Claude Code

Dans Claude Code, utilisez la commande :

/mcp

Ensuite, suivez les étapes dans votre navigateur pour vous connecter.

Utiliser un port de rappel OAuth fixe

Certains serveurs MCP nécessitent un URI de redirection spécifique enregistré à l'avance. Par défaut, Claude Code choisit un port disponible aléatoire pour le rappel OAuth. Utilisez --callback-port pour fixer le port afin qu'il corresponde à un URI de redirection pré-enregistré de la forme http://localhost:PORT/callback.

Vous pouvez utiliser --callback-port seul (avec l'enregistrement dynamique du client) ou ensemble avec --client-id (avec les identifiants pré-configurés).

# 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

Certains serveurs MCP ne supportent pas la configuration OAuth automatique via l'enregistrement dynamique du client. Si vous voyez une erreur comme « Incompatible auth server: does not support dynamic client registration », le serveur nécessite des identifiants pré-configurés. Claude Code supporte également les serveurs qui utilisent un document de métadonnées d'ID client (CIMD) au lieu de l'enregistrement dynamique du client, et les découvre automatiquement. Si la découverte automatique échoue, enregistrez d'abord une application OAuth via le portail des développeurs du serveur, puis fournissez les identifiants lors de l'ajout du serveur.

1

Enregistrer une application OAuth auprès du serveur

Créez une application via le portail des développeurs du serveur et notez votre ID client et votre secret client.

De nombreux serveurs nécessitent également un URI de redirection. Si c'est le cas, choisissez un port et enregistrez un URI de redirection au format http://localhost:PORT/callback. Utilisez ce même port avec --callback-port à l'étape suivante.

2

Ajouter le serveur avec vos identifiants

Choisissez l'une des méthodes suivantes. Le port utilisé pour --callback-port peut être n'importe quel port disponible. Il doit simplement correspondre à l'URI de redirection que vous avez enregistré à l'étape précédente.

Utilisez --client-id pour passer l'ID client de votre application. Le drapeau --client-secret demande le secret avec une entrée masquée :

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

S'authentifier dans Claude Code

Exécutez /mcp dans Claude Code et suivez le flux de connexion du navigateur.

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

Pointez Claude Code vers une URL de métadonnées spécifique du serveur d'autorisation OAuth pour contourner la chaîne de découverte par défaut. Définissez authServerMetadataUrl lorsque les points de terminaison standard du serveur MCP génèrent des erreurs, ou lorsque vous souhaitez acheminer la découverte via un proxy interne. Par défaut, Claude Code vérifie d'abord les métadonnées de ressource protégée RFC 9728 à /.well-known/oauth-protected-resource, puis revient aux métadonnées du serveur d'autorisation RFC 8414 à /.well-known/oauth-authorization-server.

Définissez authServerMetadataUrl dans l'objet oauth de la configuration de votre serveur dans .mcp.json :

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

L'URL doit utiliser https://. authServerMetadataUrl nécessite Claude Code v2.1.64 ou ultérieur. Les scopes_supported de l'URL des métadonnées remplacent les portées que le serveur en amont annonce.

Restreindre les portées OAuth

Définissez oauth.scopes pour épingler les portées que Claude Code demande pendant le flux d'autorisation. C'est la façon supportée de restreindre un serveur MCP à un sous-ensemble approuvé par l'équipe de sécurité lorsque le serveur d'autorisation en amont annonce plus de portées que vous ne souhaitez accorder. La valeur est une seule chaîne séparée par des espaces, correspondant au format du paramètre scope dans RFC 6749 §3.3.

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

oauth.scopes a la priorité sur authServerMetadataUrl et les portées que le serveur découvre à /.well-known. Laissez-le non défini pour laisser le serveur MCP déterminer l'ensemble de portées demandées.

Si le serveur d'autorisation annonce offline_access dans scopes_supported, Claude Code l'ajoute aux portées épinglées afin que le jeton d'accès puisse être actualisé sans une nouvelle connexion au navigateur.

Si le serveur retourne ultérieurement un 403 insufficient_scope pour un appel d'outil, Claude Code se réauthentifie avec les mêmes portées épinglées. Élargissez oauth.scopes lorsqu'un outil dont vous avez besoin nécessite une portée en dehors de l'épingle.

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

Si votre serveur MCP utilise un schéma d'authentification autre que OAuth (tel que Kerberos, jetons de courte durée ou un SSO interne), utilisez headersHelper pour générer des en-têtes de requête au moment de la connexion. Claude Code exécute la commande et fusionne sa sortie dans les en-têtes de connexion.

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

La commande peut également être en ligne :

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

Exigences :

  • La commande doit écrire un objet JSON de paires clé-valeur de chaîne sur stdout
  • La commande s'exécute dans un shell avec un délai d'expiration de 10 secondes
  • Les en-têtes dynamiques remplacent tous les headers statiques portant le même nom

L'assistant s'exécute à nouveau à chaque connexion (au démarrage de la session et à la reconnexion). Il n'y a pas de mise en cache, donc votre script est responsable de toute réutilisation de jetons.

Claude Code définit ces variables d'environnement lors de l'exécution de l'assistant :

Variable Valeur
CLAUDE_CODE_MCP_SERVER_NAME le nom du serveur MCP
CLAUDE_CODE_MCP_SERVER_URL l'URL du serveur MCP

Utilisez-les pour écrire un script d'assistant unique qui sert plusieurs serveurs MCP.

Ajouter des serveurs MCP à partir de la configuration JSON

Si vous avez une configuration JSON pour un serveur MCP, vous pouvez l'ajouter directement :

1

Ajouter un serveur MCP à partir de 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
2

Vérifier que le serveur a été ajouté

claude mcp get weather-api

Importer les serveurs MCP à partir de Claude Desktop

Si vous avez déjà configuré des serveurs MCP dans Claude Desktop, vous pouvez les importer :

1

Importer les serveurs à partir de Claude Desktop

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

Sélectionner les serveurs à importer

Après avoir exécuté la commande, vous verrez une boîte de dialogue interactive qui vous permet de sélectionner les serveurs que vous souhaitez importer.

3

Vérifier que les serveurs ont été importés

claude mcp list

Utiliser les serveurs MCP à partir de Claude.ai

Si vous vous êtes connecté à Claude Code avec un compte Claude.ai, les serveurs MCP que vous avez ajoutés dans Claude.ai sont automatiquement disponibles dans Claude Code :

1

Configurer les serveurs MCP dans Claude.ai

Ajoutez les serveurs à claude.ai/customize/connectors. Sur les plans Team et Enterprise, seuls les administrateurs peuvent ajouter des serveurs.

2

Authentifier le serveur MCP

Complétez les étapes d'authentification requises dans Claude.ai.

3

Afficher et gérer les serveurs dans Claude Code

Dans Claude Code, utilisez la commande :

/mcp

Les serveurs Claude.ai apparaissent dans la liste avec des indicateurs montrant qu'ils proviennent de Claude.ai.

Un serveur que vous avez ajouté dans Claude Code prend précédence sur un connecteur claude.ai qui pointe vers la même URL. Quand cela se produit, /mcp répertorie le connecteur comme masqué et montre comment supprimer le doublon si vous préférez utiliser le connecteur.

Pour désactiver les serveurs MCP de Claude.ai dans Claude Code, définissez la variable d'environnement ENABLE_CLAUDEAI_MCP_SERVERS sur false :

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

Utiliser Claude Code comme serveur MCP

Vous pouvez utiliser Claude Code lui-même comme serveur MCP auquel d'autres applications peuvent se connecter :

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

Vous pouvez l'utiliser dans Claude Desktop en ajoutant cette configuration à claude_desktop_config.json :

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

Limites de sortie MCP et avertissements

Lorsque les outils MCP produisent de grandes sorties, Claude Code aide à gérer l'utilisation des jetons pour éviter de surcharger votre contexte de conversation :

  • 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
  • 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 texte, indépendamment de ce que MAX_MCP_OUTPUT_TOKENS est défini. Les outils qui retournent des données d'image sont toujours soumis à MAX_MCP_OUTPUT_TOKENS

Pour augmenter la limite pour les outils qui produisent de grandes sorties :

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Ceci est particulièrement utile lorsque vous travaillez avec des serveurs MCP qui :

  • 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

Augmenter la limite pour un outil spécifique

Si vous créez un serveur MCP, vous pouvez permettre aux outils individuels de retourner des résultats plus grands que le seuil par défaut de persistance sur disque en définissant _meta["anthropic/maxResultSizeChars"] dans l'entrée de l'outil dans la réponse tools/list. Claude Code augmente le seuil de cet outil à la valeur annotée, jusqu'à un plafond dur de 500 000 caractères.

Ceci est utile pour les outils qui retournent des sorties intrinsèquement grandes mais nécessaires, telles que les schémas de base de données ou les arbres de fichiers complets. Sans l'annotation, les résultats qui dépassent le seuil par défaut sont persistés sur disque et remplacés par une référence de fichier dans la conversation.

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

L'annotation s'applique indépendamment de MAX_MCP_OUTPUT_TOKENS pour le contenu texte, donc les utilisateurs n'ont pas besoin d'augmenter la variable d'environnement pour les outils qui la déclarent. Les outils qui retournent des données d'image sont toujours soumis à la limite de jetons.

Répondre aux demandes d'élicitation MCP

Les serveurs MCP peuvent demander une entrée structurée de votre part au cours d'une tâche en utilisant l'élicitation. Lorsqu'un serveur a besoin d'informations qu'il ne peut pas obtenir par lui-même, Claude Code affiche une boîte de dialogue interactive et transmet votre réponse au serveur. Aucune configuration n'est requise de votre côté : les boîtes de dialogue d'élicitation apparaissent automatiquement lorsqu'un serveur les demande.

Les serveurs peuvent demander une entrée de deux façons :

  • Mode formulaire : Claude Code affiche une boîte de 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.

Pour répondre automatiquement aux demandes d'élicitation sans afficher de boîte de dialogue, utilisez le hook Elicitation.

Si vous créez un serveur MCP qui utilise l'élicitation, consultez la spécification d'élicitation MCP pour les détails du protocole et les exemples de schéma.

Utiliser les ressources MCP

Les serveurs MCP peuvent exposer des ressources que vous pouvez référencer en utilisant des mentions @, similaire à la façon dont vous référencez les fichiers.

Référencer les ressources MCP

1

Lister les ressources disponibles

Tapez @ dans votre prompt pour voir les ressources disponibles de tous les serveurs MCP connectés. Les ressources apparaissent aux côtés des fichiers dans le menu d'autocomplétion.

2

Référencer une ressource spécifique

Utilisez le format @server:protocol://resource/path pour référencer une ressource :

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

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

Références de ressources multiples

Vous pouvez référencer plusieurs ressources dans un seul prompt :

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

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

La recherche d'outils maintient l'utilisation du contexte MCP faible en différant les définitions d'outils jusqu'à ce que Claude en ait besoin. Seuls les noms d'outils se chargent au démarrage de la session, donc l'ajout de plus de serveurs MCP a un impact minimal sur votre fenêtre de contexte.

Comment cela fonctionne

La recherche d'outils est activée par défaut. Les outils MCP sont différés plutôt que chargés dans le contexte à l'avance, et Claude utilise un outil de recherche pour découvrir les outils pertinents lorsqu'une tâche en a besoin. Seuls les outils que Claude utilise réellement entrent dans le contexte. De votre point de vue, les outils MCP fonctionnent exactement comme avant.

Si vous préférez le chargement basé sur un seuil, définissez ENABLE_TOOL_SEARCH=auto pour charger les schémas à l'avance lorsqu'ils s'ajustent dans 10 % de la fenêtre de contexte et différer uniquement le débordement. Consultez Configurer la recherche d'outils pour toutes les options.

Pour les auteurs de serveurs MCP

Si vous créez un serveur MCP, le champ des instructions du serveur devient plus utile avec la recherche d'outils activée. Les instructions du serveur aident Claude à comprendre quand rechercher vos outils, similaire à la façon dont les skills fonctionnent.

Ajoutez des instructions de serveur claires et descriptives qui expliquent :

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

Claude Code tronque les descriptions d'outils et les instructions du serveur à 2 Ko chacune. Gardez-les concis pour éviter la troncature, et mettez les détails critiques près du début.

Configurer la recherche d'outils

La recherche d'outils est activée par défaut : les outils MCP sont différés et découverts à la demande. Elle est désactivée par défaut sur Vertex AI, qui n'accepte pas l'en-tête bêta de recherche d'outils, et lorsque ANTHROPIC_BASE_URL pointe vers un hôte non-propriétaire, car la plupart des proxies ne transfèrent pas les blocs tool_reference. Définissez ENABLE_TOOL_SEARCH explicitement pour opter pour. Cette fonctionnalité nécessite des modèles qui supportent les blocs tool_reference : Sonnet 4 et ultérieur, ou Opus 4 et ultérieur. Les modèles Haiku ne supportent pas la recherche d'outils.

Contrôlez le comportement de la recherche d'outils avec la variable d'environnement ENABLE_TOOL_SEARCH :

Valeur Comportement
(non défini) Tous les outils MCP différés et chargés à la demande. Revient au chargement à l'avance sur Vertex AI ou lorsque ANTHROPIC_BASE_URL est un hôte non-propriétaire
true Tous les outils MCP différés, y compris sur Vertex AI et pour ANTHROPIC_BASE_URL non-propriétaire
auto Mode seuil : les outils se chargent à l'avance s'ils s'ajustent dans 10 % de la fenêtre de contexte, différés sinon
auto:<N> Mode seuil avec un pourcentage personnalisé, où <N> est 0-100 (par exemple, auto:5 pour 5 %)
false Tous les outils MCP chargés à l'avance, pas de différé 
# 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

Ou définissez la valeur dans le champ env de votre settings.json.

Vous pouvez également désactiver l'outil ToolSearch spécifiquement :

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

Exempter un serveur du différé

Si les outils d'un serveur doivent toujours être visibles pour Claude sans une étape de recherche, définissez alwaysLoad à true dans la configuration de ce serveur. Chaque outil de ce serveur se charge alors dans le contexte au démarrage de la session indépendamment du paramètre ENABLE_TOOL_SEARCH. Utilisez ceci pour un petit nombre d'outils que Claude doit utiliser à chaque tour, car chaque outil à l'avance consomme du contexte qui serait autrement disponible pour votre conversation.

L'entrée .mcp.json suivante exempte un serveur HTTP tout en laissant les autres serveurs différés :

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

Le champ alwaysLoad est disponible sur tous les types de serveurs et nécessite Claude Code v2.1.121 ou ultérieur. Un serveur MCP peut également marquer les outils individuels comme toujours chargés en incluant "anthropic/alwaysLoad": true dans l'objet _meta de l'outil, ce qui a le même effet pour cet outil uniquement.

La définition de alwaysLoad: true bloque également le démarrage jusqu'à ce que le serveur se connecte, limité au délai d'expiration de connexion standard de 5 secondes. Cela s'applique même lorsque MCP_CONNECTION_NONBLOCKING=1 est défini, car les outils doivent être présents lors de la construction de la première invite. Les autres serveurs se connectent toujours en arrière-plan lorsque le mode non-bloquant est activé.

Utiliser les prompts MCP comme commandes

Les serveurs MCP peuvent exposer des prompts qui deviennent disponibles en tant que commandes dans Claude Code.

Exécuter les prompts MCP

1

Découvrir les prompts disponibles

Tapez / pour voir toutes les commandes disponibles, y compris celles des serveurs MCP. Les prompts MCP apparaissent au format /mcp__servername__promptname.

2

Exécuter un prompt sans arguments

/mcp__github__list_prs
3

Exécuter un prompt avec des arguments

De nombreux prompts acceptent des arguments. Passez-les séparés par des espaces après la commande :

/mcp__github__pr_review 456

/mcp__jira__create_issue "Bug in login flow" high

Configuration MCP gérée

Pour les organisations qui ont besoin d'un contrôle centralisé sur les serveurs MCP, Claude Code supporte deux options de configuration :

  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

Ces options permettent aux administrateurs informatiques de :

  • 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

Lorsque vous déployez un fichier managed-mcp.json, il prend le contrôle exclusif de tous les serveurs MCP. Les utilisateurs ne peuvent pas ajouter, modifier ou utiliser d'autres serveurs MCP que ceux définis dans ce fichier. C'est l'approche la plus simple pour les organisations qui veulent un contrôle complet.

Les administrateurs système déploient le fichier de configuration dans un répertoire à l'échelle du système :

  • 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

Le fichier managed-mcp.json utilise le même format qu'un fichier .mcp.json standard :

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

Au lieu de prendre le contrôle exclusif, les administrateurs peuvent permettre aux utilisateurs de configurer leurs propres serveurs MCP tout en appliquant des restrictions sur les serveurs autorisés. Cette approche utilise allowedMcpServers et deniedMcpServers dans le fichier de paramètres gérés.

Options de restriction

Chaque entrée dans la liste blanche ou noire peut restreindre les serveurs de trois façons :

  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

Important : Chaque entrée doit avoir exactement un de serverName, serverCommand ou serverUrl.

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

Correspondance exacte :

  • 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"]

Comportement du serveur stdio :

  • 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

Comportement du serveur non-stdio :

  • 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

Les modèles d'URL supportent les caractères génériques en utilisant * pour correspondre à n'importe quelle séquence de caractères. Ceci est utile pour autoriser des domaines ou des sous-domaines entiers.

Exemples de caractères génériques :

  • 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

La correspondance du nom d'hôte est insensible à la casse et ignore un point FQDN final, en correspondant à la sémantique DNS. Un modèle comme *://Mcp.Example.com/* correspond à https://mcp.example.com/api, et https://mcp.example.com. est traité de la même manière que https://mcp.example.com. Les schémas et les chemins restent sensibles à la casse.

Comportement du serveur distant :

  • 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
Exemple : Liste blanche URL uniquement 
{
"allowedMcpServers": [
{ "serverUrl": "https://mcp.company.com/*" },
{ "serverUrl": "https://*.internal.corp/*" }
]
}

Résultat :

  • Serveur HTTP à https://mcp.company.com/api : ✅ Autorisé (correspond au modèle d'URL)
  • Serveur HTTP à https://api.internal.corp/mcp : ✅ Autorisé (correspond au sous-domaine générique)
  • Serveur HTTP à https://external.com/mcp : ❌ Bloqué (ne correspond à aucun modèle d'URL)
  • Serveur stdio avec n'importe quelle commande : ❌ Bloqué (aucune entrée de nom ou de commande à correspondre)
Exemple : Liste blanche commande uniquement 
{
"allowedMcpServers": [
{ "serverCommand": ["npx", "-y", "approved-package"] }
]
}

Résultat :

  • Serveur stdio avec ["npx", "-y", "approved-package"] : ✅ Autorisé (correspond à la commande)
  • Serveur stdio avec ["node", "server.js"] : ❌ Bloqué (ne correspond pas à la commande)
  • Serveur HTTP nommé « my-api » : ❌ Bloqué (aucune entrée de nom à correspondre)
Exemple : Liste blanche mixte nom et commande 
{
"allowedMcpServers": [
{ "serverName": "github" },
{ "serverCommand": ["npx", "-y", "approved-package"] }
]
}

Résultat :

  • Serveur stdio nommé « local-tool » avec ["npx", "-y", "approved-package"] : ✅ Autorisé (correspond à la commande)
  • Serveur stdio nommé « local-tool » avec ["node", "server.js"] : ❌ Bloqué (les entrées de commande existent mais ne correspondent pas)
  • Serveur stdio nommé « github » avec ["node", "server.js"] : ❌ Bloqué (les serveurs stdio doivent correspondre aux commandes lorsque les entrées de commande existent)
  • Serveur HTTP nommé « github » : ✅ Autorisé (correspond au nom)
  • Serveur HTTP nommé « other-api » : ❌ Bloqué (le nom ne correspond pas)
Exemple : Liste blanche nom uniquement 
{
"allowedMcpServers": [
{ "serverName": "github" },
{ "serverName": "internal-tool" }
]
}

Résultat :

  • Serveur stdio nommé « github » avec n'importe quelle commande : ✅ Autorisé (aucune restriction de commande)
  • Serveur stdio nommé « internal-tool » avec n'importe quelle commande : ✅ Autorisé (aucune restriction de commande)
  • Serveur HTTP nommé « github » : ✅ Autorisé (correspond au nom)
  • N'importe quel serveur nommé « other » : ❌ Bloqué (le nom ne correspond pas)

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)