Databricks-provided MCPs

O Databricks fornece MCPs no esquema system.ai para dados e serviços externos. Escolha um MCP abaixo e, em seguida, conecte seu agente. Você não precisa hospedar ou fazer o registro de um servidor.

Cada MCP system.ai é um item protegível do Unity Catalog invocado por meio do Unity Gateway. Você pode controlar quem os invoca com concessões e controlar chamadas individuais com políticas.

Outros Endpoint de MCP de Workspace, incluindo o MCP do Genie Agent, usam permissões nos recursos subjacentes sem a governança do Unity Gateway.

URL do servidor MCP

Para qualquer system.ai MCP, use este URL:

Text

https://<workspace-hostname>/ai-gateway/mcp-services/<mcp-name>

Substitua <workspace-hostname> pelo hostname do seu workspace e <mcp-name> pelo nome completo das tabelas abaixo, como system.ai.dbsql.

Dados e ferramentas do Databricks

info

Unity Gateway Beta

Para usar system.ai.dbsql, system.ai.sandbox ou system.ai.web_search, um administrador de account deve habilitar a versão beta de Unity Gateway na página Previews do console da account. Consulte Gerenciar prévias da account.

O Genie One MCP está disponível de forma geral.

MCP	Descrição
system.ai.genie_one_mcp	Recomendado para analítica em linguagem natural em todo o seu workspace. Responde a perguntas com o Genie One, com base na Genie Ontology.
system.ai.dbsql	Executa queries SQL específicas para desenvolvimento e engenharia de dados em um SQL warehouse, usando as permissões de Unity Catalog e warehouse do chamador.
system.ai.web_search	Pesquisa na web pública e retorna uma resposta sintetizada com citações.
system.ai.sandbox	Executa código Python, SQL ou shell em um ambiente isolado.

MCP	Descrição
system.ai.genie_one_mcp	Recomendado para analítica em linguagem natural em todo o seu workspace. Responde a perguntas com o Genie One, com base na Genie Ontology.
system.ai.dbsql	Executa queries SQL específicas para desenvolvimento e engenharia de dados em um SQL warehouse, usando as permissões de Unity Catalog e warehouse do chamador.
system.ai.web_search	Pesquisa na web pública e retorna uma resposta sintetizada com citações.
system.ai.sandbox	Executa código Python, SQL ou shell em um ambiente isolado.

Escolha entre os servidores MCP Genie One, Genie Agent e Databricks SQL

Para casos de uso de analítica, comece com o servidor MCP Genie One. O Genie resolve termos de negócios, definições de métricas e relacionamentos de tabela por meio da Genie Ontology, sua camada semântica governada. Isso gera respostas mais precisas do que um agente escrevendo SQL diretamente em tabelas brutas.

Servidor MCP	Caso de uso	Governança
Genie One MCP (system.ai.genie_one_mcp)	Faça perguntas de negócios em linguagem natural em seu workspace.	Concessões e políticas do Unity Gateway, além de permissões de recursos subjacentes.
Genie Agent MCP	Faça perguntas em linguagem natural delimitadas a um Genie Agent selecionado, usando suas tabelas, instruções e exemplos.	Permissões no Genie Agent e seus dados. Chamadas ignoram o Unity Gateway.
Databricks SQL MCP (system.ai.dbsql)	Execute uma query SQL específica, como validar a sintaxe ou criar um pipeline.	Concessões e políticas do Unity Gateway, além de permissões de recursos subjacentes.

Servidor MCP	Caso de uso	Governança
Genie One MCP (system.ai.genie_one_mcp)	Faça perguntas de negócios em linguagem natural em seu workspace.	Concessões e políticas do Unity Gateway, além de permissões de recursos subjacentes.
Genie Agent MCP	Faça perguntas em linguagem natural delimitadas a um Genie Agent selecionado, usando suas tabelas, instruções e exemplos.	Permissões no Genie Agent e seus dados. Chamadas ignoram o Unity Gateway.
Databricks SQL MCP (system.ai.dbsql)	Execute uma query SQL específica, como validar a sintaxe ou criar um pipeline.	Concessões e políticas do Unity Gateway, além de permissões de recursos subjacentes.

Serviços externos

Se uma ferramenta solicitar que você faça login, abra o link de login retornado pelo MCP, autorize o acesso à sua account de provedor e tente a chamada novamente. Se sua organização exigir aprovação, compartilhe o nome do aplicativo da tela de consentimento com seu administrador. Para fazer login antes da sua primeira chamada, fazer login novamente ou sair, consulte Gerenciar login do provedor.

MCP	Conecta-se a
system.ai.slack	Servidor Slack MCP
system.ai.github	Servidor GitHub MCP
system.ai.atlassian	Jira e Confluence por meio do servidor Atlassian Rovo MCP
system.ai.google_drive	APIs do Google Drive, Docs, Sheets e Slides
system.ai.google_calendar	Google Calendar API
system.ai.gmail	Gmail API
system.ai.microsoft_365	SharePoint, Outlook e Teams por meio do Microsoft Graph

MCP	Conecta-se a
system.ai.slack	Servidor Slack MCP
system.ai.github	Servidor GitHub MCP
system.ai.atlassian	Jira e Confluence por meio do servidor Atlassian Rovo MCP
system.ai.google_drive	APIs do Google Drive, Docs, Sheets e Slides
system.ai.google_calendar	Google Calendar API
system.ai.gmail	Gmail API
system.ai.microsoft_365	SharePoint, Outlook e Teams por meio do Microsoft Graph

Para saber quais permissões cada MCP solicita, consulte Provedores de OAuth gerenciados. Verifique se o provedor e o uso pretendido atendem aos requisitos de compliance da sua organização.

Habilitar acesso de gravação no GitHub e acesso a repository privados

Por default, o system.ai.github pode ler apenas repository públicos. Para acessar repository privados ou fazer alterações como commit arquivos ou criar problemas e solicitações de pull, o proprietário do repository ou um administrador da organização GitHub deve:

1. Instale o aplicativo do conector Databricks GitHub e conceda a ele acesso aos repository necessários.

   Para o AWS GovCloud, use o aplicativo databricks-gh-connector-gov-cloud em vez disso.

2. If the organization uses an IP allowlist, add the Databricks serverless outbound IPs for your workspace's cloud and region.

Conecte seu agente

Abra o Unity Gateway no seu workspace e selecione MCPs . Copie o nome do MCP, como system.ai.github, e siga o seu guia de configuração:

• Claude Code, Codex, Cursor e outros agentes de codificação
• Agentes em Python

Para clientes que exigem uma URL de servidor, use o padrão de URL acima.

Para erros de login, permissões e conexão, consulte a autenticação MCP.

Limitações

• system.ai.web_search não está disponível em workspaces com compliance HIPAA/BAA habilitada. Está disponível em regiões dos EUA suportadas ou em workspaces que permitem processamento cross-Geo.

• system.ai.sandbox não possui saída de rede.

• system.ai.web_search e system.ai.sandbox não estão disponíveis para usuários com apenas o direito de acesso de consumidor.

Endpoint não governados pelo Unity Gateway

Esses Endpoint MCP de Workspace usam permissões nos recursos subjacentes, como Genie Agents, tabelas, funções, índices e SQL Warehouse.

As chamadas ignoram o Unity Gateway, portanto não aparecem nas suas tabelas de rastreamento nem oferecem suporte a concessões, políticas ou proteções no nível do MCP. Para novas integrações, o Databricks recomenda os MCPs system.ai em Dados e ferramentas do Databricks e Serviços externos quando eles suportarem seu caso de uso.

Esses Endpoint estão em Prévia Pública. Use o endpoint do Genie Agent para query um agente com curadoria única e o endpoint de AI Search ou functions quando seu cliente exigir acesso MCP a esses recursos.

Para essas URLs, um administrador do workspace deve habilitar Servidores MCP Gerenciados na página de Previews do workspace.

Use a URL completa do servidor abaixo no seu cliente MCP. Ao usar OAuth, solicite o escopo listado.

Servidor	URL do servidor	Escopo OAuth
Genie Agent	https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}	genie
AI Search	https://<workspace-hostname>/api/2.0/mcp/ai-search/{catalog}/{schema}/{index_name}	ai-search
Databricks SQL	https://<workspace-hostname>/api/2.0/mcp/sql	sql
Funções do Unity Catalog	https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}/{function_name}	unity-catalog

Servidor	URL do servidor	Escopo OAuth
Genie Agent	https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}	genie
AI Search	https://<workspace-hostname>/api/2.0/mcp/ai-search/{catalog}/{schema}/{index_name}	ai-search
Databricks SQL	https://<workspace-hostname>/api/2.0/mcp/sql	sql
Funções do Unity Catalog	https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}/{function_name}	unity-catalog

Substitua os placeholders pelos valores do seu workspace:

• Hostname do workspace: abra seu workspace e copie o hostname da barra de endereços do navegador, sem https://, o caminho ou os parâmetros de query. Consulte Encontre a URL do seu workspace.
• Catalog, schema, and index or function name: abra Catalog e localize o índice ou a função. Use as partes do nome completo no URL. Por exemplo, main.tools.lookup_customer torna-se main/tools/lookup_customer.
• ID do Genie space: Abra o Genie Agent e copie o ID do espaço na tab Settings .

Usar servidores MCP do Unity Gateway

Esses servidores MCP funcionam com agentes de codificação, clientes MCP de desktop e agentes Python. Use a URL do Gateway do Unity e o escopo OAuth ai-gateway. Analise os requisitos de acesso do MCP antes de trocar.

Ferramenta ou MCP do Workspace	Unity Gateway MCP	O que ele faz
Databricks SQL MCP (/api/2.0/mcp/sql)	Databricks SQL MCP (system.ai.dbsql)	Executa o SQL por meio do Unity Gateway.
Interpretador de código (system.ai.python_exec) por meio do MCP de funções	system.ai.sandbox (Unity Gateway Beta)	Executa código Python, SQL ou shell por meio do MCP.

Ferramenta ou MCP do Workspace	Unity Gateway MCP	O que ele faz
Databricks SQL MCP (/api/2.0/mcp/sql)	Databricks SQL MCP (system.ai.dbsql)	Executa o SQL por meio do Unity Gateway.
Interpretador de código (system.ai.python_exec) por meio do MCP de funções	system.ai.sandbox (Unity Gateway Beta)	Executa código Python, SQL ou shell por meio do MCP.

Chamar recursos diretamente de agentes Python

Para agentes Python, o Databricks recomenda essas bibliotecas para chamar recursos diretamente sem MCP. Essas bibliotecas não roteiam chamadas pelo Unity Gateway.

Recursos	Biblioteca Python	Guia de implementação
Índices de Pesquisa de AI	Ferramentas de recuperação do AI Bridge	Fazer query de índices de Pesquisa de AI.
Funções do Unity Catalog	UCFunctionToolkit	Chamar funções registradas.
Genie Agent	Ferramentas de ponte de AI	query um Genie Agent.

Recursos	Biblioteca Python	Guia de implementação
Índices de Pesquisa de AI	Ferramentas de recuperação do AI Bridge	Fazer query de índices de Pesquisa de AI.
Funções do Unity Catalog	UCFunctionToolkit	Chamar funções registradas.
Genie Agent	Ferramentas de ponte de AI	query um Genie Agent.

Preços do Endpoint do workspace

• As funções do Unity Catalog usam preços de compute geral serverless.
• O Databricks SQL usa preços do Databricks SQL.
• Índices de Pesquisa de AI usam preços de pesquisa de AI.