Kontrollieren Sie den MCP-Serverzugriff für Ihre Organisation

• Ein Muster wählen, das dem erforderlichen Kontrollumfang entspricht
• Einen festen Serversatz mit managed-mcp.json bereitstellen, einschließlich wie Sie MCP vollständig deaktivieren
• Server durch verwaltete Einstellungen bereitstellen, während Benutzer ihre eigenen behalten
• Server mit Zulassungslisten und Ablehnungslisten kontrollieren
• Benutzer informieren, was sie erwarten können, wenn eine Einschränkung einen Server blockiert
• Überwachen Sie, welche Server Ihre Organisation tatsächlich nutzt

​

Wählen Sie ein Muster

​

Exklusive Kontrolle mit managed-mcp.json

• Die Server, die die Datei definiert
• Server, die Sie über managedMcpServers bereitstellen
• In-Process-Server, die die Anwendung registriert, die die Sitzung gestartet hat, wie beispielsweise der eigene Server der VS Code-Erweiterung oder die Konnektoren, die die Desktop-Anwendung bereitstellt
• Der integrierte Claude in Chrome-Server, wenn Sie ihn neben dem verwalteten Satz erlauben

​

managed-mcp.json bereitstellen

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

​

Mit benutzerspezifischen Anmeldedaten authentifizieren

• ${VAR}-Erweiterung zum Lesen von Geheimnissen aus der Umgebung jedes Benutzers.
• OAuth oder benutzerspezifische Header, damit sich jeder Benutzer selbst authentifiziert.
• headersHelper zum Generieren von Anmeldedaten zum Verbindungszeitpunkt.

​

Server, die mit --mcp-config oder --strict-mcp-config übergeben werden

• Auf einer Workstation beendet Claude Code beim Start mit You cannot dynamically configure MCP servers when an enterprise MCP config is present.
• In Cloud-Sitzungen auf einem Host, auf dem die Datei bereitgestellt wird, wie beispielsweise einem selbstgehosteten Runner, startet Claude Code nur mit den verwalteten Servern und überspringt die claude.ai-Konnektoren und andere Server, die der Cloud-Host über --mcp-config bereitstellt. Nichts in der Sitzung teilt dem Benutzer mit, welche Server ausgelassen wurden. Claude Code benennt sie in einer Warnung auf stderr, die ein selbstgehosteter Runner auf der debug-Protokollebene aufzeichnet.

​

Wie Zulassungslisten und Ablehnungslisten auf den verwalteten Satz angewendet werden

• deniedMcpServers gilt auch für verwaltete Server, daher wird ein verwalteter Server, der einem Eintrag entspricht, nicht geladen.
• Die eigene deniedMcpServers eines Benutzers wird aus seinen Einstellungen zusammengeführt, daher können Benutzer einen verwalteten Server für sich selbst blockieren.

​

Konfiguration validieren

1. claude mcp list zeigt nur die Server in managed-mcp.json plus alle, die Sie über managedMcpServers bereitstellen. Zwei weitere Ergebnisse bedeuten, dass etwas nicht stimmt:
   • Wenn die eigenen Server eines Benutzers immer noch angezeigt werden, wird die Datei nicht gelesen; überprüfen Sie den Pfad und die Berechtigungen auf den übergeordneten Verzeichnissen.
   • Wenn die Server der Datei nicht angezeigt werden und der Abschnitt MCP config diagnostics die Enterprise-Konfiguration als fehlgeschlagen beim Parsen markiert, kann Claude Code die Datei nicht lesen oder parsen. Beheben Sie den Fehler, den dieser Abschnitt benennt, und lassen Sie den Benutzer Claude Code neu starten.
2. claude mcp add --transport http test https://example.com/mcp schlägt mit Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers fehl. Die URL muss kein echter Server sein, da die Richtlinienüberprüfung den Befehl ablehnt, bevor etwas kontaktiert wird.

​

MCP vollständig deaktivieren

{
  "mcpServers": {}
}

​

claude.ai-Konnektoren neben dem verwalteten Satz erlauben

​

Claude in Chrome neben dem verwalteten Satz erlauben

​

Server über verwaltete Einstellungen bereitstellen

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

​

Was ein Eintrag enthalten kann

• type ist http oder sse. Wie in .mcp.json wird streamable-http als Alias für http akzeptiert.
• url ist eine https://-URL. Claude Code lehnt eine einfache http://-URL ab, einschließlich einer, die auf localhost verweist.
• Der Eintrag hat keinen command-, args-, env- oder headersHelper-Member, daher nennt ein verwaltetes Einstellungsdokument niemals ein Programm, das auf dem Computer eines Benutzers ausgeführt werden soll.
• Kein Wert enthält einen ${VAR}-Verweis. Claude Code erweitert Umgebungsvariablen in diesen Einträgen nicht, daher schreiben Sie Literalwerte.
• Der Servername enthält nur Buchstaben, Zahlen, Bindestriche und Unterstriche, und kein Schlüssel oder Wert enthält Steuerzeichen oder unsichtbare Formatierungszeichen.

​

Wie bereitgestellte Server geladen werden

• Ein bereitgestellter Server hat Vorrang vor einem Server mit dem gleichen Namen im lokalen, Projekt- oder Benutzerbereich und vor einem Plugin-Server oder claude.ai-Connector, der auf die gleiche URL verweist.
• Wenn Sie auch managed-mcp.json bereitstellen, lädt Claude Code seine Server und die bereitgestellten Server zusammen, und der Eintrag der Datei hat Vorrang, wenn beide einen Namen definieren.
• Bereitgestellte Server werden weiterhin geladen, wenn strictPluginOnlyCustomization die mcp-Oberfläche sperrt.
• deniedMcpServers gilt für bereitgestellte Server, einschließlich Einträge aus den eigenen Einstellungen eines Benutzers, daher kann ein Benutzer einen für sich selbst blockieren. Bereitgestellte Server benötigen keinen allowedMcpServers-Eintrag.

• Ein Server, den ein Benutzer mit --mcp-config unter dem gleichen Namen übergibt, ersetzt den bereitgestellten für diesen Lauf und wird gegen allowedMcpServers überprüft.
• --strict-mcp-config lässt bereitgestellte Server zusammen mit jedem anderen konfigurierten Server weg.

​

Was Benutzer sehen und ändern können

• claude mcp remove meldet, dass der Server von der Organisation bereitgestellt wird.
• Wenn Sie auch managed-mcp.json nicht bereitgestellt haben, wird ein Eintrag, den ein Benutzer unter dem gleichen Namen hinzufügt, gespeichert, aber nicht verwendet, während Ihrer vorhanden ist.
• Benutzer können einen bereitgestellten Server für sich selbst in /mcp immer noch ausschalten, das bereitgestellte Server unter Managed MCPs auflistet.

​

Wo managedMcpServers gilt

​

Wenn bereitgestellte Server verbunden werden

• Auf einem Computer mit zwischengespeicherten Einstellungen hält Claude Code die zwischengespeicherte Kopie dieses Schlüssels zurück, bis der Server die Einstellungen für die Sitzung bestätigt, und wartet auf diese Bestätigung, bevor MCP-Server geladen werden. Wenn die Bestätigung fehlschlägt, wird die Sitzung ohne die bereitgestellten Server fortgesetzt und /status sagt, dass sie zurückgehalten werden.
• Beim ersten Start eines Computers, wenn noch nichts zwischengespeichert ist, verbindet eine interaktive Sitzung, die vor dem Eintreffen der Einstellungen startet, die bereitgestellten Server, sobald sie eintreffen, und ein claude -p-Lauf, der bereits gestartet hat, kann ohne sie beendet werden.

• Server hinzufügen: Claude Code verbindet ihn, wenn die aktualisierten Einstellungen eintreffen, ohne einen Neustart.
• Eintrag eines Servers ändern: Diese Sitzungen verbinden sich mit der neuen Definition erneut.
• Server entfernen: Eine laufende interaktive Sitzung trennt ihn, sobald sie die geänderten Einstellungen liest. Ein nicht-interaktiver (-p)-Lauf behält ihn bis zum Ende.

​

Richtlinienbasierte Kontrolle mit Zulassungs- und Sperrlisten

​

Server nach URL, Befehl oder Name abgleichen

​

Wie serverName-Einträge abgeglichen werden

• In deniedMcpServers akzeptiert serverName jede nicht leere Zeichenkette ohne führende oder nachfolgende Leerzeichen, sodass Sie claude.ai-Konnektoren nach ihrem Anzeigenamen blockieren können. Zum Beispiel blockiert { "serverName": "claude.ai Slack" } den Slack-Konnektor. Bevorzugen Sie einen serverUrl-Eintrag, wenn die Sperre robust gegen Umbenennungen sein muss, oder wenn ein Konnektor-Name kollidiert und ein (N)-Suffix erhält.
• In allowedMcpServers ist serverName auf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt. Verwenden Sie serverUrl, um einen claude.ai-Konnektor auf die Zulassungsliste zu setzen, den Claude Code selbst abruft; für Konnektoren, die ein Cloud-Host an selbstgehostete Sitzungen liefert, verwenden Sie stattdessen die unter Konnektor-Datenverkehr verlässt Ihr Netzwerk aufgelisteten Einträge.

​

Wie serverCommand-Einträge abgeglichen werden

• Befehle stimmen genau überein. Jedes Argument, in Reihenfolge. ["npx", "-y", "server"] stimmt nicht mit ["npx", "server"] oder ["npx", "-y", "server", "--flag"] überein.
• Der env-Block wird nicht verglichen. ["node", "server.js"] stimmt mit einem Server überein, der diesen Befehl mit beliebigen env-Werten ausführt. Einige Umgebungsvariablen ändern, was node beim Start lädt. Um die env-Werte selbst festzulegen, definieren Sie den Server in managed-mcp.json.

​

Wie serverUrl-Einträge abgeglichen werden

• Vollständig ausgeschriebener Hostname: nur der Standardport, 443 für https und 80 für http
• Hostname mit einem * darin: jeder Port

• https://staging.example.com/*: blockiert https-Server auf diesem Host nur auf Port 443, blockiert also keinen Server unter https://staging.example.com:8443/api
• https://staging.example.com:*/*: blockiert https-Server auf diesem Host auf jedem Port
• *://staging.example.com:*/*: blockiert diesen Host über jedes Schema und auf jedem Port

​

Umgebungsvariablen in serverCommand- und serverUrl-Einträgen

• Der konfigurierte Wert des Servers: wird aus der Live-Prozessumgebung erweitert, wie der Rest von .mcp.json
• Ein Richtlinieneintrag: wird aus einer angehefteten Umgebung erweitert, sodass eine Variable, die von einer Projekt- oder Benutzereinstellungsdatei gesetzt wird, nicht ändern kann, was ein Allowlist-Eintrag bedeutet