Tunnel MCP

"MCP tunnels" (tunnel MCP) memungkinkan Anda menghubungkan Claude ke server Model Context Protocol, atau MCP, yang berjalan di dalam jaringan privat Anda. Lalu lintas mengalir melalui koneksi keluar saja (outbound-only), sehingga Anda tidak perlu membuka port firewall masuk, mengekspos layanan ke internet publik, atau memasukkan rentang IP Anthropic ke daftar izin pada origin Anda.

Untuk kelayakan Zero Data Retention dan HIPAA BAA, lihat API dan retensi data.



Cara kerjanya

Tunnel stack terdiri dari dua komponen yang berjalan di dalam jaringan Anda:

• cloudflared: Konektor tunnel open-source dari Cloudflare. Komponen ini memulai koneksi keluar saja ke tunnel edge dan membawa lalu lintas terenkripsi dari Anthropic ke proxy Anda.
• Proxy: Komponen routing dari Anthropic. Komponen ini mengakhiri inner TLS, memvalidasi bahwa IP upstream berada dalam rentang yang diizinkan, dan merutekan setiap permintaan ke server MCP upstream yang benar berdasarkan hostname.

Setiap server MCP yang Anda ekspos mendapatkan hostname di bawah domain tunnel Anda (misalnya, docs.<your-tunnel-domain>). Anda melampirkan hostname ini ke sesi Managed Agent di Claude Console, atau meneruskannya ke Messages API melalui konektor MCP.



Prasyarat

Sebelum melakukan deployment, pastikan Anda memiliki:

• Target deployment: klaster Kubernetes, atau VM dengan Docker dan Docker Compose.
• Sebuah tunnel. Buat satu di Claude Console (lihat Membuat tunnel) atau melalui API; setup hook pada Helm chart juga dapat membuatnya untuk Anda selama instalasi.
• Cara bagi stack Anda untuk melakukan autentikasi ke Tunnels API. Pilih salah satu:
  • Akses programatik (direkomendasikan). Siapkan Workload Identity Federation saat Anda membuat tunnel. Stack Anda mencetak token API berumur pendek dari penyedia identitas Anda, mengambil token tunnel, serta menghasilkan dan mendaftarkan sertifikat CA secara otomatis. Memerlukan izin untuk mengelola aturan federasi, issuer OIDC yang terdaftar, dan aturan federasi dengan scope workspace:manage_tunnels.
  • Manual. Sediakan kredensial statis sendiri: token tunnel dari Console dan sertifikat server yang ditandatangani oleh CA yang Anda daftarkan di sana. Lihat Mendapatkan detail koneksi dan Menambahkan sertifikat CA.
• Satu atau lebih server MCP yang berjalan di jaringan privat Anda. Lihat Server MCP jarak jauh untuk contoh.
• Konektivitas keluar seperti yang tercantum di bawah Persyaratan jaringan.



Persyaratan jaringan



Model keamanan



Lapisan keamanan

Tiga lapisan independen melindungi setiap permintaan:

Transport tunnel berjalan di jaringan Cloudflare. Karena proxy mengakhiri inner TLS menggunakan sertifikat yang hanya Anda miliki, Cloudflare tidak dapat membaca payload permintaan atau respons. Anthropic tidak terhubung ke tunnel sampai sertifikat CA terdaftar, sehingga payload selalu terenkripsi saat melintasi jaringan Cloudflare. Cloudflare memang menerima metadata koneksi; lihat Apa yang dapat diamati oleh penyedia transport.



Model tanggung jawab bersama



Apa yang dapat diamati oleh penyedia transport

Cloudflare menyediakan transport keluar. Cloudflare tidak dapat membaca payload permintaan atau respons MCP, tetapi menerima metadata koneksi berikut:

• alamat IP egress dari host yang menjalankan cloudflared
• fingerprint host cloudflared
• waktu koneksi dan volume byte
• subdomain *.tunnel.anthropic.com yang ditetapkan untuk tunnel Anda

Perjanjian Anthropic dengan Cloudflare membatasi penggunaan telemetri ini oleh Cloudflare. Cloudflare bertindak sebagai subprosesor untuk research preview ini.



Melakukan deployment tunnel

Jika Anda baru mengenal MCP tunnels, mulailah dengan quickstart untuk mendapatkan tunnel yang berfungsi secara lokal sebelum mengonfigurasi deployment produksi.

Memilih di antara keduanya:

• Target deployment
  • Helm saat melakukan deployment ke Kubernetes.
  • Docker Compose untuk satu host atau pengujian lokal.
• Autentikasi untuk setup
  • Akses programatik (melalui Workload Identity Federation) saat Anda memiliki penyedia identitas OIDC seperti klaster Kubernetes, cloud IAM, atau SPIFFE.
  • Kredensial manual saat Anda tidak memilikinya, atau saat Anda sedang melakukan pengujian.



Menggunakan server MCP yang di-tunnel

Setelah tunnel Anda aktif (memiliki sertifikat CA aktif dan tunnel stack Anda terhubung), server MCP upstream dapat dijangkau dari Claude Managed Agents dan Messages API.

Dalam kedua kasus tersebut, tunnel membawa lalu lintas terenkripsi ke server MCP Anda tetapi tidak melakukan autentikasi ke server tersebut. Jika server MCP upstream memerlukan autentikasinya sendiri (OAuth, bearer token), sediakan dengan cara yang sama seperti untuk server MCP lainnya; hal ini independen dari tunnel.



Managed Agents (Console)

1. Di Managed Agents > Sessions, buat sesi dan pilih Create new agent agar Anda dapat mengedit daftar server MCP.
2. Klik + MCP Server dan buka dropdown. Tunnel di workspace sesi yang memiliki setidaknya satu sertifikat aktif muncul di bagian atas daftar, di atas katalog konektor publik.
3. Pilih tunnel dan sediakan Subdomain yang dirutekan proxy Anda ke server MCP tertentu, serta Path yang diharapkan oleh server MCP upstream. Baris Resolves to menunjukkan URL yang tepat.



Messages API

Teruskan URL server MCP upstream dalam array mcp_servers, dengan cara yang sama seperti server MCP jarak jauh lainnya. Body permintaan dan header anthropic-beta mengikuti format standar konektor MCP; hanya url yang spesifik untuk tunnel. Contoh berikut menggunakan header beta mcp-client dari konektor MCP, yang terpisah dari beta mcp-tunnels yang digunakan oleh Tunnels API. Gunakan kunci API untuk workspace tempat tunnel dibuat (Console Settings > API keys).

Host pada URL adalah <subdomain>.<your-tunnel-domain>. Path bergantung pada server MCP upstream Anda, bukan pada tunnel: transport streamable-http dari FastMCP melayani di /mcp, dan server lain mungkin menggunakan / atau path kustom (periksa dokumentasi server tersebut). Proxy meneruskan path tanpa mengubahnya.

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Use the hello tool to greet tunnel."}],
    mcp_servers=[
        {
            "type": "url",
            "url": "https://echo.YOUR_TUNNEL_DOMAIN_HERE/mcp",
            "name": "echo",
        }
    ],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "echo"}],
    betas=["mcp-client-2025-11-20"],
)

print(response)

Untuk autentikasi ke server MCP upstream (authorization_token) dan opsi mcp_servers lainnya, lihat konektor MCP.



Langkah selanjutnya