Contrôlez l'accès aux serveurs MCP pour votre organisation

• Choisir un modèle qui correspond au niveau de contrôle dont vous avez besoin
• Déployer un ensemble de serveurs fixe avec managed-mcp.json, y compris comment désactiver complètement MCP
• Fournir des serveurs via les paramètres gérés tandis que les utilisateurs conservent les leurs
• Contrôler les serveurs avec des listes blanches et des listes noires
• Informer les utilisateurs de ce à quoi s’attendre quand une restriction bloque un serveur
• Surveiller les serveurs que votre organisation utilise réellement

​

Choisir un modèle

​

Contrôle exclusif avec managed-mcp.json

• Les serveurs que le fichier définit
• Les serveurs que vous fournissez via managedMcpServers
• Les serveurs en processus que l’application qui a démarré la session enregistre, comme le serveur propre de l’extension VS Code ou les connecteurs que l’application de bureau fournit
• Le serveur intégré Claude in Chrome, si vous l’autorisez aux côtés de l’ensemble géré

​

Déployer 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.example.com"
      }
    }
  }
}

​

S’authentifier avec des identifiants par utilisateur

• Expansion ${VAR} pour lire les secrets de l’environnement de chaque utilisateur.
• OAuth ou en-têtes par utilisateur pour que chaque utilisateur s’authentifie en tant que lui-même.
• headersHelper pour générer des identifiants au moment de la connexion.

​

Serveurs transmis avec --mcp-config ou --strict-mcp-config

• Sur une station de travail, Claude Code se ferme au démarrage avec You cannot dynamically configure MCP servers when an enterprise MCP config is present.
• Dans les sessions cloud sur un hôte où le fichier est déployé, comme un exécuteur auto-hébergé, Claude Code démarre avec les serveurs gérés uniquement et ignore les connecteurs claude.ai et les autres serveurs que l’hôte cloud fournit via --mcp-config. Rien dans la session n’indique à l’utilisateur quels serveurs ont été omis. Claude Code les nomme dans un avertissement sur son stderr, qu’un exécuteur auto-hébergé enregistre au niveau de journal debug.

​

Comment les listes blanches et les listes noires s’appliquent à l’ensemble géré

• deniedMcpServers s’applique également aux serveurs gérés, donc un serveur géré qui correspond à une entrée ne se chargera pas.
• La propre deniedMcpServers d’un utilisateur se fusionne à partir de ses paramètres, donc les utilisateurs peuvent bloquer un serveur géré pour eux-mêmes.

​

Valider la configuration

1. claude mcp list affiche uniquement les serveurs dans managed-mcp.json, plus tous ceux que vous fournissez via managedMcpServers. Deux autres résultats signifient que quelque chose ne va pas :
   • Si les propres serveurs d’un utilisateur apparaissent toujours, Claude Code ne lit pas le fichier, donc vérifiez son chemin et les permissions sur ses répertoires parents.
   • Si les serveurs du fichier n’apparaissent pas et que la section MCP config diagnostics marque la configuration d’entreprise comme échouée à l’analyse, Claude Code ne peut pas lire ou analyser le fichier. Corrigez l’erreur que cette section nomme, puis demandez à l’utilisateur de redémarrer Claude Code.
2. claude mcp add --transport http test https://example.com/mcp échoue avec Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers. L’URL n’a pas besoin d’être un serveur réel, car la vérification de la politique rejette la commande avant que quoi que ce soit ne soit contacté.

​

Désactiver MCP entièrement

{
  "mcpServers": {}
}

​

Autoriser les connecteurs claude.ai aux côtés de l’ensemble géré

​

Autoriser Claude in Chrome aux côtés de l’ensemble géré

​

Fournir des serveurs via les paramètres gérés

{
  "managedMcpServers": {
    "search": {
      "type": "http",
      "url": "https://search.example.com/mcp"
    },
    "records": {
      "type": "http",
      "url": "https://records.example.com/mcp",
      "headers": {
        "X-Records-Key": "key-issued-for-all-claude-code-users"
      }
    }
  }
}

​

Ce qu’une entrée peut contenir

• type est http ou sse. Comme dans .mcp.json, streamable-http est accepté comme alias pour http.
• url est une URL https://. Claude Code refuse une URL http:// simple, y compris une qui pointe sur localhost.
• L’entrée n’a pas de membre command, args, env, ou headersHelper, donc un document de paramètres gérés ne nomme jamais un programme à exécuter sur la machine d’un utilisateur.
• Aucune valeur ne contient de référence ${VAR}. Claude Code n’étend pas les variables d’environnement dans ces entrées, donc écrivez des valeurs littérales.
• Le nom du serveur contient uniquement des lettres, des chiffres, des tirets et des traits de soulignement, et aucune clé ou valeur ne contient de caractères de contrôle ou de formatage invisible.

​

Comment les serveurs fournis se chargent

• Un serveur fourni a la priorité sur un serveur portant le même nom dans la portée locale, de projet ou d’utilisateur, et sur un serveur de plugin ou un connecteur claude.ai qui pointe sur la même URL.
• Si vous déployez également managed-mcp.json, Claude Code charge ses serveurs et les serveurs fournis ensemble, et l’entrée du fichier a la priorité quand les deux définissent un nom.
• Les serveurs fournis continuent de se charger quand strictPluginOnlyCustomization verrouille la surface mcp.
• deniedMcpServers s’applique aux serveurs fournis, y compris les entrées des propres paramètres d’un utilisateur, donc un utilisateur peut en bloquer un pour lui-même. Les serveurs fournis n’ont besoin d’aucune entrée allowedMcpServers.

• Un serveur qu’un utilisateur transmet avec --mcp-config sous le même nom remplace le serveur fourni pour cette exécution et est vérifié par rapport à allowedMcpServers.
• --strict-mcp-config laisse les serveurs fournis de côté ainsi que tous les autres serveurs configurés.

​

Ce que les utilisateurs peuvent voir et modifier

• claude mcp remove signale que le serveur est fourni par l’organisation.
• Quand vous n’avez pas également déployé managed-mcp.json, une entrée qu’un utilisateur ajoute sous le même nom est enregistrée mais non utilisée tant que la vôtre est présente.
• Les utilisateurs peuvent toujours désactiver un serveur fourni pour eux-mêmes dans /mcp, qui liste les serveurs fournis sous Managed MCPs.

​

Où managedMcpServers s’applique

​

Quand les serveurs fournis se connectent

• Sur une machine avec des paramètres en cache, Claude Code retient la copie en cache de cette clé jusqu’à ce que le serveur confirme les paramètres pour la session, et attend cette confirmation avant de charger les serveurs MCP. Si la confirmation échoue, la session continue sans les serveurs fournis et /status dit qu’ils sont retenus.
• Au premier lancement d’une machine, sans rien en cache encore, une session interactive qui démarre avant l’arrivée des paramètres connecte les serveurs fournis dès qu’ils arrivent, et une exécution claude -p qui a déjà commencé peut se terminer sans eux.

• Ajouter un serveur : Claude Code le connecte quand les paramètres mis à jour arrivent, sans redémarrage.
• Modifier l’entrée d’un serveur : ces sessions se reconnectent à celui-ci avec la nouvelle définition.
• Supprimer un serveur : une session interactive en cours le déconnecte une fois qu’elle lit les paramètres modifiés. Une exécution non-interactive (-p) le conserve jusqu’à ce qu’elle se termine.

​

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

​

Faire correspondre les serveurs par URL, commande ou nom

• Dans deniedMcpServers, serverName accepte n’importe quelle chaîne non vide sans espaces de début ou de fin, vous pouvez donc bloquer les connecteurs claude.ai par leur nom d’affichage. Par exemple, { "serverName": "claude.ai Slack" } bloque le connecteur Slack. Préférez une entrée serverUrl quand vous avez besoin que le refus soit robuste aux renommages, ou quand un nom de connecteur entre en collision et gagne un suffixe (N).
• Dans allowedMcpServers, serverName est limité aux lettres, chiffres, traits d’union et traits de soulignement. Utilisez serverUrl pour ajouter à la liste blanche un connecteur claude.ai que Claude Code récupère lui-même ; pour les connecteurs qu’un hôte cloud fournit aux sessions auto-hébergées, utilisez plutôt les entrées listées sous Le trafic des connecteurs quitte votre réseau.

​

Comment un serveur est évalué

1. Fusionner les listes. Les entrées de liste blanche et de liste noire de chaque portée de paramètres se combinent en une liste blanche et une liste noire. Quand allowManagedMcpServersOnly est true, seule la liste blanche gérée est conservée ; la liste noire fusionne toujours de chaque portée. Quand plus d’une source gérée est présente, Les clés lues à partir de chaque source d’administrateur indique lesquelles d’entre elles fournissent les listes de la portée gérée.
2. Vérifier la liste noire. Un serveur qui correspond à n’importe quelle entrée de liste noire, par URL, commande ou nom, est bloqué. Rien ne remplace une correspondance de liste noire.
3. Vérifier la liste blanche. Si allowedMcpServers n’est défini nulle part, tous les serveurs qui ont réussi la liste noire se chargent. S’il est défini, ce que le serveur doit correspondre dépend de son type, montré dans le tableau ci-dessous. Trois groupes de serveurs ignorent cette vérification :
   • Les serveurs de l’organisation : chaque entrée managedMcpServers, et toute entrée managed-mcp.json dont les valeurs n’utilisent pas d’expansion ${VAR}.
   • Les serveurs intégrés, comme Claude dans Chrome, le serveur ide auquel Claude Code se connecte dans un IDE VS Code ou JetBrains en cours d’exécution, et les serveurs que l’interface CLI elle-même configure.
   • Les outils Slack d’une session Claude Tag : les serveurs qu’elle utilise pour lire le fil et publier ses réponses se chargent sans entrée de liste blanche.
   Un serveur managed-mcp.json qui utilise l’expansion ${VAR} dans sa commande, ses arguments, env, son URL ou ses en-têtes est toujours vérifié. Il en va de même pour tous les serveurs qu’un utilisateur, un plugin, ou claude.ai ajoute, et tous les serveurs qu’un utilisateur transmet avec --mcp-config.

• Les commandes correspondent exactement. Chaque argument, dans l’ordre. ["npx", "-y", "server"] ne correspond pas à ["npx", "server"] ou ["npx", "-y", "server", "--flag"].
• Les valeurs serverCommand et serverUrl se développent avant la correspondance. L’entrée de politique et la valeur configurée du serveur passent toutes les deux par l’expansion ${VAR} et ${VAR:-default}, donc une entrée écrite comme ["${HOME}/bin/server"] correspond à une configuration de serveur qui utilise soit la même référence, soit le chemin développé. Sous Windows, référencez une variable d’environnement qui y est définie, comme ${USERPROFILE} au lieu de ${HOME}. Les valeurs serverName correspondent littéralement et ne se développent jamais. Les deux côtés lisent des environnements différents ; Comment les entrées de politique se développent couvre lesquels, et comment les entrées de liste blanche et de liste noire diffèrent.
• Les URL supportent les caractères génériques * n’importe où dans le motif, y compris le schéma. La correspondance du nom d’hôte est insensible à la casse et ignore un point FQDN final, donc https://Mcp.Example.com/* correspond à https://mcp.example.com/api. Les chemins restent sensibles à la casse.

​

Comment les entrées de politique se développent

​

Exemple de configuration

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.githubcopilot.com/*" },
    { "serverUrl": "https://mcp.sentry.dev/*" },
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "."] },
    { "serverCommand": ["python", "/usr/local/bin/approved-server.py"] },
    { "serverUrl": "https://mcp.example.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ],
  "deniedMcpServers": [
    { "serverName": "dangerous-server" },
    { "serverCommand": ["npx", "-y", "unapproved-package"] },
    { "serverUrl": "https://*.untrusted.example.com/*" }
  ]
}

• Ligne 3 : la première entrée serverUrl. Une fois qu’elle existe, chaque serveur distant doit correspondre à un motif d’URL, donc un utilisateur ne peut pas obtenir un serveur distant non listé en lui donnant un nom autorisé.
• Ligne 5 : la première entrée serverCommand. Même effet pour les serveurs stdio, donc chaque serveur local doit correspondre exactement à une commande listée.
• Ligne 11 : une entrée serverName dans la liste noire. Les entrées de liste noire s’appliquent toujours, donc n’importe quel serveur nommé dangerous-server est bloqué indépendamment de son URL ou de sa commande.

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

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

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

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

{
  "allowedMcpServers": [
    { "serverUrl": "https://*.example.com/*" }
  ],
  "deniedMcpServers": [
    { "serverUrl": "https://staging.example.com/*" }
  ]
}

​

Restreindre la liste blanche aux paramètres gérés uniquement

{
  "allowManagedMcpServersOnly": true,
  "allowedMcpServers": [
    { "serverUrl": "https://api.githubcopilot.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ]
}

​

Comment les restrictions apparaissent aux utilisateurs

​

Surveiller l’utilisation de MCP

​

Résumé de la configuration

​

Ressources connexes

• Décider ce qu’il faut appliquer : restrictions MCP aux côtés des règles de permission, du sandboxing et des autres contrôles d’administration
• Connecter Claude Code aux outils via MCP : la référence MCP complète, y compris les transports, les portées et l’authentification
• Paramètres : la hiérarchie des paramètres et comment les paramètres gérés ont la priorité
• Paramètres gérés par le serveur : livrer allowedMcpServers et deniedMcpServers à partir de la console d’administration Claude.ai
• Sécurité : le modèle de menace que ces contrôles défendent
• Guide de l’administrateur Claude Enterprise : SSO, SCIM, gestion des sièges et playbook de déploiement