Servidor MCP do Genie Agent
O servidor MCP do Genie Agent permite que um agente faça query em um único Genie Agent com linguagem natural, sem escrever SQL. O agente envia uma pergunta em linguagem simples, e o Genie escreve e faz a execução do SQL nas tabelas desse agente e retorna o resultado, com as permissões do Unity Catalog aplicadas em cada solicitação.
Para fazer query a um Genie Agent do Python sem MCP, use exemplos da ferramenta AI Bridge. Para perguntas de negócios em seu workspace, use o Genie One MCP (system.ai.genie_one_mcp).
Um Genie Agent é uma coleção de até 50 tabelas, view ou visualizações métricas do Unity Catalog que o Genie mantém em contexto, de modo que o servidor seja limitado a esses dados selecionados em vez de todo o seu workspace.
Padrão de URL | Escopo OAuth |
|---|---|
|
|
Para encontrar o ID do Genie space, abra o Genie Agent e copie o ID do espaço na tab Configurações dele.
As chamadas para esse endpoint não passam pelo Unity Gateway, então o acesso é controlado por permissões no Genie Agent e em seus dados subjacentes.
As chamadas MCP do Genie Agent usam preços do Databricks SQL.
Pré-requisitos
Um administrador do workspace deve habilitar Servidores MCP Gerenciados na página de Pré-visualizações do workspace.
Conectar um agente
Para conectar um agente a um servidor MCP do Genie Agent, crie um Genie Agent, compartilhe-o com os usuários ou Service Principal que precisam de acesso e aponte seu agente para a URL de MCP pré-configurada para o espaço. Siga Usar ferramentas MCP em um agente Python, definindo server_url para a URL acima.
Para conectar clientes externos como Cursor ou Claude Desktop, consulte Agentes de codificação compatíveis.
Limitações
- Somente leitura. O servidor MCP do Genie Agent faz query nos dados; ele não grava em suas tabelas.
- Sem história de conversas. O servidor invoca o Genie como uma ferramenta, portanto, ele não passa a história da conversa para a API do Genie. Para continuar uma conversa de Python, use o AI Bridge.