Conectar o Genie Code a servidores MCP

O Genie Code se conecta a ferramentas, documentos e dados externos por meio de servidores Model Context Protocol (MCP) e conectores nativos para Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack e GitHub. Use os conectores nativos para fontes SaaS comuns ou adicione seus próprios servidores MCP externos ou personalizados do workspace. Você escolhe quais ferramentas habilitar nas configurações do Genie Code.

O que é MCP?

O MCP é um padrão código aberto que conecta agentes 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 já existe contexto importante, mas ele é difícil de ser acessado por um agente, 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 IA, 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 agente do Genie para ajudá-lo a analisar os dados usando 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 servidores MCP em Databricks e como criar seus próprios, veja MCPs e ferramentas de agentes.

Usar conectores nativos para fontes de dados de terceiros

O Genie Code fornece conectores embutidos para fontes comuns de dados empresariais:

• Google Drive: Buscar e criar Google Docs, Sheets e Slides; editar Docs que ele criou.
• Gmail: Pesquisar, ler e rascunhar e-mails.
• Google Calendário: Pesquise e crie eventos no calendário.
• Microsoft 365: Pesquise em SharePoint, Teams, Outlook e Calendário; rascunhe o e-mail do Outlook.
• Atlassian: Busque e atualize Jira e Confluence.
• Glean (Beta): Pesquise entre os aplicativos conectados da sua organização usando o Glean.
• Slack: Pesquise mensagens e canais do Slack e envie mensagens.
• GitHub: Pesquisar e atualizar repositórios, issues e pull requests.

Conectar a essas fontes de dados permite que o Genie Code pesquise seus documentos e tome ações em ferramentas conectadas ao responder perguntas. Cada usuário é autenticado individualmente e os tokens OAuth não são compartilhados entre os usuários.

Essas conexões usam conectores MCP fornecidos pelo Databricks, então não há servidor para hospedar nem app OAuth para registrar. O Azure Databricks governa toda conexão por meio do Unity Catalog e do Unity Gateway. O gateway autoriza cada chamada de ferramenta com base nas permissões do seu Unity Catalog, aplica políticas integradas e requisitos de aprovação e registra logs de uso e auditoria em tabelas do sistema. Veja Registrar um servidor MCP externo.

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 e proprietários de conexões do Metastore podem gerenciar ou revogar permissões de usuário na conexão. Veja o Passo 4. Conceda acesso a um Serviço MCP.

Observação

As ferramentas de fonte de dados nem sempre são ativadas automaticamente. Se a pesquisa de documentos não for iniciada, tente solicitar explicitamente que o Genie Code use a ferramenta, por exemplo, "use o Google Docs" ou "use SharePoint".

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

Tarefas agendadas e autenticação

• O Código Genie não avisa quando a autenticação de uma conexão expira. Talvez você só descubra isso quando uma chamada a uma ferramenta falhe ou quando abrir a lista de conexões. Autentique novamente para resolver.
• Alterar as permissões de uma conexão exige que cada usuário se autentique novamente. Tarefas agendadas que usam a conexão falham até que o usuário se autentique novamente.

Limitações do Google Drive

• Ao autorizar o Google Drive, você poderá ver uma tela "aplicativo não verificado". Clique em Avançado e continue o processo de autorização.
• O arquivo pode ter no máximo 25 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.
• O Genie Code pode criar Google Docs, Sheets e Slides e editar os documentos do Google Docs que ele criou por meio do conector. Ele não pode editar documentos criados fora do conector, nem editar Sheets ou Slides existentes.
• Ler um documento muito grande pode ser lento.

Observação

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 do Usuário dos serviços de API do Google, incluindo os requisitos de Uso Limitado.

Limitações do Gmail

• O Genie Code pode buscar, ler e redigir e-mails, mas não pode enviar e-mails nem editar mensagens existentes.
• O Genie Code não pode adicionar arquivos do Drive como anexos nativos do Gmail. Como solução alternativa, inclua links para os arquivos no corpo do e-mail.

Limitações do Microsoft 365

• Inclui SharePoint, Teams, Outlook e Calendário.
• O Genie Code pode redigir e-mails do Outlook, mas não pode enviá-lo.
• O tamanho máximo do arquivo é de 25 MB para arquivos SharePoint.
• Tipos de arquivos SharePoint suportados incluem documentos do Office (.docx, .xlsx, .pptx), assim como formatos comuns baseados em texto como .txt, .csv, .json, .md, e outros. PDFs, imagens e outros formatos binários não têm suporte.

Limitações do Glean (Beta)

• Glean é somente para pesquisa. Ele não pode ler um documento a partir de um link direto.
• Um administrador da metastore deve primeiro configurar o ID do tenant Glean antes que usuários não administradores possam usar a conexão. O administrador pode inserir a ID do locatário ao se conectar pela primeira vez ao Glean.
• Para se conectar a um servidor MCP específico do Glean, um administrador da 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 padrão (/mcp/default). Usuários não administradores não podem especificar ou alterar o caminho do servidor MCP do Glean.

Limitações de folga

• O Código Genie não pode editar ou excluir uma mensagem após enviá-la.

limitações de GitHub

• As gravações são limitadas ao conteúdo dos arquivos, problemas e solicitações de pull.
• Por padrão, o conector do Databricks GitHub MCP pode acessar apenas repositórios públicos. Para conceder ao conector acesso de leitura aos repositórios privados da empresa, um administrador de uma organização do GitHub deve concluir uma configuração adicional. Consulte Habilitar acesso ao repositório privado.
• GitHub Enterprise Server (a versão auto-hospedada do GitHub) não tem 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 Código do Genie, 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 criar um servidor MCP personalizado do GitHub, consulte Pesquisar código no 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 IA para localizar documentos relevantes.
   • Agente do Genie: Selecione o Agente do Genie. O Genie MCP invoca o Genie como uma ferramenta, permitindo que você consulte o Agente do Genie para analisar dados usando 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 sem alterar seus prompts ou instruções. O Genie Code se baseia automaticamente nesses servidores quando relevante.

Você pode escolher quais ferramentas e servidores habilitar ou desabilitar nas configurações do Genie Code.

Limitações

Para orientações de conformidade para aplicações conectadas, veja limitações do serviço MCP fornecido pelo Databricks.

• Servidores MCP externos só estão disponíveis em regiões em que o Serviço de Modelo tem suporte. Consulte Modelos de disponibilidade de funcionalidades de serviço.