---
title: Sicherheit von MCP-Tunneln
url: https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/security
description: Hinweise zur Härtung, Rotation von Zugangsdaten, Reaktion auf Sicherheitsvorfälle und Stilllegung von MCP-Tunnel-Deployments.
---

<Note>
  „MCP tunnels" (MCP-Tunnel) befinden sich in der „research preview" (Forschungsvorschau). [Fordere Zugang an](https://claude.com/form/mcp-tunnels), um sie auszuprobieren.
</Note>

Die Tunnel-Architektur bietet starke Standardeinstellungen (ausschließlich ausgehende Konnektivität, Ende-zu-Ende-Verschlüsselung und IP-Validierung), aber die Gesamtsicherheit deines [Tunnel-Stacks](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/concepts#components) hängt auch davon ab, wie du ihn konfigurierst und betreibst. Diese Seite behandelt empfohlene Härtungsmaßnahmen, die Reaktion auf Sicherheitsvorfälle und die Außerbetriebnahme eines Tunnels.

## Best Practices

* **Erfordere OAuth auf jedem MCP-Server.** Konfiguriere jeden [Upstream-MCP-Server](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/concepts#components) so, dass er OAuth erfordert, wie in der [MCP-Autorisierungsspezifikation](https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization) beschrieben. OAuth bietet „defense in depth“ (gestaffelte Verteidigung) zusätzlich zur Transport-Authentifizierung des Tunnels und ermöglicht eine Autorisierung auf Benutzerebene in der Datenschicht.
* **Aktiviere SSO für deine Organisation.** Tunnel, Föderationsregeln und Service-Accounts werden in der Claude Console verwaltet. SSO setzt die Sitzungskontrollen deines Identity-Providers für die Admins durch, die diese ändern können.
* **Schränke `upstream.allowed_ips` ein.** Verwende die kleinsten CIDR-Bereiche, die deine MCP-Server abdecken. Dies ist die primäre SSRF-Abwehr des [Proxys](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/concepts#components).
* **Überwache Logs.** Richte Alarme für Warnungen, Fehler und ungewöhnliche Traffic-Muster des Tunnel-Stacks ein.
* **Rotiere Zugangsdaten.** Rotiere das Server-Zertifikat und das Tunnel-Token nach einem regelmäßigen Zeitplan und sofort, wenn du eine Kompromittierung vermutest.
* **Halte Images aktuell.** Verfolge neue Proxy-Releases und pinne Images per SHA-256-Digest.
* **Begrenze die Netzwerkreichweite.** Der Proxy und [cloudflared](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/concepts#components) sollten nur die in den [Netzwerkanforderungen](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/overview#network-requirements) aufgeführten Ziele erreichen können. Verwende NetworkPolicy (Kubernetes) oder Host-Firewall-Regeln (Compose).
* **Begrenze den Umfang der MCP-Server.** Jeder Server sollte nur die Tools und Daten bereitstellen, die für seinen Zweck erforderlich sind.
* **Schütze ruhende Zugangsdaten.** Wende die Secrets-Management-Praktiken deiner Organisation auf private Schlüssel und Tunnel-Tokens an.

## Auf einen vermuteten Sicherheitsvorfall reagieren

Wenn du glaubst, dass dein Tunnel-Token, deine TLS-Schlüssel oder dein Proxy-Host kompromittiert wurden:

<Steps>
  <Step title="Stoppe den Tunnel-Stack">
    <Tabs>
      <Tab title="Helm">
        ```bash
        helm uninstall mcp-tunnel -n mcp-tunnel
        ```
      </Tab>

      <Tab title="Docker Compose">
        ```bash
        docker compose down --timeout 0
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Trenne die Upstream-MCP-Server">
    Entferne die Upstream-MCP-Server aus allen Managed-Agent-Sitzungen, die sie verwenden, und übergib ihre URLs nicht mehr im `mcp_servers`-Block von Messages-API-Anfragen.
  </Step>

  <Step title="Archiviere den Tunnel">
    Das Archivieren macht das Tunnel-Token ungültig und trennt die Domain. [Archiviere den Tunnel](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/console#archive-a-tunnel) in der Console über die Liste **MCP tunnels**. Um stattdessen über die API zu archivieren, siehe [Einen Tunnel archivieren](https://platform.claude.com/docs/de/api/beta/tunnels/archive).
  </Step>

  <Step title="Kontaktiere Anthropic">
    Melde die vermutete Kompromittierung dem Anthropic-Support.
  </Step>

  <Step title="Rotiere nachgelagerte Zugangsdaten">
    Stelle einen neuen Tunnel bereit und rotiere alle OAuth-Tokens, die von den betroffenen MCP-Servern ausgestellt wurden.
  </Step>

  <Step title="Prüfe die Logs, bevor du den Dienst wiederherstellst">
    Untersuche die Logs von Proxy, cloudflared und MCP-Servern für den Zeitraum der vermuteten Kompromittierung, bevor du den neuen Tunnel in Betrieb nimmst.
  </Step>
</Steps>

## Einen Tunnel stilllegen

Befolge diese Schritte, um einen Tunnel außer Betrieb zu nehmen und alle gespeicherten Zugangsdaten zu entfernen.

<Steps>
  <Step title="Stoppe den Tunnel-Stack">
    <Tabs>
      <Tab title="Helm">
        ```bash
        helm uninstall mcp-tunnel -n mcp-tunnel
        ```
      </Tab>

      <Tab title="Docker Compose">
        ```bash
        docker compose down
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Archiviere den Tunnel">
    [Archiviere den Tunnel](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/console#archive-a-tunnel) in der Console über die Liste **MCP tunnels**.
  </Step>

  <Step title="Entferne gespeicherte Zugangsdaten">
    <Tabs>
      <Tab title="Helm">
        Mit programmatischem Zugriff hat die Setup-Komponente ein einzelnes Secret erstellt, das nach dem Release benannt ist. Ohne programmatischen Zugriff hast du `mcp-tunnel-token` und `mcp-tunnel-cert` selbst erstellt. Lösche, was jeweils zutrifft:

        ```bash
        kubectl -n mcp-tunnel delete secret \
          mcp-tunnel mcp-tunnel-token mcp-tunnel-cert \
          --ignore-not-found
        ```
      </Tab>

      <Tab title="Docker Compose">
        Private Schlüssel und Zertifikate liegen in `data/`. Das Tunnel-Token liegt in `data/tunnel-token` (programmatischer Ablauf) oder in deiner Shell-Umgebung (manueller Ablauf). Das Verzeichnis `config/` und `docker-compose.yaml` enthalten keine Secrets; behalte sie, wenn du eine erneute Bereitstellung planst, oder entferne sie ebenfalls.

        ```bash
        sudo rm -rf data
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>