---
title: Architektur und Komponenten
url: https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/concepts
description: Kanonische Bezeichnungen für die Bestandteile eines MCP-Tunnel-Deployments, die beiden Modi zur Bereitstellung von Anmeldedaten und das Verbindungsmodell.
---

<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>

Diese Seite definiert die Begriffe, die in der gesamten Dokumentation zu [MCP-Tunneln](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/overview) verwendet werden. Mehrere Komponenten erscheinen in Konfigurationsdateien, Container-Images und Fließtext unter unterschiedlichen Namen; die folgenden Tabellen geben für jede Komponente eine kanonische Bezeichnung an und listen die Aliasse auf, denen du begegnen könntest.

## Komponenten

| Begriff                 | Definition                                                                                                                                                                                                                                                                                                                                                                                            | Erscheint auch als                                                                                                                                                                                   |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tunnel-Stack**        | Die zwei Container, die du innerhalb deines Netzwerks betreibst, um dich mit einem Tunnel zu verbinden: der Proxy und cloudflared. Ein Stack bedient einen Tunnel und kann zur Erhöhung der Verfügbarkeit über mehrere Hosts repliziert werden. Bei programmatischem Zugriff läuft die Setup-Komponente neben dem Stack, um Anmeldedaten bereitzustellen.                                             | der Stack, der MCP-Tunnel-Stack, das Tunnel-Deployment, dein Deployment                                                                                                                              |
| **Proxy**               | Anthropics Routing-Komponente. Terminiert das innere TLS, validiert, dass Upstream-IPs innerhalb eines erlaubten Bereichs liegen, und leitet jede Anfrage anhand des Hostnamens an einen Upstream-MCP-Server weiter.                                                                                                                                                                                  | `mcp-proxy` (Image-Name, Compose-Service-Name und Helm-Container-Name), `mcp-gateway` (containerinterner Konfigurationspfad `/etc/mcp-gateway/config.yaml` und Helm-Werte-Präfix `gateway.config.*`) |
| **cloudflared**         | Cloudflares Open-Source-Tunnel-Connector. Initiiert die ausschließlich ausgehenden Verbindungen von deinem Netzwerk zum Tunnel-Edge und transportiert verschlüsselten Datenverkehr zwischen dem Edge und dem Proxy. Steht in keinem Zusammenhang mit einem Managed Agent.                                                                                                                             | der ausgehende Connector, der Tunnel-Connector                                                                                                                                                       |
| **Setup-Komponente**    | Das `setup`-Binary, das im `mcp-proxy`-Image ausgeliefert wird. Bei programmatischem Zugriff authentifiziert es sich über Workload Identity Federation, ruft das Tunnel-Token ab, erzeugt eine CA und ein Serverzertifikat und registriert die CA bei Anthropic. Stellt außerdem `renew-cert` bereit.                                                                                                 | Setup-Job (der Helm-Pre-Install-Hook), `setup`-Service (das Compose-Profil), Setup-Hook, Setup-Binary, Setup-CLI                                                                                     |
| **Tunnel-Edge**         | Die Cloudflare-Edge-Server, zu denen cloudflared eine ausgehende Verbindung aufbaut (IP-Bereiche `198.41.192.0/19` und `2606:4700:a0::/44`, Port 7844 TCP und UDP). Der darüber laufende Tunnel wird von Anthropic bereitgestellt und kontrolliert; Cloudflare betreibt das zugrunde liegende Netzwerk.                                                                                               | der Edge, der von Anthropic betriebene Tunnel-Edge                                                                                                                                                   |
| **Inneres TLS**         | Ein zweiter TLS-Handshake („inner TLS“), der innerhalb des Klartext-WebSocket-Streams des Tunnels zwischen Anthropics Backend und deinem Proxy durchgeführt wird. Der Proxy präsentiert ein Serverzertifikat, das von einer CA signiert ist, die du auf dem Tunnel registriert hast. Da nur du den privaten Schlüssel besitzt, kann der Transportanbieter weder Anfrage- noch Antwort-Payloads lesen. | der innere TLS-Handshake                                                                                                                                                                             |
| **Upstream-MCP-Server** | Ein MCP-Server in deinem privaten Netzwerk, an den der Proxy weiterleitet. Jeder Upstream wird als eine Subdomain unter deiner Tunnel-Domain bereitgestellt.                                                                                                                                                                                                                                          | Upstream, gerouteter MCP-Server, getunnelter MCP-Server                                                                                                                                              |

## Bereitstellung von Anmeldedaten

Der Tunnel-Stack benötigt zur Laufzeit zwei Anmeldedaten: das **Tunnel-Token**, das die ausgehende Verbindung von cloudflared authentifiziert, und ein **Serverzertifikat**, das von einer auf dem Tunnel registrierten CA signiert ist und das der Proxy während des inneren TLS-Handshakes präsentiert. Es gibt zwei Möglichkeiten, diese bereitzustellen, die in diesem Leitfaden durchgehend als Tab-Paar dargestellt werden.

| Modus                        | Wie die Anmeldedaten den Stack erreichen                                                                                                                                                                                                                                                                                                                                                                     | Helm-Chart-Bezeichnung                              | Tab-Beschriftung                  |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- | --------------------------------- |
| **Programmatischer Zugriff** | Die Setup-Komponente authentifiziert sich über [Workload Identity Federation](https://platform.claude.com/docs/de/manage-claude/workload-identity-federation) bei der Tunnels API, ruft das Tunnel-Token ab, erzeugt lokal eine CA und ein Serverzertifikat und registriert die CA. Kein langlebiges Secret wird von Hand kopiert. Erfordert eine Federation-Regel mit dem Scope `workspace:manage_tunnels`. | Managed-Modus (`setup.enabled: true`, der Standard) | **Mit programmatischem Zugriff**  |
| **Manuell**                  | Du kopierst das Tunnel-Token aus der Claude Console, erzeugst selbst eine CA und ein Serverzertifikat (zum Beispiel mit `openssl`), registrierst die CA in der Console und übergibst das Token und das Zertifikat als Secrets an den Stack. Es läuft keine Setup-Komponente.                                                                                                                                 | External-Modus (`setup.enabled: false`)             | **Ohne programmatischen Zugriff** |

Diese Modi werden in den Deployment-Leitfäden auch als **der programmatische Ablauf** und **der manuelle Ablauf** bezeichnet.

## Verbindungsmodell

In einem Tunnel wirken zwei Richtungen, und sie zeigen in entgegengesetzte Richtungen:

* **Verbindungsrichtung:** cloudflared baut eine **ausgehende** Verbindung von deinem Netzwerk zum Tunnel-Edge auf. Deine Firewall sieht nur Egress auf Port 7844; es wird kein eingehender Port geöffnet.
* **Anfragerichtung:** Sobald diese Verbindung hergestellt ist, laufen MCP-Anfragen darüber **von Anthropic in Richtung deines Netzwerks**, durch cloudflared zum Proxy und weiter zum Upstream-MCP-Server.

Die Formulierung „outbound-only“ (ausschließlich ausgehend) beschreibt die Verbindung, nicht die darüber transportierten Anfragen.

Das innere TLS erstreckt sich zwischen Anthropics Backend und deinem Proxy. cloudflared und der Tunnel-Edge liegen auf der Leitung dazwischen, sehen aber nur Chiffretext; der Proxy ist die erste Stelle innerhalb deines Netzwerks, an der MCP-Anfrage-Payloads lesbar sind.

```mermaid
sequenceDiagram
  accTitle: How a request reaches an MCP server through a tunnel
  accDescr: cloudflared, the proxy, and the upstream MCP server run inside your network. cloudflared opens an outbound connection on port 7844 to the tunnel edge on the Cloudflare network. The connection stays open, and no inbound port is opened. The Anthropic backend sends an MCP request to the tunnel edge over outer mTLS. The edge carries it over the open connection to cloudflared, which passes it to the proxy on localhost:8080. Inner TLS spans the Anthropic backend to the proxy and terminates at the proxy. The proxy routes the request by hostname to the upstream MCP server. The response returns along the same path, reversed.
  participant A as Anthropic<br/>backend
  participant E as Tunnel edge<br/>(Cloudflare network)
  participant C as cloudflared
  participant P as Proxy
  participant M as Upstream<br/>MCP server

  note over C,M: Inside your network

  C->>E: 1. Outbound connection (port 7844)
  note over C,E: Connection stays open.<br/>No inbound port is opened.

  A->>E: 2. MCP request (outer mTLS)
  E->>C: carried over the open connection
  C->>P: localhost:8080
  note over A,P: Inner TLS spans Anthropic backend to proxy.<br/>Terminates at the proxy.
  P->>M: 3. Route by hostname
  M-->>P: response
  P-->>A: response (same path, reversed)
```

## Siehe auch

* [MCP-Tunnel](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/overview) für das Sicherheitsmodell und die Tabelle zur geteilten Verantwortung.
* [MCP-Tunnel-Referenz](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/reference) für Proxy-Konfigurationsfelder, Zertifikatsanforderungen und die Setup-Komponente.