Servidor MCP Genie One

info

Beta

Este recurso está em Beta. Os administradores do Workspace podem controlar o acesso a este recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

O servidor MCP do Genie One é um servidor MCP gerenciado do Databricks que expõe o Genie como uma ferramenta de conversação através do Model Context Protocol (MCP), aproveitando o Chat no Genie One. Um cliente ou agente MCP envia uma pergunta em linguagem natural, e o Genie pesquisa seus dados corporativos, escreve SQL e retorna uma resposta fundamentada na Ontologia do Genie com links diretos para suas fontes citadas no Databricks.

Conecte qualquer cliente ou agente MCP para fundamentar suas perguntas de dados nas percepções confiáveis do Genie. Clientes que suportam Apps MCP podem renderizar uma View interativa que mostra o progresso, as visualizações e os resultados do Genie em linha.

As permissões do Unity Catalog são sempre aplicadas, portanto, usuários e agentes só podem fazer query de dados que têm permissão para acessar.

nota

O servidor MCP do Genie One responde a perguntas em todos os dados do seu workspace usando Chat no Genie One e é servido no caminho /api/2.0/mcp/genie. Ele é distinto do servidor Genie por agente em /api/2.0/mcp/genie/{genie_space_id}, que faz query a um único Genie Agent. [[ ## completed ##]] Consulte Servidores MCP gerenciados da Databricks para o servidor por agente.

Habilitar o servidor MCP do Genie One

O servidor MCP Genie One requer a prévia do Workspace gerenciados MCP Servers . Um administrador do workspace o habilita da seguinte forma:

1. Como administrador do workspace, clique em seu nome de usuário na barra superior do workspace do Databricks.
2. No menu, selecione Previews .
3. Pesquise e ative os Servidores MCP Gerenciados .

Para saber mais sobre como gerenciar prévias, consulte Gerenciar prévias do Databricks.

Endpoint e autenticação

O servidor MCP Genie One está disponível no seguinte URL.

https://<workspace-hostname>/api/2.0/mcp/genie

Conectar-se ao servidor MCP Genie One é como conectar-se a qualquer outro servidor MCP gerenciado do Databricks: as solicitações devem ser autenticadas no seu workspace. Ao conectar-se com autenticação de usuário em nome de, inclua o escopo OAuth genie. Consulte Conectar clientes usando autenticação OAuth para obter instruções de configuração e Conectar MCPs a assistentes de AI e agentes de codificação para conectar clientes como Cursor e Claude Desktop. [[ ## completed ##]]

Ferramentas disponíveis

O servidor MCP Genie One expõe as seguintes ferramentas. Na prática, um agente invoca genie_ask (ou view_ask em clientes de aplicativos MCP) para fazer uma pergunta; o agente gerencia as ferramentas restantes em seu nome enquanto trabalha na resposta.

Ferramenta	Descrição
genie_ask	Faça uma pergunta de dados em linguagem natural ao Genie e comece uma resposta. Retorna conversation_id, response_id e status. Passe um conversation_id para continuar uma conversa anterior.
genie_poll_response	Obtenha o estado mais recente de uma resposta em andamento ou concluída, incluindo os passos de progresso, a resposta final e links diretos para suas fontes do Databricks.
genie_get_query_result	Busque o resultado SQL completo, incluindo o esquema de colunas e as linhas, para uma query cuja execução o Genie realizou.
genie_cancel_response	Solicitar o cancelamento de um turno do Genie em andamento.
view_ask	Faça uma pergunta ao Genie e abra a view interativa. Oferecido em vez de genie_ask para clientes de aplicativos MCP, e preferencial quando disponível.

Ferramenta	Descrição
genie_ask	Faça uma pergunta de dados em linguagem natural ao Genie e comece uma resposta. Retorna conversation_id, response_id e status. Passe um conversation_id para continuar uma conversa anterior.
genie_poll_response	Obtenha o estado mais recente de uma resposta em andamento ou concluída, incluindo os passos de progresso, a resposta final e links diretos para suas fontes do Databricks.
genie_get_query_result	Busque o resultado SQL completo, incluindo o esquema de colunas e as linhas, para uma query cuja execução o Genie realizou.
genie_cancel_response	Solicitar o cancelamento de um turno do Genie em andamento.
view_ask	Faça uma pergunta ao Genie e abra a view interativa. Oferecido em vez de genie_ask para clientes de aplicativos MCP, e preferencial quando disponível.

Faça uma pergunta

Como o Genie faz a execução de um agente que pesquisa dados e executa SQL, as respostas são assíncronas. [[ ## completed ##]] Você (ou seu agente) invoca genie_ask com uma pergunta; o agente então gerencia o restante da troca automaticamente. Um fluxo típico tem a seguinte aparência:

1. genie_ask começa a resposta e retorna um conversation_id e response_id com status: in_progress. O Genie continua trabalhando em segundo plano.
2. O agente pesquisa genie_poll_response até que a resposta seja concluída, exibindo progress_steps e um narration_instruction ao longo do caminho para mantê-lo informado.
3. Quando status é completed (ou incomplete / failed), o agente retorna a resposta renderizada, incluindo um link direto Explore in Databricks para a conversa completa e quaisquer visualizações que o Genie produziu.

Para continuar a mesma conversa, a pergunta de acompanhamento reutiliza o conversation_id anterior.

Aplicativo MCP

O servidor MCP do Genie One fornece um aplicativo MCP, uma extensão que permite que um servidor retorne uma view interativa em vez de texto simples. Em clientes que suportam aplicativos MCP, o servidor retorna uma View interativa: um painel incorporado no cliente que mostra o progresso, as visualizações e a resposta final do Genie conforme a conversa se desenrola, em vez de uma resposta apenas em texto.

O aplicativo Genie One MCP renderizando um gráfico de barras, métricas de resumo e citações da Genie Ontology dentro do Claude Desktop.

Nenhuma configuração adicional é necessária. Os clientes que oferecem suporte a aplicativos MCP recebem automaticamente a View interativa. Clientes que não continuam a receber resultados de texto.

Considerações

• Permissões : As permissões do Unity Catalog são aplicadas em cada solicitação, portanto, os resultados são limitados ao que o usuário pode acessar.
• Configuração : O servidor respeita sua configuração do Genie One no Databricks. Ajuste e configure o comportamento do Genie lá. Consulte Bate-papo no Genie One.
• Cadência de polling : aguarde a conclusão da chamada genie_poll_response anterior antes de realizar o polling novamente.
• Tamanho do resultado : Para proteger a janela de contexto do modelo, genie_ask e genie_poll_response retornam resultados de query truncados. [[ ## completed ##]] Quando um agente precisa do resultado completo, ele pode chamar genie_get_query_result para recuperar o esquema completo e as linhas. Resultados muito grandes ainda estão sujeitos a um limite de tamanho; se ele for excedido, a resposta será truncada.
• Preços : O servidor MCP Genie One usa o Chat no Genie One. Consulte preços do Genie.

Conectar ao servidor MCP Genie One

O servidor MCP Genie One é um dos servidores MCP gerenciados do Databricks. Para conectar clientes externos, como o Cursor ou o Claude Desktop, ou para criar um agente que chame o servidor, consulte Conectar MCPs a assistentes de AI e agentes de codificação.

Para view seus servidores MCP e seus URLs de Endpoint, vá para o seu Workspace e selecione Agents > MCPs .