Servidor MCP Genie One

info

Beta

Este recurso está em Beta. Os administradores de 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 da Databricks que expõe o Genie como uma ferramenta de conversação sobre o 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 Genie Ontology com links profundos para suas fontes Databricks citadas.

Conecte qualquer cliente ou agente MCP para fundamentar suas perguntas de dados nas percepções confiáveis do Genie. Clientes que suportam MCP Apps 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, então usuários e agentes só podem consultar dados aos quais têm permissão de acesso.

nota

O servidor MCP Genie One responde a perguntas em seus dados de workspace usando Chat no Genie One e é servido no caminho /api/2.0/mcp/genie. É distinto do servidor Genie por agente em /api/2.0/mcp/genie/{genie_space_id}, que consulta um único Genie Agent. Consulte servidores MCP gerenciados pelo Databricks para o servidor por agente.

Habilitar o servidor Genie One MCP

O servidor MCP Genie One exige a pré-visualização do workspace **Servidores MCP Gerenciados**. Um administrador de 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. Procure e ative Servidores MCP Gerenciados .

Para obter mais informações sobre o gerenciamento de prévias, consulte Gerenciar prévias do Databricks.

Endpoint e autenticação

O servidor MCP Genie One está disponível na 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 em seu workspace. Ao conectar-se com a autenticação em nome do usuário, 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.

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 à medida que processa a 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 profundos para suas fontes Databricks.
genie_get_query_result	Obtenha o resultado SQL completo — esquema de colunas e linhas — para uma consulta que o Genie executou.
genie_cancel_response	Solicitar o cancelamento de uma interação 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 executa um agente que pesquisa dados e executa SQL, as respostas são assíncronas. Você (ou seu agente) invoca genie_ask com uma pergunta; o agente então gerencia o resto da troca automaticamente. Um fluxo típico é assim:

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

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

Aplicativo MCP

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

O Aplicativo Genie One MCP exibindo 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. Clientes que oferecem suporte a MCP Apps recebem automaticamente a view interativa. Clientes que não continuem a receber resultados de texto.

Considerações

• Permissões : As permissões do Unity Catalog são aplicadas a cada solicitação, então os resultados são restritos 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á. Veja Bate-papo no Genie One.
• Cadência de pesquisa : Aguarde a conclusão da chamada genie_poll_response anterior antes de pesquisar novamente.
• Tamanho do resultado : Para proteger a janela de contexto do modelo, genie_ask e genie_poll_response retornam resultados de consulta truncados. Quando um agente precisa do resultado completo, ele pode chamar genie_get_query_result para recuperar o esquema e as linhas completas. 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 Chat no Genie One. Consulte os preços do Genie.

Conecte-se ao servidor MCP Genie One

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

Para visualizar seus servidores MCP e suas URLs de endpoint, vá para seu workspace e selecione Agentes > MCPs .