MCP-Tunnel befinden sich in der Research Preview. Zugang anfordern, um sie auszuprobieren.
Dieser Schnellstart führt dich von null bis zu dem Punkt, an dem Claude einen privaten MCP-Server über einen Tunnel aufruft. Er verwendet Docker Compose mit manueller Bereitstellung von Anmeldedaten, was der kürzeste Weg für lokales Testen ist. Für Produktions-Deployments siehe Deployment mit Helm oder Deployment mit Docker Compose.
Einen Tunnel-Stack aus zwei Containern (dem Proxy und cloudflared) sowie einen Beispiel-MCP-Server, der daneben läuft. Wenn alles läuft, ist der Beispielserver von Claude aus unter https://echo.<your-tunnel-domain>/mcp erreichbar, obwohl nichts auf einem öffentlichen Port lauscht.
openssl-Binary muss in deinem PATH liegen).Einen Tunnel erstellen
Gehe in der Seitenleiste der Claude Console zu Manage > MCP tunnels und klicke auf New tunnel. Gib ihm einen Namen. Lass Set up programmatic access deaktiviert; dieser Schnellstart verwendet die manuelle Bereitstellung von Anmeldedaten.
Öffne den Tunnel, nachdem er erstellt wurde. Kopiere zwei Werte aus dem Abschnitt Connection:
abcd1234.tunnel.anthropic.com)Das Deployment-Verzeichnis einrichten
Eine CA und ein Serverzertifikat generieren
Der Proxy terminiert inneres TLS mit einem Zertifikat, das von einer CA signiert ist, die du kontrollierst. Generiere beides:
Den Beispiel-MCP-Server schreiben
Die Proxy-Konfiguration und Compose-Datei schreiben
Starten
Von Claude aus aufrufen
Gehe in der Console zu Managed Agents > Sessions und erstelle eine Session. Wähle im Agent-Picker Create new agent, gib dem Agent einen Namen und behalte das vorausgefüllte Modell bei. Klicke auf + MCP Server, wähle deinen Tunnel aus, setze Subdomain auf echo und Path auf mcp. Dann frage:
Use the hello tool to greet tunnel.
Du solltest einen Tool-Aufruf gefolgt von seinem Ergebnis sehen.
Der Tunnel ist Ende-zu-Ende verifiziert. Um deinen eigenen MCP-Server einzubinden, füge ihn zu docker-compose.yaml hinzu (oder führe ihn im selben Docker-Netzwerk aus), füge eine Route dafür in config/mcp-proxy.yaml hinzu und starte dann den Proxy neu (docker compose restart mcp-proxy).
Für Produktions-Deployments:
Gehärtetes Single-Host-Deployment, mit oder ohne programmatischen Zugriff.
Kubernetes-Deployment mit automatischer Verwaltung von Anmeldedaten.
Was this page helpful?
Klicke zurück in der Console auf der Tunnel-Detailseite auf Add certificate und lade data/ca.crt hoch (oder füge den Inhalt ein). Der Tunnel-Status wechselt zu Active.
Du solltest eine route configured-Zeile für echo und vier Registered tunnel connection-Zeilen sehen. Die Container brauchen ein paar Sekunden zum Starten; führe die Log-Befehle erneut aus, wenn sie leer zurückkommen.