Rete MCP

Controlla l'accesso alla rete in due direzioni: in entrata dal client Model Context Protocol (MCP) al tuo workspace, e in uscita, dal tuo workspace verso server MCP esterni. Per l'accesso e l'identità, vedi autenticazione MCP.

Client a workspace (in enbound)

Le richieste MCP devono essere consentite dai controlli di rete in entrata del tuo workspace. La tabella seguente mostra cosa consentire per ogni tipo di client e controllo in entrata:

Ingresso basato sul contesto (consigliato) Front-end collegamento privato con accesso pubblico disabilitato
Il client MCP funziona in un servizio ospitato, come ChatGPT o un connettore Claude Aggiungi ChatGPT o Claude come piattaforma partner. Azure Databricks mantiene aggiornati gli intervalli IP. I client ospitati non possono connettersi. Mantieni abilitato l'accesso pubblico e limitalo con ingressi basati sul contesto.
Il client MCP funziona sul tuo computer, come Claude Code, Codex CLI o Cursor Consenti l'IP pubblico in uscita della tua rete. Connettiti tramite l'endpoint privato.

Per i client ospitati, l'accesso al browser avviene dalla tua rete, mentre le chiamate MCP provengono dai server del provider. Entrambi devono essere ammessi. Ad esempio, accedere con successo dalla tua VPN aziendale non significa che ChatGPT possa raggiungere il tuo MCP.

Per garantire l'accesso alla rete in entrata al tuo workspace consentendo comunque la connessione ai client MCP, Azure Databricks consiglia di utilizzare controlli di ingresso basati sul contesto:

  • Client ospitati: Aggiungi ChatGPT o Claude come piattaforma partner in una politica di ingresso basata sul contesto dello spazio di lavoro. Azure Databricks sincronizza gli intervalli IP pubblicati dal provider, quindi non li gestisci tu. Vedi Consentire le piattaforme partner nelle politiche di ingresso basate sul contesto.
  • Client sul tuo computer: Aggiungi una regola che consenta l'IP pubblico in uscita della tua rete. Se il traffico passa attraverso una VPN aziendale o un proxy, usa l'IP in uscita di quella rete. Chiedi al tuo amministratore di rete.

In modalità forzata, l'ingresso basato sul contesto blocca le richieste che non corrispondono a una regola di permesso. Le richieste consentite devono comunque essere autenticate e vengono eseguite con i permessi dell'utente autenticato o del principale servizio che le ha create.

Se il tuo spazio di lavoro utilizza il front-end collegamento privato con accesso pubblico disabilitato, i client MCP sul tuo computer possono connettersi, ma gli MCP nei client ospitati, come i connettori ChatGPT e Claude, sono bloccati.

Per consentire questi client limitando comunque l'accesso pubblico, abilitare l'accesso pubblico e limitarlo con una policy di ingresso basata sul contesto che li consenta come piattaforme partner.

Liste di accesso IP dello spazio di lavoro

Se il tuo workspace fa ancora rispettare le liste di accesso IP dello spazio di lavoro, queste vengono valutate insieme all'ingresso basato sul contesto, e una richiesta deve essere consentita da entrambi. Una regola della piattaforma partner non è sufficiente mentre una lista di accesso IP blocca gli IP del provider. Migra le tue liste di accesso IP in ingressi basati sul contesto e disattiva la loro applicazione. Vedi Migra le liste di accesso IP dello spazio di lavoro verso l'ingresso basato sul contesto.

Note

Se non puoi ancora migrare, aggiungi gli intervalli IP pubblicati dal provider alla tua lista di accesso IP. Vedi gli IP in uscita di Claude e quelli in uscita di ChatGPT. Per i clienti sul tuo computer, aggiungi l'IP pubblico in uscita della tua rete. I provider cambiano i loro intervalli IP, quindi aggiorna la lista quando lo fanno.

Elenchi di accesso IP dell'account

Le liste di accesso IP degli account si applicano alla console account e all'accesso all'API dell'account, come un amministratore che crea un'app OAuth. Non si applicano alle chiamate MCP al tuo spazio di lavoro.

Workspace a server MCP (in uscita)

Le chiamate a fornitori MCP esterni tramite Unity Gateway utilizzano il piano di calcolo serverless dello spazio di lavoro. Questo vale per server esterni registrati e MCP forniti da Databricks per servizi esterni. Il controllo dell'uscita serverless determina quali destinazioni può raggiungere il calcolo serverless.

Server MCP su internet pubblico

Se il controllo di uscita serverless per il tuo workspace utilizza accesso restrito, aggiungi il nome di dominio completamente qualificato (FQDN) del server ai domini consentiti. Inizia con l'host sulla connessione Unity Catalog dell'MCP. Vedere Gestire i criteri di rete per il controllo in uscita serverless.

  • Una connessione Unity Catalog non permette automaticamente la destinazione.
  • Con l'accesso completo, il calcolo serverless può raggiungere le destinazioni internet di default, ma i domini esplicitamente bloccati rimangono negati. Ad esempio, bloccare mcp.example.com impedisce le chiamate a quel server MCP. Chiedi a un amministratore di controllare le destinazioni bloccate.
  • Per testare il traffico MCP in modalità di prova a secco, seleziona Tutti i prodotti. Le opzioni di server modelliSQL e AI di Databricks non fanno fare un dry run al traffico MCP.

Server MCP nella tua rete cloud

Per raggiungere un server MCP nella tua rete cloud, scegli come il calcolo serverless di Azure Databricks si collega ad esso:

  • Endpoint privato: Usa collegamento privato per mantenere il traffico su una connessione privata. Un account admin aggiunge una regola di endpoint privato per il dominio del server a una configurazione di connettività di rete (NCC) collegata al tuo workspace. Il tuo amministratore cloud approva la connessione endpoint. Vedi Configura connettività privata.
  • Endpoint pubblico con firewall: Configura il firewall del server per consentire ad Azure Databricks IP outbound serverless per il cloud e la regione del tuo workspace. Questi IP sono condivisi tra i clienti Azure Databricks, quindi mantenete l'autenticazione attiva sul server. Vedi Configura l'accesso ad altre risorse utilizzando indirizzi IP in uscita.

Il controllo di uscita serverless consente automaticamente i domini nelle regole degli endpoint privati, quindi non è necessario aggiungerli ai domini Permessi. Per un endpoint pubblico, segui i server MCP su internet pubblico.

Risoluzione delle richieste bloccate

Usa le tabelle del sistema di accesso alla rete per trovare quale regola ha bloccato una richiesta:

Cause comuni:

  • Il login funziona, ma le chiamate MCP falliscono da un client ospitato: le fasce IP del provider non sono consentite. Aggiungi il provider come piattaforma partner, oppure aggiungi i suoi intervalli IP alla tua lista di accesso IP.
  • È in vigore una regola per la piattaforma partner, ma le richieste sono ancora bloccate: le liste di accesso agli IP dello spazio di lavoro sono ancora applicate e non includono gli IP del provider. Vedi Liste di accesso IP al Workspace.
  • Un client ospitato non può raggiungere uno spazio di lavoro con front-end collegamento privato: l'accesso pubblico è disabilitato. Abilita l'accesso pubblico e limitalo con ingressi basati sul contesto.
  • Le chiamate a un server MCP esterno falliscono: il dominio del server non è nei domini Permessi, oppure è esplicitamente bloccato.