Conecte o Genie Code aos servidores MCP

O Genie Code se conecta a ferramentas, documentos e dados externos por meio de servidores do Protocolo de Contexto de Modelo (MCP) e conectores nativos para Google Drive, SharePoint, GitHub, Glean, Atlassian e Slack. Use os conectores nativos para fontes SaaS comuns ou adicione seus próprios servidores MCP externos ou personalizados a partir do workspace. É possível escolher quais ferramentas habilitar nas configurações do Genie Code.

O que é MCP?

MCP é um padrão de código aberto que conecta agentes a ferramentas, recursos, prompts e outras informações contextuais. O MCP oferece uma forma padronizada de expor ferramentas, dados e fluxos 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 é difícil de acessar por um agente, como o Genie Code. O MCP oferece uma maneira segura de dar acesso ao Genie Code a contextos como os seguintes:

• Sistemas de documentação : As equipes geralmente mantêm manuais operacionais ou documentos operacionais em ferramentas como o 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 IA, que o Genie Code pode usar para consultar documentos relevantes.
• Ferramentas e serviços : Equipes de plataforma podem manter APIs ou scripts para configuração, validação ou implantação. O MCP disponibiliza essas capacidades diretamente ao Genie Code.
• Fontes de dados: Se você já tiver dados no Databricks, é possível conectar o Genie Code a um Genie Agent para ajudar a analisar os dados usando linguagem natural. Para dados armazenados fora do Databricks, é possível conceder ao Genie Code acesso seguro através 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 o Genie Code a quaisquer servidores MCP em seu Workspace aos quais você tenha permissão para usar. Os administradores do Workspace 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.

Use conectores nativos para 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.

O Genie Code oferece conectores integrados para fontes de dados empresariais comuns, incluindo Google Drive, SharePoint, GitHub, Glean, Atlassian e Slack.

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 Genie Code no canto superior direito para abrir um bate-papo.
2. Na barra de prompts, clique 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.

Depois de autenticado, o Genie Code pode pesquisar seus documentos ao responder a perguntas. Administradores de metastore e proprietários de conexão podem gerenciar ou revogar permissões de usuário na conexão. Consulte Etapa 4. Conceder acesso aos colegas de equipe.

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

• Ao autorizar o Google Drive, você poderá ver uma tela de "aplicativo não verificado". Clique em Avançado e continue o processo de autorização.
• 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.

nota

O uso e a transferência de dados de usuário brutos ou derivados recebidos das APIs do Google Workspace aderirão à Política de Dados de Usuário dos serviços de API do Google, incluindo os requisitos de Uso Limitado.

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.

Limitações do GitHub

• Por default, o conector Databricks GitHub MCP pode acessar apenas repository públicos. Para dar acesso de leitura ao conector aos seus repositories empresariais privados, um administrador da organização do GitHub deve concluir uma configuração adicional. Consulte Habilitar acesso a repository privado.
• O GitHub Enterprise Server (a versão auto-hospedada do GitHub) não é compatível.

Limitações do Glean

• Um administrador de metastore deve primeiro configurar o tenant ID do Glean antes que usuários não administradores possam usar a conexão. O administrador pode inserir o ID do tenant ao conectar-se ao Glean pela primeira vez.
• Para se conectar a um servidor MCP do Glean específico, um administrador de metastore pode, opcionalmente, definir o caminho do servidor MCP (por exemplo, /mcp/eng) ao configurar a conexão. Deixe este campo em branco para usar o caminho default (/mcp/default). Usuários não administradores não podem especificar ou alterar o caminho do servidor MCP do Glean.

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. Abrir configurações do Genie Code. No painel Genie Code, clique em Configurações .

2. Em Servidores MCP , clique em 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.

     • Para obter ajuda na criação de um servidor MCP personalizado do GitHub, consulte Pesquisar código do GitHub com o Genie Code.

   • Pesquisa de IA : selecione o esquema para o índice. Isso permite que o Genie Code consulte o índice de Pesquisa de AI para encontrar documentos relevantes.

   • Genie Agent : Selecione o Genie Agent. O Genie MCP invoca o Genie como uma ferramenta, permitindo consultar o Genie Agent para analisar dados usando 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, talvez seja necessário adicionar o 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 .

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

É possível escolher quais ferramentas e servidores habilitar ou desabilitar nas configurações do Genie Code.

Limitações

• Servidores MCP externos estão disponíveis apenas em regiões onde o Servindo Modelo é suportado. Consulte disponibilidade do recurso do modelo disponível.