- Wählen Sie ein Muster, das dem erforderlichen Kontrollumfang entspricht
- Stellen Sie einen festen Serversatz mit
managed-mcp.jsonbereit, einschließlich Deaktivierung von MCP vollständig - Kontrollieren Sie Server mit Zulassungslisten und Sperrlisten
- Teilen Sie Benutzern mit, was sie erwarten können, wenn eine Einschränkung einen Server blockiert
- Überwachen Sie, welche Server Ihre Organisation tatsächlich nutzt
Die Seite Sicherheit behandelt das MCP-Bedrohungsmodell und wie Sie einen Server vor der Genehmigung bewerten. Entscheiden Sie, was Sie durchsetzen möchten behandelt MCP-Einschränkungen zusammen mit den anderen administrativen Kontrollen.
Wählen Sie ein Muster
Claude Code unterstützt eine Reihe von Einschränkungsstufen. Jedes Muster verwendet einen oder beide der unten behandelten Mechanismen:managed-mcp.json zur Bereitstellung eines festen Satzes und allowedMcpServers/deniedMcpServers zum Filtern der Benutzerkonfiguration.
Claude Code hat keine integrierte MCP-Serverregistrierung, die Benutzer durchsuchen und installieren können. Für das Muster des genehmigten Katalogs teilen Sie die genehmigte Liste und ihre
claude mcp add-Befehle an einem Ort, den Ihre Benutzer finden, z. B. einem internen Wiki, oder verteilen Sie die Server als Plugins über einen verwalteten Plugin-Marketplace, damit Benutzer sie von /plugin durchsuchen und installieren können.Exklusive Kontrolle mit managed-mcp.json
Wenn Sie einemanaged-mcp.json-Datei bereitstellen, lädt Claude Code nur die Server, die diese Datei definiert. Benutzer können keine anderen MCP-Server hinzufügen, ändern oder verwenden, einschließlich Plugin-bereitgestellter Server. Die Datei unterdrückt auch claude.ai-Konnektoren, es sei denn, Sie erlauben sie neben dem verwalteten Satz.
Zwei weitere Einstellungen können den verwalteten Satz weiter filtern:
allowedMcpServersunddeniedMcpServersgelten auch für verwaltete Server, daher wird ein verwalteter Server, der diese nicht erfüllt, nicht geladen.- Die eigenen
deniedMcpServerseines Benutzers werden aus seinen Einstellungen zusammengeführt, daher können Benutzer einen verwalteten Server für sich selbst blockieren.
managed-mcp.json ist eine eigenständige Datei und kann nicht über serververwaltete Einstellungen bereitgestellt werden. Jeder Prozess, der in einen Systempfad mit Administratorrechten schreiben kann, kann ihn bereitstellen. In großem Maßstab geschieht dies normalerweise über Geräteverwaltungstools wie Jamf oder ein Konfigurationsprofil auf macOS, Gruppenrichtlinie oder Intune unter Windows oder Ihre Fleet-Verwaltung Ihrer Wahl unter Linux. Claude Code sucht die Datei unter einem dieser Pfade:
Die Datei verwendet das gleiche Format wie eine Projekt-
.mcp.json-Datei:
Authentifizieren Sie sich mit benutzerspezifischen Anmeldedaten
Jeder Benutzer auf dem Computer kann diese Datei lesen, daher speichern Sie keine API-Schlüssel oder andere Anmeldedaten inenv-Blöcken. Übergeben Sie benutzerspezifische Anmeldedaten stattdessen mit einem dieser:
${VAR}-Erweiterung zum Lesen von Geheimnissen aus der Umgebung jedes Benutzers.- OAuth oder benutzerspezifische Header, damit sich jeder Benutzer selbst authentifiziert.
headersHelperzum Generieren von Anmeldedaten zum Verbindungszeitpunkt.
Validieren Sie die Konfiguration
Um zu bestätigen, dass die Datei wirksam ist, führen Sie zwei Überprüfungen auf einem verwalteten Computer durch:claude mcp listzeigt nur die Server inmanaged-mcp.json. Wenn die eigenen Server eines Benutzers immer noch angezeigt werden, wird die Datei nicht gelesen; überprüfen Sie den Pfad und die Berechtigungen.claude mcp add --transport http test https://example.com/mcpschlägt mitCannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP serversfehl. Die URL muss kein echter Server sein, da die Richtlinienprüfung den Befehl ablehnt, bevor etwas kontaktiert wird.
Deaktivieren Sie MCP vollständig
Stellen Sie einemanaged-mcp.json mit einer leeren Serverzuordnung bereit, um jeden MCP-Server zu blockieren:
/mcp, und claude mcp add schlägt mit dem oben genannten Enterprise-Richtlinienfehler fehl. Server, die Benutzer zuvor konfiguriert hatten, werden beim nächsten Starten einer Sitzung nicht mehr geladen, ohne dass eine Warnung angezeigt wird, dass die Richtlinie der Grund ist.
Erlauben Sie claude.ai-Konnektoren neben dem verwalteten Satz
Die Bereitstellung vonmanaged-mcp.json unterdrückt claude.ai-Konnektoren standardmäßig, einschließlich Konnektoren, die ein Administrator für die Organisation in der claude.ai-Verwaltungskonsole konfiguriert hat. Um diese Konnektoren neben den Servern in managed-mcp.json zu laden, setzen Sie "allowAllClaudeAiMcps": true in einer verwalteten Einstellungsquelle. Erfordert Claude Code v2.1.149 oder später.
Mit der aktivierten Einstellung lädt Claude Code die gleichen claude.ai-Konnektoren, die es laden würde, wenn managed-mcp.json nicht bereitgestellt würde. Zulassungslisten und Ablehnungslisten gelten weiterhin für diese Konnektoren, daher können Sie bestimmte mit deniedMcpServers blockieren. Die Einstellung betrifft nur claude.ai-Konnektoren; Plugin-bereitgestellte Server bleiben unterdrückt.
Claude Code liest diese Einstellung nur aus von Administratoren kontrollierten Richtlinien-Ebenen: serververwaltete Einstellungen, ein von MDM bereitgestellter plist- oder HKLM-Registrierungsschlüssel oder eine System-managed-settings.json-Datei. Das Platzieren in Benutzer- oder Projekteinstellungen hat keine Auswirkung, daher können Benutzer Konnektoren, die exklusive Kontrolle unterdrückt hat, nicht erneut aktivieren.
Richtlinienbasierte Kontrolle mit Zulassungslisten und Sperrlisten
Zulassungslisten und Sperrlisten filtern, welche konfigurierten Server geladen werden dürfen. Sie sind keine Registrierung: Ein Server muss immer noch von einem Benutzer, einem Plugin odermanaged-mcp.json hinzugefügt werden, bevor die Zulassungsliste oder Sperrliste darauf angewendet wird. Um Server für Benutzer bereitzustellen, verwenden Sie managed-mcp.json. Beide Listen filtern auch Server, die mit dem --mcp-config CLI-Flag übergeben werden; --strict-mcp-config begrenzt, welche Konfigurationsdateien geladen werden, und umgeht keine der beiden Listen.
Um die Zulassungsliste verbindlich zu machen, setzen Sie allowedMcpServers und allowManagedMcpServersOnly: true zusammen in einer verwalteten Einstellungsquelle, z. B. serververwaltete Einstellungen oder eine bereitgestellte managed-settings.json-Datei. Beschränken Sie die Zulassungsliste auf verwaltete Einstellungen nur zeigt die Konfiguration. Ohne allowManagedMcpServersOnly werden Zulassungslisten aus jeder Einstellungsquelle zusammengeführt, einschließlich der eigenen ~/.claude/settings.json eines Benutzers, daher kann ein Benutzer erweitern, was Ihre Zulassungsliste erlaubt. Sperrlisten werden unabhängig davon aus jeder Quelle zusammengeführt.
allowManagedMcpServersOnly ist getrennt von allowManagedPermissionRulesOnly, das Berechtigungsregeln nur sperrt. Das Setzen dieses Flags erzwingt nicht die MCP-Zulassungsliste.Passen Sie Server nach URL, Befehl oder Name an
allowedMcpServers und deniedMcpServers sind Listen von Einträgen. Jeder Eintrag ist ein Objekt mit einem einzelnen Schlüssel, der Server nach ihrer URL, ihrem Befehl oder ihrem Namen identifiziert:
Das Nicht-Setzen von
allowedMcpServers unterscheidet sich vom Setzen auf ein leeres Array:
Siehe Ungültige Einträge in verwalteten Einstellungen für das, was passiert, wenn ein Eintrag die Schemavalidierung nicht besteht.
Die
serverName-Validierung unterscheidet sich zwischen den beiden Listen:
- In
deniedMcpServersakzeptiertserverNamejede nicht leere Zeichenkette, daher können Sie claude.ai-Konnektoren nach ihrem Anzeigenamen blockieren. Beispielsweise blockiert{ "serverName": "claude.ai Slack" }den Slack-Konnektor. Bevorzugen Sie einenserverUrl-Eintrag, wenn die Sperrung robust gegen Umbenennungen sein muss, oder wenn ein Konnektor-Name kollidiert und ein(N)-Suffix erhält. - In
allowedMcpServersistserverNameauf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt. Verwenden SieserverUrl, um einen claude.ai-Konnektor in die Zulassungsliste aufzunehmen.
disableClaudeAiConnectors.
Wie ein Server bewertet wird
Vor dem Laden eines Servers, einschließlich eines ausmanaged-mcp.json, führt Claude Code drei Überprüfungen in Reihenfolge durch:
- Zusammenführen der Listen. Zulassungslisten- und Sperrlisten-Einträge aus jeder Einstellungsquelle werden in eine Zulassungsliste und eine Sperrliste kombiniert. Wenn
allowManagedMcpServersOnlytrueist, wird nur die verwaltete Zulassungsliste beibehalten; die Sperrliste wird immer aus jeder Quelle zusammengeführt. - Überprüfen Sie die Sperrliste. Ein Server, der einem Sperrlisten-Eintrag entspricht, nach URL, Befehl oder Name, wird blockiert. Nichts überschreibt eine Sperrlisten-Übereinstimmung.
- Überprüfen Sie die Zulassungsliste. Wenn
allowedMcpServersnirgendwo gesetzt ist, wird jeder Server, der die Sperrliste bestanden hat, geladen. Wenn es gesetzt ist, hängt das, dem der Server entsprechen muss, von seinem Typ ab, wie in der Tabelle unten gezeigt.
Drei Matching-Regeln gelten innerhalb dieser Überprüfungen:
- Befehle stimmen genau überein. Jedes Argument, in Reihenfolge.
["npx", "-y", "server"]stimmt nicht mit["npx", "server"]oder["npx", "-y", "server", "--flag"]überein. serverCommand- undserverUrl-Werte werden vor dem Matching erweitert. Sowohl der Richtlinieneintrag als auch der konfigurierte Wert des Servers durchlaufen die gleiche${VAR}- und${VAR:-default}-Erweiterung wie.mcp.json, daher passt ein Eintrag, der als["${HOME}/bin/server"]geschrieben ist, zu einer Serverkonfiguration, die entweder die gleiche Referenz oder den erweiterten Pfad verwendet. Unter Windows verweisen Sie auf eine Umgebungsvariable, die dort gesetzt ist, z. B.${USERPROFILE}statt${HOME}.serverName-Werte stimmen wörtlich überein und werden nie erweitert.- URLs unterstützen
*-Platzhalter überall im Muster, einschließlich des Schemas. Hostname-Matching ist case-insensitiv und ignoriert einen nachgestellten FQDN-Punkt, daher passthttps://Mcp.Example.com/*zuhttps://mcp.example.com/api. Pfade bleiben case-sensitiv.
Da
${VAR}-Erweiterung die Prozessumgebung von Claude Code selbst liest, wird ein serverCommand- oder serverUrl-Richtlinieneintrag, der auf eine Variable verweist, zu dem Wert erweitert, den ein Benutzer setzt. Verwenden Sie wörtliche URLs und Befehle für Einträge, auf die Sie sich für die Durchsetzung verlassen.
Beispielkonfiguration
Die folgende Konfiguration richtet eine harte Zulassungsliste mit einer Sperrliste ein. Die hervorgehobenen Zeilen ändern, wie der Rest der Liste bewertet wird, und die Callouts nach dem Block erklären jeweils:- Zeile 3: der erste
serverUrl-Eintrag. Sobald einer existiert, muss jeder Remote-Server einem URL-Muster entsprechen, daher kann ein Benutzer keinen nicht aufgelisteten Remote-Server erhalten, indem er ihm einen zulässigen Namen gibt. - Zeile 5: der erste
serverCommand-Eintrag. Gleicher Effekt für Stdio-Server, daher muss jeder lokale Server genau einem aufgelisteten Befehl entsprechen. - Zeile 11: ein
serverName-Eintrag in der Sperrliste. Sperrlisten-Einträge gelten immer, daher wird jeder Server namensdangerous-serverblockiert, unabhängig von seiner URL oder seinem Befehl.
serverName-Eintrag in dieser Zulassungsliste würde niemals etwas entsprechen, da beide Transporttypen bereits strengere Einträge haben.
Die Akkordeons unten zeigen, wie ein Server gegen andere Zulassungslisten- und Sperrlisten-Kombinationen bewertet wird.
Nur-URL-Zulassungsliste
Nur-URL-Zulassungsliste
Nur-Befehl-Zulassungsliste
Nur-Befehl-Zulassungsliste
Gemischte Name- und Befehl-Zulassungsliste
Gemischte Name- und Befehl-Zulassungsliste
Nur-Name-Zulassungsliste
Nur-Name-Zulassungsliste
Zulassungsliste mit Sperrlisten-Überschreibung
Zulassungsliste mit Sperrlisten-Überschreibung
Beschränken Sie die Zulassungsliste auf verwaltete Einstellungen nur
Um die verwaltete Zulassungsliste zur einzigen anzuwenden, setzen SieallowManagedMcpServersOnly in der verwalteten Einstellungsdatei:
allowManagedMcpServersOnly true ist, werden Zulassungslisten aus Benutzer-, Projekt- und lokalen Einstellungen ignoriert. Die Sperrliste wird immer noch aus allen Quellen zusammengeführt, daher können Benutzer Server immer für sich selbst blockieren.
Wie Einschränkungen für Benutzer angezeigt werden
Wenn eine Einschränkung einen Server blockiert, sieht der Benutzer entweder einen Fehler vonclaude mcp add oder der Server wird stillschweigend nicht mehr geladen. Verwenden Sie diese Tabelle, um diese Berichte zu erkennen und um Benutzern mitzuteilen, was sie erwarten können, bevor Sie eine Änderung einführen:
Im letzten Fall erhält der Benutzer kein Signal, dass die Richtlinie der Grund ist, warum sein Server verschwunden ist, daher teilen Sie betroffenen Benutzern mit, welche Server blockiert werden, wenn Sie eine neue Einschränkung einführen.
Überwachen Sie die MCP-Nutzung
Wenn OpenTelemetry-Export konfiguriert ist, kann Claude Code aufzeichnen, welche MCP-Server und Tools Benutzer aufrufen. Setzen SieOTEL_LOG_TOOL_DETAILS=1, um MCP-Server- und Tool-Namen in Tool-Events einzubeziehen, und aggregieren Sie sie dann in Ihrem Collector, um zu sehen, welche Server Ihre Benutzer tatsächlich verbinden. Siehe Überwachung, um den Exporter einzurichten und das vollständige Event-Schema zu erhalten.
Konfigurationszusammenfassung
Jede Datei und Einstellung, die diese Seite behandelt, was sie kontrolliert und wie man sie bereitstellt:Verwandte Ressourcen
- Entscheiden Sie, was Sie durchsetzen möchten: MCP-Einschränkungen zusammen mit Berechtigungsregeln, Sandboxing und den anderen Admin-Kontrollen
- Verbinden Sie Claude Code mit Tools über MCP: die vollständige MCP-Referenz, einschließlich Transporte, Bereiche und Authentifizierung
- Einstellungen: die Einstellungshierarchie und wie verwaltete Einstellungen Vorrang haben
- Serververwaltete Einstellungen: Stellen Sie
allowedMcpServersunddeniedMcpServersaus der Claude.ai-Admin-Konsole bereit - Sicherheit: das Bedrohungsmodell, das diese Kontrollen schützen
- Claude Enterprise Administrator Guide: SSO, SCIM, Seat-Verwaltung und Rollout-Playbook