Autenticação MCP e redes

Para configuração passo a passo, use o guia do seu agente de programação ou o quickstart em Python. Use esta página para verificar os requisitos de autenticação compartilhada e o acesso à rede.

Sign in to Azure Databricks

Use sua conta de usuário do Azure Databricks para trabalhos interativos, ou um principal de serviço para um agente que roda sem supervisão. Siga a configuração para seu agente:

O usuário ou principal do serviço precisa de permissão para chamar o MCP. Se uma ferramenta pedir para você fazer login em um provedor externo, siga a configuração de serviços externos.

Para testes locais, MCPs fornecidos e registrados pelo Databricks, e endpoints de workspace legados, aceitam um token de acesso pessoal no Authorization: Bearer <token> cabeçalho. Mantenha os tokens fora do controle de versão. Servidores hospedados em aplicativos Databricks requerem OAuth e não aceitam tokens de acesso pessoal.

Configure um cliente OAuth personalizado

Use isso quando seu cliente precisar de seu próprio app OAuth. Os guias Claude Code e Codex incluem suas configurações específicas para cada cliente.

1. Obtenha a URL exata de redirecionamento do seu cliente, incluindo seu host, porta e caminho.

2. Faça um administrador de conta abrir as Configurações no console da conta, selecione conexões do aplicativo e clique em Adicionar conexão.

3. Insira um nome, adicione a URL de redirecionamento e selecione os escopos do seu servidor:

   Servidor	URL	Scope
   MCP fornecido ou registrado	https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>	ai-gateway
   Servidor em aplicativos Databricks	https://<app-url>/mcp	Inclua os escopos de autorização do usuário do app. Você também precisa USAR no app.
   Endpoint MCP do Workspace (legado)	A URL na página do servidor	Use os escopos listados para esse servidor.

4. Escolha se deseja gerar um segredo do cliente:

   • Cliente de desktop ou CLI (cliente público):Limpar Gere um segredo do cliente.
   • Cliente do lado do servidor que armazena segredos de forma segura (cliente confidencial): Deixe Gerar um segredo do cliente selecionado.

5. Salve a conexão e copie o ID do Cliente. Se você gerou um segredo do cliente, copie esse valor também.

6. Insira a URL do servidor e as credenciais do cliente no seu cliente MCP. Use HTTP Streamable, solicite o escopo do servidor e offline_access tokens de atualização, e faça login.

Veja Criar um app OAuth para opções de interface e CLI. As mudanças podem levar até 30 minutos para fazer efeito. Endpoints MCP do Azure Databricks não suportam registro dinâmico de clientes, então use um cliente que aceite um ID de cliente pré-configurado.

Acesso à rede

Verifique o acesso do cliente ao workspace e do workspace ao servidor externo.

Cliente para workspace

As requisições MCP devem ser permitidas pelos controles de rede de entrada do seu workspace. Se as listas de acesso de IP de workspace estiverem habilitadas, peça a um administrador para permitir que os endereços IP públicos de onde as solicitações se originam:

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 pela sua VPN corporativa não significa que o ChatGPT pode alcançar seu MCP.

Se sua organização também usa controles de entrada baseados em contexto, as requisições devem atender a essas políticas também. Listas de acesso a IP de conta se aplicam ao console da conta e ao acesso à API da conta, como um administrador criando um app OAuth.

Workspace para servidor MCP externo

Chamadas para provedores MCP externos via Unity Gateway utilizam o plano de computação serverless do workspace. Isso se aplica a servidores externos registrados e MCPs fornecidos pelo Databricks para serviços externos.

Se sua política de rede serverless usar acesso restrito, adicione o nome de domínio totalmente qualificado (FQDN) do servidor a domínios permitidos. Comece pelo host na conexão do Catálogo Unity do MCP. Verifique system.access.outbound_network se há destinos bloqueados adicionais. Veja Gerenciar políticas de rede e logs de rede de saída.

• Uma conexão do Unity Catalog não permite automaticamente seu destino.
• O acesso total é o modo da política de rede serverless para permitir conexões de internet de saída por padrão. Domínios explicitamente bloqueados continuam negados. Por exemplo, uma política que bloqueia mcp.example.com impede chamadas para esse servidor MCP. Peça a um administrador para revisar os destinos bloqueados da política.
• Para testar o tráfego MCP em modo de teste a zero, selecione Todos os produtos. As opções de serviço de modelosSQL e IA do Databricks não colocam o tráfego MCP em prova geral.

Conectividade privada

Para acessar um servidor MCP na sua rede em nuvem, escolha como o comput serverless do Azure Databricks se conecta a ele:

• Endpoint privado: Use o Link Privado para manter o tráfego em uma conexão privada. Um administrador de conta adiciona uma regra de endpoint privado para o domínio do servidor a uma configuração de conectividade de rede (NCC) anexada ao seu espaço de trabalho. Seu administrador de nuvem aprova a conexão do endpoint. Veja Configurar conectividade privada.
• Endpoint público com firewall: Configure o firewall do servidor para permitir IPs de saída serverless do Azure Databricks para a nuvem e região do seu workspace. Esses IPs são compartilhados entre os clientes do Azure Databricks, então mantenha a autenticação ativada no servidor. Veja Encontrar os IPs de saída e configurar seu firewall.

Domínios adicionados às regras de endpoint privados são automaticamente permitidos pelas políticas de rede, então você não precisa adicioná-los separadamente aos domínios Permitidos. Para um endpoint público, siga a configuração da política de rede acima.