Autenticação MCP
Os clientes do Model Context Protocol (MCP) autenticam-se no Databricks para chamar ferramentas. Quando uma ferramenta acessa um serviço externo, uma credencial separada determina qual account de provedor ela usa.
Esta página explica os métodos de autenticação compatíveis para o Unity Gateway e servidores MCP no Databricks Apps. Use os guias de configuração para configurar a autenticação para seu cliente, agente ou servidor MCP. Para listas de acesso IP, políticas de rede e conectividade privada, consulte rede MCP.
O diagrama a seguir mostra os dois passos de autenticação para um MCP externo acessado por meio do Unity Gateway.
- Autenticação de entrada: O cliente envia um token do Databricks que identifica um usuário ou service principal do Databricks.
- Autenticação de saída: o Unity Gateway envia o token do provedor externo para o MCP. O método de autenticação configurado na conexão do Unity Catalog determina se ele usa a account de provedor de cada usuário ou uma account compartilhada.
Encontre o seu guia de configuração
Escolha um guia para os pré-requisitos, os passos de configuração e código para o seu caso de uso.
GUIA | O que cobre |
|---|---|
Adicione MCPs, autorize o acesso do provedor e chame ferramentas. Comece com o início rápido do agente de codificação se o seu agente ainda não estiver conectado ao Databricks. | |
Configure um cliente OAuth e adicione o conector MCP. Para outro cliente comercial, consulte Outros clientes MCP. | |
Seu aplicativo atende a vários usuários. Use os tokens de cada usuário, verifique o login do provedor e chame ferramentas com as permissões deles. | |
Crie ou teste um agente localmente. Faça login com a CLI, carregue as ferramentas MCP e execução o agente com o framework escolhido. | |
Implante um servidor MCP no Databricks Apps, habilite a autorização do usuário e configure uma conexão HTTP para sua API. | |
Configure as credenciais OAuth M2M e, em seguida, use-as com o cliente Python MCP. | |
registro o servidor, escolha seu método de autenticação e teste uma ferramenta. |
Use ferramentas MCP com acesso ao consumidor
Os usuários podem chamar ferramentas MCP por meio do Unity Gateway a partir de agentes de codificação, aplicativos personalizados e clientes comerciais com o direito de acesso do consumidor . Eles não precisam do direito de acesso ao Workspace , que concede acesso a ferramentas de autoria de workspace, como notebooks e jobs.
Um administrador concede acesso de consumidor e permissão para chamar o MCP. Para MCPs que usam OAuth por usuário, os usuários autorizam sua account de provedor através da página de login do MCP.
O acesso do consumidor oferece suporte ao uso de ferramentas MCP. O gerenciamento de MCPs na UI do Unity Gateway requer acesso ao Workspace . Consulte Recursos de acesso do consumidor.
Autenticação de entrada compatível
O cliente envia um token do Databricks quando chama um MCP através do Unity Gateway ou em Databricks Apps. Este token identifica o usuário do Databricks ou o service principal do Databricks que está fazendo a solicitação.
Seu caso de uso | Autenticação para usar |
|---|---|
Uma pessoa faz login a partir de um agente de codificação ou cliente comercial. | O usuário para máquina (U2M) OAuth chama o MCP como o usuário conectado. |
Um agente ou serviço autônomo entra em execução sem um usuário. | OAuth machine-to-machine (M2M) chama o MCP como um service principal. |
Seu aplicativo ou carga de trabalho já possui um token de um provedor de identidade. | A federação de tokens OAuth troca esse token por um token OAuth do Databricks para o usuário ou service principal mapeado. |
Uma integração existente usa um personal access token. | O access token pessoal (PAT) chama o MCP como proprietário do token. Com suporte por meio do Unity Gateway. Não compatível com servidores MCP em Databricks Apps. |
Autenticação de saída compatível
A autenticação de saída determina qual credencial um MCP externo ou backend recebe. O Unity Gateway gerencia credenciais por meio de conexões do Unity Catalog. Um servidor MCP no Databricks Apps pode usar uma conexão ou implementar sua própria autenticação de backend.
Por meio de conexões do Unity Catalog
O Unity Gateway autentica no MCP externo com o token do provedor configurado ou obtido através da sua conexão Unity Catalog.
O Unity Gateway oferece suporte a todos os cinco métodos de autenticação disponíveis para conexões HTTP do Unity Catalog. O MCP externo deve oferecer suporte ao método selecionado:
Método suportado | Quando usar | Identidade no MCP externo |
|---|---|---|
Todos os chamadores compartilham um tokens para acessar o MCP. | A account representada pelo token compartilhado. | |
O MCP oferece suporte a credenciais de cliente OAuth para uma identidade de serviço compartilhada. | A identidade de serviço configurada na conexão. | |
O MCP exige o login do usuário e todos os chamadores devem usar uma account de provedor compartilhada. | A account do provedor autorizada para a conexão. | |
O MCP oferece suporte ao registro automático de clientes OAuth e login por usuário. | A account do provedor que o autorizador autorizou. | |
Cada usuário precisa de acesso por meio de sua própria account de provedor, usando um cliente OAuth configurado. | A account do provedor que o autorizador autorizou. |
MCPs fornecidos pela Databricks
Para MCPs de dados como o Databricks SQL, a identidade do Databricks do chamador determina o acesso aos dados subjacentes. Os MCPs para serviços externos, como o GitHub, utilizam a autenticação do fornecedor tal como descrito em Através de ligações do Unity Catalog. Consulte MCPs fornecidos pelo Databricks para os requisitos de cada servidor.
Agentes e servidores MCP em Databricks Apps
Um agente ou servidor MCP no Databricks Apps pode chamar o Databricks usando autorização de aplicativo como o service principal do aplicativo, ou autorização do usuário como o usuário atual.
O destino determina como autenticar a chamada de saída:
- APIs do Databricks ou outros MCPs pelo Unity Gateway: Use a autorização do aplicativo para fazer chamadas como o aplicativo ou a autorização do usuário para fazer chamadas como o usuário atual.
- APIs REST externas através do proxy de conexão HTTP: o proxy autentica na API externa usando o método de conexão selecionado. Para chamar como cada usuário, combine a autorização de usuário do Apps com o OAuth por usuário na conexão.
- APIs externas ou MCPs chamados diretamente: Implemente o fluxo de autenticação suportado por esse serviço em seu servidor.
Para obter instruções de configuração, escopos necessários e código, consulte Configurar a autenticação do agente e Expor uma API REST como ferramentas MCP.