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

• 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 ein Server bewertet wird

1. Listen zusammenführen. Zulassungs- und Sperrlisten-Einträge aus jedem Einstellungsbereich werden in eine Zulassungsliste und eine Sperrliste kombiniert. Wenn allowManagedMcpServersOnly true ist, wird nur die verwaltete Zulassungsliste beibehalten; die Sperrliste wird immer aus jedem Bereich zusammengeführt. Wenn mehr als eine verwaltete Quelle vorhanden ist, sagt Schlüssel, die aus jeder Admin-Quelle gelesen werden, welche von ihnen die Listen des verwalteten Bereichs liefern.
2. Sperrliste überprüfen. Ein Server, der einem Sperrlisten-Eintrag entspricht, nach URL, Befehl oder Name, wird blockiert. Nichts überschreibt eine Sperrlisten-Übereinstimmung.
3. Zulassungsliste überprüfen. Wenn allowedMcpServers nirgendwo 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 folgenden Tabelle gezeigt. Drei Gruppen von Servern überspringen diese Überprüfung:
   • Die eigenen Server der Organisation: jeder managedMcpServers-Eintrag und jeder managed-mcp.json-Eintrag, dessen Werte keine ${VAR}-Erweiterung verwenden.
   • Integrierte Server, z. B. Claude in Chrome, der ide-Server, mit dem Claude Code sich in einer laufenden VS Code- oder JetBrains-IDE verbindet, und Server, die die CLI selbst konfiguriert.
   • Die Slack-Tools einer Claude Tag-Sitzung: die Server, die sie zum Lesen des Threads und zum Posten ihrer Antworten verwendet, werden ohne einen Zulassungslisten-Eintrag geladen.
   Ein managed-mcp.json-Server, der ${VAR}-Erweiterung in seinem Befehl, seinen Argumenten, env, URL oder Headern verwendet, wird immer noch überprüft. Das gleiche gilt für jeden Server, den ein Benutzer, ein Plugin oder claude.ai hinzufügt, und jeden Server, den ein Benutzer mit --mcp-config übergibt.

• Befehle stimmen genau überein. Jedes Argument, in Reihenfolge. ["npx", "-y", "server"] stimmt nicht mit ["npx", "server"] oder ["npx", "-y", "server", "--flag"] überein.
• serverCommand- und serverUrl-Werte werden vor dem Abgleich erweitert. Sowohl der Richtlinieneintrag als auch der konfigurierte Wert des Servers durchlaufen ${VAR}- und ${VAR:-default}-Erweiterung, sodass ein Eintrag, der als ["${HOME}/bin/server"] geschrieben ist, mit einer Serverkonfiguration übereinstimmt, 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. Die beiden Seiten lesen unterschiedliche Umgebungen; Wie Richtlinieneinträge erweitert werden behandelt, welche und wie sich Zulassungs- und Sperrlisten-Einträge unterscheiden.
• URLs unterstützen *-Platzhalter überall im Muster, einschließlich des Schemas. Der Hostname-Abgleich ist nicht case-sensitiv und ignoriert einen nachgestellten FQDN-Punkt, sodass https://Mcp.Example.com/* mit https://mcp.example.com/api übereinstimmt. Pfade bleiben case-sensitiv.

​

Wie Richtlinieneinträge erweitert werden

​

Beispielkonfiguration

{
  "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/*" }
  ]
}

• Zeile 3: der erste serverUrl-Eintrag. Sobald einer existiert, muss jeder Remote-Server einem URL-Muster entsprechen, sodass ein Benutzer keinen nicht aufgelisteten Remote-Server durch Vergabe eines erlaubten Namens erhalten kann.
• Zeile 5: der erste serverCommand-Eintrag. Gleicher Effekt für Stdio-Server, sodass jeder lokale Server genau einem aufgelisteten Befehl entsprechen muss.
• Zeile 11: ein serverName-Eintrag in der Sperrliste. Sperrlisten-Einträge gelten immer, sodass jeder Server namens dangerous-server unabhängig von seiner URL oder seinem Befehl blockiert wird.

{
  "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/*" }
  ]
}

​

Beschränken Sie die Zulassungsliste auf verwaltete Einstellungen nur

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

​

Wie Einschränkungen für Benutzer angezeigt werden

​

Überwachen Sie die MCP-Nutzung

​

Konfigurationszusammenfassung

​

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 allowedMcpServers und deniedMcpServers aus 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