Conectar o Genie Code a servidores MCP

Conecte o Genie Code a ferramentas externas e fontes de dados por meio do Protocolo de Contexto de Modelo (MCP). O Genie Code pode usar todos os servidores MCP que foram adicionados ao seu workspace e que você tenha permissão para usar.

O que é MCP?

MCP é um padrão código aberto que conecta agentes de IA a ferramentas, recursos, prompts e outras informações contextuais. O MCP fornece uma maneira padronizada de expor ferramentas, dados e fluxos de trabalho ao Genie Code sem inserir esse contexto diretamente em prompts ou instruções.

O MCP foi projetado para casos em que o contexto importante já existe, mas é difícil de acessar de um agente de IA, como o Genie Code. O MCP oferece uma maneira segura de dar ao Genie Code acesso ao contexto da seguinte maneira:

• Sistemas de documentação: Equipes geralmente mantêm runbooks ou documentos operacionais em ferramentas como Confluence. Em vez de copiar seções em prompts, esse conteúdo pode ser exposto uma vez por meio de um servidor MCP externo e referenciado quando relevante. Seus documentos também podem já estar no Databricks como um índice de pesquisa de vetor, que o Genie Code pode usar para consultar documentos relevantes.
• Ferramentas e serviços: as equipes de plataforma podem manter APIs ou scripts para instalação, validação ou implantação. O MCP disponibiliza esses recursos diretamente para o Genie Code.
• Fontes de dados: se você já tiver dados no Databricks, poderá conectar o Genie Code a um espaço do Genie para ajudá-lo a analisar os dados usando a linguagem natural. Para dados armazenados fora do Databricks, você pode fornecer acesso seguro ao Genie Code por meio de servidores MCP externos.
• Aplicativos personalizados: você também pode adicionar a funcionalidade personalizada hospedada por meio dos Aplicativos do Databricks. Isso permite que você conecte o Genie Code a ferramentas proprietárias, fluxos de trabalho ou integrações criadas especificamente para você ou sua organização, todas gerenciadas com segurança em seu workspace do Databricks.

Nesses casos, o MCP substitui a colagem manual por uma abordagem estruturada e reutilizável, disponibilizando o contexto certo somente quando necessário.

Você pode conectar o Genie Code a todos os servidores MCP em seu workspace que você tenha permissão para usar. Os administradores do workspace controlam quais servidores estão disponíveis, enquanto os usuários podem selecionar entre essas fontes aprovadas conforme necessário.

Para saber mais sobre os servidores MCP no Databricks e como criar seus próprios, consulte o PROTOCOLO MCP (Model Context Protocol) no Databricks.

Conectar-se a fontes de dados de terceiros

O Genie Code fornece conectores internos para fontes de dados empresariais comuns, incluindo Google Drive e SharePoint.

Conectar-se a essas fontes de dados permite que o Genie Code pesquise seus documentos ao responder perguntas. Cada usuário é autenticado individualmente e os tokens OAuth não são compartilhados entre os usuários.

Para conectar uma fonte de dados de terceiros:

1. Em seu workspace, clique no Genie Code no canto superior direito para abrir um chat.
2. Na barra de prompts, clique no o ícone de adição.
3. Ao lado da fonte de dados à qual você deseja se conectar, clique em Conectar.
4. Conclua as etapas para entrar.

Depois de autenticar, o Genie Code pode pesquisar seus documentos ao responder perguntas. Os administradores do Metastore e os proprietários de conexões podem gerenciar ou revogar permissões de usuário na conexão. Consulte Compartilhar a conexão do servidor MCP.

Para conectar outras fontes de dados, adicione-as manualmente ao Genie Code. Consulte Adicionar servidores MCP ao Genie Code manualmente.

Limitações do Google Drive

• O tamanho máximo do arquivo é de 10 MB.
• Há suporte apenas para arquivos nativos do Google Workspace (Docs, Planilhas, Slides). PDFs, imagens e outros formatos binários não têm suporte.
• Erros de expiração de conexão ou token podem aparecer na saída do agente. Autentique novamente para resolver.

limitações de SharePoint

• O tamanho máximo do arquivo é de 10 MB.
• Os tipos de arquivo com suporte incluem documentos do Office (.docx, .xlsx, .pptx), bem como formatos comuns baseados em texto, como.txt, , .csv, .json.mde outros. PDFs, imagens e outros formatos binários não têm suporte.

Adicionar servidores MCP ao Genie Code manualmente

Para conectar o Genie Code a um servidor MCP, adicione-o às configurações do Genie Code:

1. Abra as configurações do Genie Code. No painel Genie Code, clique no Configurações.
2. Em Servidores MCP, clique no Adicionar Servidor.
3. Selecione os servidores MCP que você deseja adicionar. Você pode selecionar servidores MCP gerenciados pelo Databricks ou servidores MCP externos:
   • Função Catálogo do Unity: selecione o esquema para a função. Isso permite que o Genie Code use funções para executar consultas SQL predefinidas.
     • Para obter ajuda para adicionar um servidor MCP GitHub, consulte criar um servidor MCP GitHub.
   • Pesquisa de vetor: selecione o esquema para o índice. Isso permite que o Genie Code consulte o índice de pesquisa de vetor para localizar documentos relevantes.
   • Espaço do gênio: selecione o espaço do Genie. O Genie MCP invoca o Genie como uma ferramenta, permitindo que você consulte o espaço do Genie para analisar dados usando a linguagem natural.
   • Servidor MCP externo: selecione a conexão do Catálogo do Unity a ser usada como um servidor MCP externo. Você deve fazer logon na conexão primeiro antes que ela possa ser usada.
   • Servidor MCP personalizado: selecione o Aplicativo Databricks a ser usado como um servidor MCP personalizado. Isso permite que você use quaisquer ferramentas personalizadas. Os seguintes requisitos se aplicam:
     • Seu aplicativo deve ser implantado no mesmo workspace do qual você está tentando se conectar a ele.
     • O servidor MCP deve ser acessado em https://<server-url>/mcp.
     • Seu aplicativo deve ser sem estado. Por exemplo, defina mcp_app = mcp_server.http_app(stateless_http=True).
     • Se você encontrar erros de CORS, talvez seja necessário adicionar a URL do workspace à lista de origens permitidas do aplicativo. Por exemplo, defina app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Clique em Salvar.

Depois de adicionados, os servidores MCP ficam imediatamente disponíveis para o Genie Code. Você pode começar a usá-los no modo Agente sem alterar seus prompts ou instruções. O Genie Code utilizará automaticamente esses servidores quando for relevante.

Atualmente, o acesso ao MCP é limitado a 20 ferramentas em todos os servidores. Você pode escolher quais ferramentas e servidores habilitar ou desabilitar nas configurações do Genie Code.