Pular para o conteúdo principal
Última atualização em

Conecte o Genie Code aos servidores MCP

Conecte Genie Code a ferramentas externas e fontes de dados através do Protocolo de Contexto do Modelo (MCP). Genie Code pode usar qualquer servidor MCP que tenha sido adicionado ao seu workspace e para o qual você tenha permissão de uso.

nota

Os servidores MCP são suportados apenas no modo Genie Code Agent.

O que é MCP?​

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

O MCP foi projetado para casos em que um contexto importante já existe, mas é de difícil acesso para um agente AI , como Genie Code. O MCP oferece uma maneira segura de conceder ao Genie Code acesso a contextos como os seguintes:

  • Sistemas de documentação : As equipes costumam manter manuais de procedimentos ou documentos operacionais em ferramentas como o Confluence. Em vez de copiar seções para os prompts, esse conteúdo pode ser exposto uma única 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 vetorial, que o Genie Code pode usar para consultar documentos relevantes.
  • Ferramentas e serviços : As equipes de plataforma podem manter APIs ou scripts para configuração, validação ou implantação. O MCP disponibiliza essas funcionalidades diretamente para o Genie Code.
  • fonte de dados : Se você já possui dados no Databricks, pode conectar Genie Code a um espaço Genie para ajudá-lo a analisar o uso de dados em linguagem natural. Para dados armazenados fora do Databricks, você pode conceder ao Genie Code acesso seguro por meio de servidores MCP externos.
  • Aplicativos personalizados : Você também pode adicionar funcionalidades personalizadas hospedadas por meio do Databricks Apps. Isso permite conectar Genie Code a ferramentas proprietárias, fluxo de trabalho ou integrações criadas especificamente para você ou sua organização, tudo gerenciado com segurança dentro do seu workspace Databricks .

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

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

Para saber mais sobre servidores MCP no Databricks e como criar o seu próprio, consulte Model Context Protocol (MCP) no Databricks.

Conecte-se a fontes de dados de terceiros​

info

Visualização

Este recurso está em versão Beta. Para usar conectores de fontes de dados de terceiros, um administrador workspace deve ativar a pré-visualização de Conectores de Terceiros para Agentes . Veja as prévias do Gerenciador Databricks.

Genie Code oferece conectores integrados para fontes de dados corporativas comuns, incluindo Google Drive e SharePoint.

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

Para conectar uma fonte de dados de terceiros:

  1. Na sua workspace, clique em Ícone do código do gênio brilhante. Genie Code no canto superior direito para abrir um bate-papo.
  2. Na barra de prompts, clique Novo ícone. o ícone de mais.
  3. Ao lado da fonte de dados à qual deseja se conectar, clique em Conectar .
  4. Conclua os passos para iniciar sessão.

Após a autenticação, o Genie Code poderá pesquisar seus documentos ao responder às perguntas. Os administradores do Metastore e os proprietários da conexão podem gerenciar ou revogar as permissões de usuário na conexão. Consulte Compartilhar a conexão com o servidor MCP.

nota

As ferramentas de fonte de dados nem sempre são acionadas automaticamente. Se a pesquisa de documentos não iniciar, tente instruir explicitamente Genie Code a usar a ferramenta, por exemplo, "usar o Google Docs" ou "usar o SharePoint".

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.
  • Somente arquivos nativos do Google Workspace (Documentos, Planilhas, Apresentações) são compatíveis. Arquivos PDF, imagens e outros formatos binários não são suportados.
  • Erros de conexão ou de expiração de tokens podem aparecer na saída do agente. Autentique-se novamente para resolver o problema.

Limitações do SharePoint​

  • O tamanho máximo do arquivo é de 10 MB.
  • Os tipos de arquivo suportados incluem documentos do Office (.docx, .xlsx, .pptx), bem como formatos comuns baseados em texto, como .txt, .csv, .json, .md, e outros. Arquivos PDF, imagens e outros formatos binários não são suportados.

Adicione servidores MCP ao Genie Code manualmente.​

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

  1. Abra as configurações do Genie Code. No painel do Código Genie, clique em Ícone de engrenagem. Configurações .

  2. Em Servidores MCP , clique em Novo ícone. Adicionar servidor .

  3. Selecione os servidores MCP que deseja adicionar. Você pode selecionar servidores MCP gerenciados Databricks ou servidores MCP externos:

    • FunçãoUnity Catalog : Selecione o esquema para a função. Isso permite que Genie Code utilize funções para executar consultas SQL predefinidas.

    • Pesquisa vetorial : Selecione o esquema para o índice. Isso permite que o Genie Code consulte o índice de pesquisa vetorial para encontrar documentos relevantes.

    • Espaço Genie : Selecione o espaço Genie. O Genie MCP invoca Genie como uma ferramenta, permitindo que você consulte o espaço Genie para analisar o uso de dados em linguagem natural.

    • Servidor MCP externo : Selecione a conexão Unity Catalog a ser usada como servidor MCP externo. Você precisa log in na conexão antes de poder usá-la.

    • Servidor MCP personalizado : Selecione o aplicativo Databricks que deseja usar como servidor MCP personalizado. Isso permite que você utilize quaisquer ferramentas personalizadas. Os seguintes requisitos se aplicam:

      • Seu aplicativo deve ser implantado no mesmo workspace a partir 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 durante a execução do aplicativo, talvez seja necessário adicionar a URL do seu workspace à lista de origens permitidas do seu aplicativo. Por exemplo, defina app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).

  4. Clique em Salvar .

Após serem 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 irá utilizar automaticamente esses servidores quando necessário.

Atualmente, o acesso ao MCP está limitado a 20 ferramentas em todos os servidores. Você pode escolher quais ferramentas e servidores ativar ou desativar nas configurações do seu Genie Code.

On this page