Pular para o conteúdo principal

Conectar clientes externos aos servidores MCP da Gerenciar

info

Beta

Este recurso está em fase beta.

Conecte os assistentes externos AI e IDEs que suportam o Protocolo de Contexto de Modelo (MCP) aos servidores Databricks-gerenciar MCP. Isso permite que o senhor use os dados e as ferramentas da Databricks diretamente em seu ambiente de desenvolvimento.

Databricks-gerenciar Os servidores MCP são compatíveis com dois métodos de autenticação:

  • OAuth - Recomendado para acesso seguro e com escopo usando aplicativos OAuth
  • PAT tokens - Autenticação simples baseada em tokens de curta duração usando tokens de acesso pessoal

Pré-requisitos

Antes de conectar ferramentas externas:

  • Identifique os URLs do servidor MCP. Para saber mais sobre os servidores MCP gerenciar compatíveis com Databricks, consulte servidores MCP gerenciar.

  • Certifique-se de que o seu account tem acesso ao recurso Unity Catalog (catálogos, esquemas, funções ou índices vetoriais) que pretende utilizar.

Autenticação com OAuth

OAuth fornece acesso seguro e com escopo a Databricks-gerenciar servidores MCP usando aplicativos OAuth.

Configurar a autenticação OAuth

  1. Crie um aplicativo OAuth: Solicite a um administrador account que crie ou obtenha um aplicativo Databricks OAuth existente. Certifique-se de adicionar os URLs de redirecionamento necessários do seu cliente externo e de obter os valores de ID do cliente e/ou segredo do cliente do seu aplicativo OAuth. Siga estas instruções para criar um novo OAuth aplicativo da Parceiros: Habilite OAuth o para integrações da Parceiros.

Por meio da UI do Console da conta

  • Navegue até suas Configurações - > Conexões de aplicativos - > Adicionar conexão Configuração de conexões de aplicativos em Databricks

Via Databricks CLI (Fonte: Databricks API):

JSON
   databricks account custom-app-integration create --json '{
"name": "mcp-public-client",
"redirect_urls": ["https://redirectclient.com/callback"],
"confidential": false,
"scopes": ["all-apis"],
"token_access_policy": {
"access_token_ttl_in_minutes": 60,
"refresh_token_ttl_in_minutes": 10080
}
}'
  • Nota: Os servidores MCP oferecem suporte a clientes públicos e confidenciais, conforme especificado na documentação de autorização do MCP. Se estiver criando um cliente público, certifique-se de desmarcar a caixa de seleção Generate a client secret (Gerar um segredo do cliente ) na interface do console da conta Databricks. Se o senhor estiver criando um por meio da CLI da Databricks, defina "confidential": false.
  1. Configure seu cliente MCP : Use o ID do cliente OAuth do URL do servidor MCP (e o segredo opcional do cliente) na configuração do cliente MCP externo. Use o tipo de conexão streamable-http para o servidor.

  2. Confirme suas restrições de workspace IP ACL: Databricks-gerenciar servidores MCP honrar espaço de trabalho IP ACL restrições. Se o site Databricks workspace tiver alguma restrição de acesso a IP, adicione à lista de permissões todos os endereços IP de saída correspondentes ao cliente externo.

Exemplos de configuração de cliente com OAuth

Configurar o Claude com o OAuth

Se o senhor tiver habilitado o Claude Connectors using Remote MCP, poderá adicionar servidores Databricks gerenciar MCP por meio da interface do usuário.

No Databricks:

  1. Crie uma conexão de aplicativo OAuth por meio da interface do usuário ou da CLI do databricks que inclua os URLs de redirecionamento do Claude

Por meio da UI do Console da conta:

  • Navegue até suas Configurações - > Conexões de aplicativos - > Adicionar conexão Configuração de conexões de aplicativos em Databricks

Via Databricks CLI: (Fonte: Databricks API):

JSON
   databricks account custom-app-integration create --json '{
"name": "claude-mcp-public-client",
"redirect_urls": ["https://claude.ai/api/mcp/auth_callback"],
"confidential": false,
"scopes": ["all-apis"],
"token_access_policy": {
"access_token_ttl_in_minutes": 60,
"refresh_token_ttl_in_minutes": 10080
}
}'
  • Observação: os aplicativos OAuth precisam ter o escopo all-apis para o Claude in Beta.
  1. Se o senhor tiver restrições de workspace IP ACL, adicione os endereços IP de saída do Claude à lista de permissões do workspace

Em Claude:

  1. Navegue até Configurações > Conectores.

  2. Localize a seção Conectores .

  3. Clique em Adicionar conector personalizado na parte inferior da página.

  4. Adicione o URL do servidor Databricks gerenciar MCP como o URL do servidor Remote MCP.

  5. Adicione o ID do cliente do OAuth App Integration e o segredo opcional (se o cliente for confidencial).

  6. Clique em Adicionar para concluir a configuração do conector.

    Configurando o conector em Claude

Autenticação com tokens PAT

Os tokens de acesso pessoal (PAT) oferecem uma maneira simples de se autenticar nos servidores MCP Databricks-gerenciar.

Configurar a autenticação PAT

  1. Gerar um token de acesso pessoal (PAT) : Consulte Personal access tokens.

  2. Use o PAT em sua configuração : Adicione os tokens à configuração do cliente MCP, conforme mostrado nos exemplos abaixo.

Exemplos de configuração do cliente com PAT

Configurar o cursor com PAT

O Cursor suporta MCP por meio de sua configuração de configurações. Adicione o seguinte às configurações do seu cursor:

O exemplo mostra Unity Catalog Functions, mas o senhor pode adaptá-lo para qualquer caminho de URL do servidor MCP gerenciar:

JSON
{
"mcpServers": {
"uc-function-mcp": {
"type": "streamable-http",
"url": "https://<your-workspace-hostname>/api/2.0/mcp/functions/{catalog_name}/{schema_name}",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
},
"note": "Databricks UC function"
}
}
}

Configurar o Claude Desktop com PAT

Para utilizar o gerenciamento remoto de servidores MCP ( Databricks) no Claude Desktop, utilize o mcp-remote. Adicione a configuração a seguir ao seu arquivo claude_desktop_config.json.

O arquivo de configuração pode ser encontrado nos seguintes locais em default:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

O exemplo mostra Unity Catalog Functions, mas o senhor pode adaptá-lo para qualquer caminho de URL do servidor MCP gerenciar:

JSON
{
"mcpServers": {
"uc-function-mcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://<your-workspace-hostname>/api/2.0/mcp/functions/{catalog_name}/{schema_name}",
"--header",
"Authorization: Bearer <YOUR_TOKEN>"
]
}
}
}

Depois de atualizar a configuração, reinicie o Claude Desktop para que as alterações entrem em vigor.

Por que não consigo me conectar a servidores MCP personalizados?

Os servidores MCP personalizados hospedados nos aplicativos Databricks exigem fluxos de login interativos que os IDEs externos não suportam. Isso significa que ferramentas externas, como Cursor e Claude Desktop, ainda não podem se conectar a servidores MCP personalizados.