--- title: Architettura e componenti url: https://platform.claude.com/docs/it/agents-and-tools/mcp-tunnels/concepts description: Nomi canonici per le parti di un deployment di tunnel MCP, le due modalità di provisioning delle credenziali e il modello di connessione. --- I "MCP tunnels" (tunnel MCP) sono in "research preview" (anteprima di ricerca). [Richiedi l'accesso](https://claude.com/form/mcp-tunnels) per provarli. Questa pagina definisce i termini utilizzati in tutta la documentazione dei [tunnel MCP](https://platform.claude.com/docs/it/agents-and-tools/mcp-tunnels/overview). Diversi componenti compaiono con nomi differenti nei file di configurazione, nelle immagini dei container e nel testo; le tabelle seguenti forniscono un nome canonico per ciascuno ed elencano gli alias che potresti incontrare. ## Componenti | Termine | Definizione | Compare anche come | | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Tunnel stack** (stack del tunnel) | I due container che esegui all'interno della tua rete per collegarti a un tunnel: il proxy e cloudflared. Uno stack serve un tunnel e può essere replicato su più host per la disponibilità. Con l'accesso programmatico, il componente di setup viene eseguito insieme allo stack per effettuare il provisioning delle credenziali. | lo stack, lo stack del tunnel MCP, il deployment del tunnel, il tuo deployment | | **Proxy** | Il componente di routing di Anthropic. Termina il TLS interno, verifica che gli IP upstream rientrino in un intervallo consentito e instrada ogni richiesta verso un server MCP upstream in base all'hostname. | `mcp-proxy` (nome dell'immagine, nome del servizio Compose e nome del container Helm), `mcp-gateway` (percorso di configurazione interno al container `/etc/mcp-gateway/config.yaml` e prefisso dei valori Helm `gateway.config.*`) | | **cloudflared** | Il connettore di tunnel open-source di Cloudflare. Avvia le connessioni solo in uscita dalla tua rete verso l'edge del tunnel e trasporta il traffico cifrato tra l'edge e il proxy. Non è correlato a un Managed Agent. | il connettore in uscita, il connettore del tunnel | | **Setup component** (componente di setup) | Il binario `setup`, distribuito all'interno dell'immagine `mcp-proxy`. Con l'accesso programmatico si autentica tramite Workload Identity Federation, recupera il token del tunnel, genera una CA e un certificato server e registra la CA presso Anthropic. Fornisce anche `renew-cert`. | setup Job (l'hook pre-install di Helm), servizio `setup` (il profilo Compose), setup hook, binario setup, CLI setup | | **Tunnel edge** (edge del tunnel) | I server edge di Cloudflare verso cui cloudflared si connette in uscita (intervalli IP `198.41.192.0/19` e `2606:4700:a0::/44`, porta 7844 TCP e UDP). Il tunnel che vi transita è sottoposto a provisioning e controllato da Anthropic; Cloudflare gestisce la rete sottostante. | l'edge, l'edge del tunnel gestito da Anthropic | | **Inner TLS** (TLS interno) | Un secondo handshake TLS trasportato all'interno dello stream WebSocket in chiaro del tunnel, tra il backend di Anthropic e il tuo proxy. Il proxy presenta un certificato server firmato da una CA che hai registrato sul tunnel. Poiché solo tu possiedi la chiave privata, il fornitore del trasporto non può leggere i payload delle richieste o delle risposte. | l'handshake TLS interno | | **Upstream MCP server** (server MCP upstream) | Un server MCP in esecuzione nella tua rete privata verso cui il proxy instrada. Ogni upstream è esposto come un sottodominio sotto il dominio del tuo tunnel. | upstream, server MCP instradato, server MCP in tunnel | ## Provisioning delle credenziali Lo stack del tunnel necessita di due credenziali a runtime: il **tunnel token** (token del tunnel), che autentica la connessione in uscita di cloudflared, e un **server certificate** (certificato server) firmato da una CA registrata sul tunnel, che il proxy presenta durante l'handshake TLS interno. Esistono due modi per fornirle, presentati in tutta questa guida come una coppia di schede. | Modalità | Come le credenziali raggiungono lo stack | Nome nel chart Helm | Etichetta della scheda | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | ------------------------------------------------------------- | | **Accesso programmatico** | Il componente di setup si autentica presso la Tunnels API tramite [Workload Identity Federation](https://platform.claude.com/docs/it/manage-claude/workload-identity-federation), recupera il token del tunnel, genera localmente una CA e un certificato server e registra la CA. Nessun segreto a lunga durata viene copiato a mano. Richiede una regola di federazione con lo scope `workspace:manage_tunnels`. | Modalità Managed (`setup.enabled: true`, il valore predefinito) | **With programmatic access** (con accesso programmatico) | | **Manuale** | Copi il token del tunnel dalla Claude Console, generi tu stesso una CA e un certificato server (ad esempio con `openssl`), registri la CA nella Console e fornisci il token e il certificato allo stack come segreti. Nessun componente di setup viene eseguito. | Modalità External (`setup.enabled: false`) | **Without programmatic access** (senza accesso programmatico) | Queste modalità sono indicate anche come **il flusso programmatico** e **il flusso manuale** nelle guide al deployment. ## Modello di connessione In un tunnel sono in gioco due direzioni, e puntano in versi opposti: * **Direzione della connessione:** cloudflared si connette **in uscita** dalla tua rete verso l'edge del tunnel. Il tuo firewall vede solo traffico in uscita sulla porta 7844; nessuna porta in ingresso viene aperta. * **Direzione delle richieste:** una volta stabilita tale connessione, le richieste MCP viaggiano **da Anthropic verso la tua rete** attraverso di essa, passando per cloudflared fino al proxy e poi al server MCP upstream. L'espressione "outbound-only" (solo in uscita) descrive la connessione, non le richieste trasportate su di essa. Il TLS interno si estende tra il backend di Anthropic e il tuo proxy. cloudflared e l'edge del tunnel si trovano tra di essi sul collegamento ma vedono solo testo cifrato; il proxy è il primo punto all'interno della tua rete in cui i payload delle richieste MCP sono leggibili. ```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
backend participant E as Tunnel edge
(Cloudflare network) participant C as cloudflared participant P as Proxy participant M as Upstream
MCP server note over C,M: Inside your network C->>E: 1. Outbound connection (port 7844) note over C,E: Connection stays open.
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.
Terminates at the proxy. P->>M: 3. Route by hostname M-->>P: response P-->>A: response (same path, reversed) ``` ## Vedi anche * [Tunnel MCP](https://platform.claude.com/docs/it/agents-and-tools/mcp-tunnels/overview) per il modello di sicurezza e la tabella delle responsabilità condivise. * [Riferimento dei tunnel MCP](https://platform.claude.com/docs/it/agents-and-tools/mcp-tunnels/reference) per i campi di configurazione del proxy, i requisiti dei certificati e il componente di setup.