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 é um objeto protegível do Unity Catalog invocado por meio do Unity Gateway. Você pode governar quem as invoca com permissões e governar chamadas individuais com políticas.

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.

Servidores MCP do Genie One versus Databricks SQL

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

Use the Databricks SQL MCP server when you need to execução a specific query you already wrote, such as validating syntax or authoring a pipeline.

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 a sua organização exigir aprovação, compartilhe o nome do aplicativo da tela de consentimento com o seu administrador.

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.

repository privados do GitHub

Por default, system.ai.github pode acessar apenas repository públicos. Um administrador da organização do 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 obter informações sobre login, permissões e erros de conexão, consulte Autenticação e rede de 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.

Legacy Workspace Endpoint

As integrações existentes podem continuar usando estes endpoints de MCP do Workspace. Para novas conexões do Genie One e do Databricks SQL, use os MCPs system.ai listados acima.

nota

Legacy Workspace Endpoint bypass Unity Gateway. Their calls do not appear in Unity Gateway tracing tables, and they do not support MCP-level Unity Catalog grants, policies, or guardrails. Access is controlled by permissions on the underlying recurso, such as tables, functions, indexes, and SQL warehouses.

Para essas URLs herdadas, um administrador do workspace deve habilitar Managed MCP Servers na página Pré-vias do workspace. Consulte a página de cada servidor para ver seu status de lançamento.

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.
• ID do Genie space: Abra o Genie Agent e copie o ID do espaço na tab Settings .
• 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.

Caminhos recomendados para novos agentes

As opções do SDK e do kit de ferramentas abaixo são para agentes Python. Para ferramentas nativas em agentes de codificação, use uma conexão MCP.

MCP ou ferramenta herdados	Abordagem recomendada	O que ele faz
Genie Agent MCP	Exemplos de ferramentas do AI Bridge	Faz query no mesmo Genie Agent curado a partir de Python. Para uma analítica mais ampla, use o Genie One MCP.
Databricks SQL MCP	Databricks SQL MCP (system.ai.dbsql)	Executa o SQL por meio do Unity Gateway.
AI Search MCP	Ferramentas de recuperação do AI Bridge	Faz queries nos seus índices de Pesquisa de AI diretamente do Python.
Funções do Unity Catalog MCP	UCFunctionToolkit	Chama suas funções registradas diretamente do Python.
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.

MCP ou ferramenta herdados	Abordagem recomendada	O que ele faz
Genie Agent MCP	Exemplos de ferramentas do AI Bridge	Faz query no mesmo Genie Agent curado a partir de Python. Para uma analítica mais ampla, use o Genie One MCP.
Databricks SQL MCP	Databricks SQL MCP (system.ai.dbsql)	Executa o SQL por meio do Unity Gateway.
AI Search MCP	Ferramentas de recuperação do AI Bridge	Faz queries nos seus índices de Pesquisa de AI diretamente do Python.
Funções do Unity Catalog MCP	UCFunctionToolkit	Chama suas funções registradas diretamente do Python.
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.

Para os MCPs de system.ai, use a URL do Unity Gateway e o escopo ai-gateway OAuth. Revise os requisitos de acesso do MCP antes de alternar.

Preços do Endpoint do workspace

• As funções do Unity Catalog usam preços de compute geral serverless.
• Os agentes do Genie e o Databricks SQL usam o preço do Databricks SQL.
• Índices de Pesquisa de AI usam preços de pesquisa de AI.