Tunnel MCP sedang dalam pratinjau riset. Minta akses untuk mencobanya.
Quickstart ini memandu Anda dari nol hingga Claude memanggil server MCP privat melalui sebuah tunnel. Panduan ini menggunakan Docker Compose dengan penyediaan kredensial manual, yang merupakan jalur tersingkat untuk pengujian lokal. Untuk deployment produksi, lihat Deploy dengan Helm atau Deploy dengan Docker Compose.
Sebuah tunnel stack dua kontainer (proxy dan cloudflared) ditambah sebuah server MCP contoh yang berjalan berdampingan dengannya. Ketika semuanya berjalan, server contoh tersebut dapat dijangkau dari Claude di https://echo.<your-tunnel-domain>/mcp meskipun tidak ada yang mendengarkan pada port publik.
openssl harus ada di PATH Anda).Buat tunnel
Di sidebar Claude Console, buka Manage > MCP tunnels dan klik New tunnel. Beri nama. Biarkan Set up programmatic access nonaktif; quickstart ini menggunakan penyediaan kredensial manual.
Setelah dibuat, buka tunnel tersebut. Salin dua nilai dari bagian Connection:
abcd1234.tunnel.anthropic.com)Siapkan direktori deployment
Buat CA dan sertifikat server
Proxy mengakhiri inner TLS menggunakan sertifikat yang ditandatangani oleh CA yang Anda kendalikan. Buat keduanya:
Kembali ke Console, pada halaman detail tunnel, klik Add certificate dan unggah data/ca.crt (atau tempel isinya). Status tunnel berubah menjadi Active.
Tulis server MCP contoh
Tulis konfigurasi proxy dan file compose
Jalankan
Anda akan melihat satu baris route configured untuk echo dan empat baris Registered tunnel connection. Kontainer membutuhkan beberapa detik untuk mulai; jalankan kembali perintah log jika hasilnya kosong.
Panggil dari Claude
Di Console, buka Managed Agents > Sessions dan buat sebuah session. Di pemilih agent pilih Create new agent, beri nama agent tersebut, dan pertahankan model yang sudah terisi. Klik + MCP Server, pilih tunnel Anda, atur Subdomain ke echo dan Path ke mcp. Kemudian minta:
Use the hello tool to greet tunnel.
Anda akan melihat pemanggilan alat diikuti oleh hasilnya.
Tunnel telah diverifikasi secara end-to-end. Untuk mengganti dengan server MCP Anda sendiri, tambahkan ke docker-compose.yaml (atau jalankan di jaringan Docker yang sama), tambahkan route untuknya di config/mcp-proxy.yaml, lalu restart proxy (docker compose restart mcp-proxy).
Untuk deployment produksi:
Deployment single-host yang diperkuat, dengan atau tanpa akses programatik.
Deployment Kubernetes dengan manajemen kredensial otomatis.
Was this page helpful?