Pular para o conteúdo principal

Rede MCP

Verifique o acesso à rede em duas direções: entrada, do seu cliente Model Context Protocol (MCP) para o seu workspace, e saída, do seu workspace para servidores MCP externos. Para login e identidade, consulte Autenticação MCP.

Cliente para workspace (inbound)​

As solicitações de MCP devem ser permitidas pelos controles de rede de entrada do seu workspace. A tabela a seguir mostra o que permitir para cada tipo de cliente e controle de entrada:

Entrada baseada em contexto (recomendada)

Front-end Private Serviço Connect com acesso público desabilitado

O cliente MCP é executado em um serviço hospedado, como o ChatGPT ou um conector do Claude

Adicione o ChatGPT ou o Claude como plataforma parceira. O Databricks mantém os intervalos de IP atualizados.

Clientes hospedados não podem conectar. Mantenha o acesso público habilitado e restrinja-o com ingress baseado em contexto.

O cliente MCP está em execução no seu computador, como Claude Code, Codex CLI ou Cursor

Permita o IP de saída público da sua rede.

Conecte através do private endpoint.

Entrada baseada em contexto (recomendada)

Front-end Private Serviço Connect com acesso público desabilitado

O cliente MCP é executado em um serviço hospedado, como o ChatGPT ou um conector do Claude

Adicione o ChatGPT ou o Claude como plataforma parceira. O Databricks mantém os intervalos de IP atualizados.

Clientes hospedados não podem conectar. Mantenha o acesso público habilitado e restrinja-o com ingress baseado em contexto.

O cliente MCP está em execução no seu computador, como Claude Code, Codex CLI ou Cursor

Permita o IP de saída público da sua rede.

Conecte através do private endpoint.

Para clientes hospedados, o login do navegador vem da sua rede, enquanto as chamadas MCP vêm dos servidores do provedor. Ambos devem ser permitidos. Por exemplo, fazer login com sucesso na sua VPN corporativa não significa que o ChatGPT pode acessar o seu MCP.

Permitir clientes com ingresso baseado em contexto (recomendado)​

Para proteger o acesso à rede de entrada do seu workspace enquanto permite que clientes MCP se conectem, a Databricks recomenda usar controles de entrada baseados em contexto:

  • Clientes hospedados : adicione ChatGPT ou Claude como uma plataforma parceira em uma política de entrada baseada em contexto de workspace. O Databricks sincroniza os intervalos de IP publicados do provedor, para que você não precise mantê-los por conta própria. Consulte Permitir plataformas parceiras em políticas de entrada baseadas em contexto.
  • Clientes no seu computador : adicione uma regra que permita o IP de saída público da sua rede. Se o tráfego passar por uma VPN corporativa ou proxy, use o IP de saída dessa rede. Peça ao seu administrador de rede.

No modo de imposição, o ingresso baseado em contexto bloqueia solicitações que não correspondem a uma regra de permissão. As solicitações permitidas ainda devem ser autenticadas e são executadas com as permissões do usuário ou service principal autenticado que as fez.

Front-end Private serviço Connect​

Se o seu Workspace usar front-end Private serviço Connect com o acesso público desabilitado, os clientes MCP no seu computador podem se conectar, mas os MCPs em clientes hospedados, como conectores do ChatGPT e Claude, estão bloqueados.

Para permitir esses clientes e ainda limitar o acesso público, habilite o acesso público e restrinja-o com uma política de entrada baseada em contexto que os permite como plataformas parceiras.

Listas de acesso IP do Workspace​

Se seu workspace ainda impõe listas de acesso IP do workspace, elas são avaliadas juntamente com a entrada baseada em contexto e uma solicitação deve ser permitida por ambos. Uma regra de plataforma de parceiro não é suficiente enquanto uma lista de acesso IP bloquear os IPs do provedor. Migre suas listas de acesso IP para a entrada baseada em contexto e desative sua aplicação. Consulte Migrar listas de acesso IP do workspace para entrada baseada em contexto.

nota

Se você não puder migrar ainda, adicione os intervalos de IP publicados pelo provedor à sua lista de acesso IP. Veja os IPs de saída do Claude e os IPs de saída do ChatGPT. Para clientes no seu computador, adicione o IP de saída público da sua rede. Os provedores alteram seus intervalos de IP, portanto, atualize a lista quando eles o fizerem.

Listas de acesso de IP da account​

Listas de acesso de IP da account aplicam-se ao console de account e ao acesso à API de account, como um administrador criando um aplicativo OAuth. Elas não se aplicam a chamadas MCP para seu workspace.

Workspace para servidor MCP (saída)​

As chamadas para provedores MCP externos por meio do Unity Gateway usam o plano de compute Serverless do Workspace. Isso se aplica a servidores externos registrados e MCPs fornecidos pelo Databricks para serviços externos. Controle de saída Serverless determina quais destinos a compute Serverless pode alcançar.

Servidores MCP na internet pública​

Se o controle de saída serverless para seu workspace usar Acesso restrito , adicione o nome de domínio totalmente qualificado (FQDN) do servidor aos Domínios permitidos . Comece com o host na conexão do Unity Catalog do MCP. Consulte Gerenciar políticas de rede para controle de saída serverless.

  • Uma conexão do Unity Catalog não permite automaticamente seu destino.
  • Com Acesso total , o compute serverless pode alcançar destinos na internet por default, mas domínios explicitamente bloqueados permanecem negados. Por exemplo, bloquear mcp.example.com impede chamadas para esse servidor MCP. Solicite a um administrador que revise os destinos bloqueados.
  • Para testar o tráfego do MCP no modo dry-run, selecione Todos os produtos . As opções Databricks SQL e AI servindo modelo não colocam o tráfego do MCP no modo dry-run.

Servidores MCP na sua rede cloud​

O Private Service Connect não é suportado para as conexões HTTP que suportam MCPs. Permita IPs de saída serverless do Databricks no firewall do servidor. Veja Configurar um firewall para acesso serverless.

Solucionar problemas de solicitações bloqueadas​

Use as tabelas de sistema de acesso à rede para descobrir qual regra bloqueou uma solicitação:

Causas comuns:

  • O login funciona, mas as chamadas MCP falham de um cliente hospedado : Os intervalos de IP do provedor não são permitidos. Adicione o provedor como uma plataforma parceira ou adicione seus intervalos de IP à sua lista de acesso IP.
  • Uma regra de plataforma de parceiro está em vigor, mas as solicitações ainda estão bloqueadas : as listas de acesso IP do workspace ainda são aplicadas e não incluem os IPs do provedor. Veja Listas de acesso IP do workspace.
  • Um cliente hospedado não pode acessar um workspace com front-end Private Service Connect : o acesso público está desativado. Habilite o acesso público e restrinja-o com entrada baseada em contexto.
  • As chamadas para um servidor MCP externo falham : O domínio do servidor não está em Domínios permitidos ou está explicitamente bloqueado.