Conectar o Genie One a aplicativos externos com MCP
O Genie One pode alcançar conteúdo fora do Databricks de duas maneiras: o Genie Search, que um administrador account configura para toda a account, e os conectores MCP, com os quais cada usuário se conecta usando suas próprias credenciais. A Databricks recomenda usar ambos. Veja Genie Search e conectores MCP. Esta página cobre os conectores MCP.
Conecte o Genie One a aplicativos como Gmail e Slack com conectores MCP. O Genie One pode então procurar informações em tempo real, como o status atual de um problema do Jira. Também pode tomar medidas, como rascunhar um email, postar em um canal do Slack ou atualizar um problema. Os administradores controlam o acesso e as políticas da maioria dos conectores por meio do Unity Gateway.
Cada usuário é autenticado individualmente, então o Genie One funciona dentro das permissões de cada usuário. Os tokens OAuth não são compartilhados entre os usuários.
Tipos de conectores MCP
Você pode conectar o Genie One aos seguintes tipos de servidores MCP:
- Conectores fornecidos pelo Databricks : Conectores hospedados pelo Databricks para aplicativos comuns. Não há nenhum servidor para hospedar e nenhum aplicativo OAuth para registrar. Consulte Conectores fornecidos pelo Databricks.
- Servidores MCP do Databricks Marketplace : Servidores MCP que os provedores listam no Databricks Marketplace. Consulte Obter acesso a servidores MCP externos.
- Serviços MCP personalizados : servidores MCP que sua organização registra no Unity Catalog. Consulte Conectar um serviço MCP personalizado.
Os conectores fornecidos pelo Databricks e os serviços MCP, incluindo servidores instalados no marketplace, estão em execução por meio do Unity Gateway. Antes de cada chamada de ferramenta, o gateway verifica se o usuário tem EXECUTE no MCP e registra logs de uso e auditoria em tabelas do sistema. Os administradores também podem limitar quais ferramentas estão disponíveis e aplicar políticas de serviço (Beta), por exemplo, para bloquear dados confidenciais ou exigir aprovação para uma chamada de ferramenta.
As exceções são o Glean (Beta) e as conexões MCP legadas, que são conexões do Unity Catalog que não estão registradas como serviços MCP. Eles não passam pelo gateway, portanto esses controles não se aplicam a eles. Consulte Governar um MCP.
Conectores fornecidos pelo Databricks
Os conectores suportados incluem:
- Google Drive : pesquise e crie Google Docs, Planilhas e Apresentações; edite os Docs criados por ele.
- Gmail : pesquise, leia e rascunhe email.
- Google Calendar : pesquise e crie eventos de calendário.
- Microsoft 365 : pesquise no SharePoint, Teams, Outlook e Calendário; rascunhe um email do Outlook.
- Atlassian : Pesquise e atualize o Jira e o Confluence.
- Asana : Pesquise tarefas, projetos, portfólios, usuários e equipes, e crie ou atualize tarefas quando ações de escrita forem permitidas.
- Glean (Beta): Pesquise nos aplicativos conectados da sua organização usando o Glean.
- Slack : pesquise mensagens e canais do Slack e envie mensagens.
- GitHub : Pesquise e atualize repositories, issues e pull requests.
Para usar esses conectores em um Genie Agent em vez de um Genie One, consulte Conectar um Genie Agent a ferramentas e fontes MCP.
Conectar um aplicativo externo
-
Na página inicial do Genie One, clique no ícone de adição
no canto inferior esquerdo da barra de pesquisa.
-
Clique em Conectores e selecione um aplicativo.
Para conectar aplicativos adicionais, clique em Navegar pelos conectores na parte inferior da lista. Para adicionar um serviço MCP personalizado, consulte Conectar um serviço MCP personalizado.
-
Clique em Entrar e conclua os passos para fazer login.
Se sua organização bloquear o login, consulte Obter aprovação do administrador para conectores.
A conexão é adicionada à sua conversa. O Genie One agora pode usar suas ferramentas para buscar informações e tomar medidas. Consulte Compartilhar um MCP.
As ferramentas de connector podem nem sempre Trigger automaticamente. Se uma ferramenta não executar, tente solicitar explicitamente ao chat que a utilize, por exemplo "use Google Drive" ou "use SharePoint."
Conectar um serviço MCP personalizado
Você pode conectar o Genie One a qualquer servidor MCP registrado como um serviço MCP no Unity Catalog:
- registro seu próprio servidor : registro um servidor MCP externo ou auto-hospedado. Consulte Servidores MCP externos.
- Instalar do Marketplace : Instale um servidor MCP listado no Databricks Marketplace. A instalação cria um serviço MCP no esquema do Unity Catalog que você escolher. Consulte Obter acesso a servidores MCP externos.
Depois que o serviço MCP existir e você tiver acesso a ele, adicione-o a uma conversa de chat em Navegar conectores . Consulte Compartilhar um MCP. Se o serviço usar OAuth por usuário, cada usuário deverá entrar antes de usá-lo.
Reconectar um aplicativo
Se um administrador aprovar novas permissões para um aplicativo depois que você entrar nele, revogue suas credenciais e entre novamente para que sua conexão obtenha as novas permissões:
- Na página inicial do Genie One, clique no ícone de adição
no canto inferior esquerdo da barra de pesquisa.
- Clique em Conectores e em Navegar pelos conectores .
- Clique no aplicativo.
- Clique na seta para baixo
ao lado de Connected e, em seguida, clique em Revoke credentials .
- Clique em Usar conector e conclua os passos para fazer login.
Quando o login for concluído, o botão exibirá Conectado novamente.
Ações de gravação
Algumas ferramentas MCP conectadas podem realizar ações de gravação no aplicativo de origem, não apenas pesquisar e ler dados. Se uma conexão pode gravar, e quais ações ela pode realizar, depende da ferramenta, dos escopos OAuth aos quais você consente ao se conectar e de suas próprias permissões no aplicativo de origem.
Escopos OAuth
Ao conectar um aplicativo externo, seu provedor solicita que você forneça consentimento para um conjunto de escopos OAuth. Os escopos definem o conjunto máximo de ações que uma conexão pode tentar em seu nome. Cada usuário consente individualmente. O que uma conexão pode acessar também depende das suas próprias permissões no aplicativo de origem e de quaisquer políticas que seus administradores do Databricks definam no Unity Gateway.
O Databricks gerencia as credenciais OAuth para essas conexões. Para ver a lista completa de escopos que cada provedor OAuth gerenciado solicita e a finalidade de cada escopo, consulte Provedores OAuth gerenciados. O conjunto exato de escopos solicitados para uma conexão aparece na tela de consentimento do provedor quando você se conecta.
Para obter orientações de compliance para aplicativos conectados, consulte Requisitos do provedor externo.
Controles do administrador
Para conectores que são executados por meio do Unity Gateway, os administradores controlam quem pode usar cada conector e quais de suas ferramentas estão disponíveis, e podem aplicar políticas de serviço (Beta) a chamadas de ferramenta. Consulte Governar um MCP.
Obter aprovação do administrador para conectores
Dois grupos de administradores controlam se os usuários podem fazer login em um connector e o que a conexão pode fazer:
- Administradores de provedores : os administradores do Slack, Google Workspace, Microsoft Entra ID ou GitHub da sua organização decidem se os usuários podem autorizar o aplicativo e quais permissões ele recebe, como escopos OAuth ou acesso a repository do GitHub. Frequentemente, eles não são seus administradores do Databricks.
- Administradores do Databricks : Usuários com o privilégio
MANAGEno MCP de um conector decidem quais ferramentas estão disponíveis e quem pode chamá-las. Consulte Reger um MCP.
Se um provedor bloqueia o login ou limita o que um conector pode acessar, compartilhe os passos para esse provedor com seu administrador. Depois que o administrador aprovar o aplicativo, saia do conector e entre novamente para obter as permissões aprovadas. Consulte Gerenciar o login do provedor.
Aprovar o aplicativo Databricks Genie no Slack
Se o seu workspace do Slack exigir aprovação de aplicativo, a tela de login do Slack avisará que o aplicativo provavelmente está bloqueado. O Slack também pode remover permissões que um administrador não aprovou. Por exemplo, o login é bem-sucedido, mas o conector não pode enviar mensagens.
Um proprietário de Workspace do Slack ou gerente de aplicativo deve aprovar o aplicativo Databricks Genie:
- No Slack, clique em Admin na barra lateral.
- Selecione Apps and workflows (Aplicativos e fluxos de trabalho) para abrir o Marketplace do Slack.
- Clique em Procurar e, em seguida, pesquise e selecione Databricks Genie .
- Revise as permissões solicitadas e clique em Aprovar . A permissão Enviar mensagens em nome de um usuário (
chat:write) permite que os usuários enviem mensagens por meio do conector.
Se um usuário já tiver solicitado o aplicativo, o Workspace Owner ou o gerente do aplicativo poderá aprovar a solicitação pendente. Consulte Gerenciar a aprovação de aplicativos para seu workspace.
Quando o Databricks adiciona uma permissão ao conector, o Slack solicita aprovação novamente. Até que a nova permissão seja aprovada, o login falha ou o Slack descarta a nova permissão.
Ao entrar novamente, verifique as ações que o Databricks Genie pode executar na tela de login do Slack. A lista deve incluir o envio de mensagens. Se o conector ainda não conseguir enviar mensagens, peça a um administrador do metastore ou a outro usuário com MANAGE em system.ai.slack para verificar suas ferramentas:
- No Unity Gateway , selecione MCPs e abra
system.ai.slack. - Em Overview , clique em Edit tools .
- Confirme se as ferramentas que enviam mensagens estão selecionadas e clique em Salvar alterações .
Consulte Escolher ferramentas disponíveis.
Permitir os conectores no Google Workspace
Se o login do Google mostrar um erro de acesso bloqueado ou disser que a política do seu administrador bloqueia o aplicativo, seu administrador do Google Workspace restringe quais aplicativos de terceiros podem acessar os dados do Google. Os conectores do Google Drive, Gmail e Google Calendar usam o mesmo aplicativo Google OAuth, então uma configuração cobre todos os três.
Um administrador do Google Workspace com o privilégio de administrador de Configurações de Serviço deve configurar o aplicativo:
- No console de administração do Google, acesse Security > Access and data control > API controls .
- Clique em Gerenciar Acesso ao App .
- Para Aplicativos configurados , clique em Configurar novo aplicativo .
- Insira o ID do cliente
645306276512-s5jbhbhff6irpdq1fpt2f21pcrf4agqs.apps.googleusercontent.com, clique em Pesquisar e clique no aplicativo nos resultados da pesquisa. - Para Escopo , mantenha a unidade organizacional superior selecionada para configurar o acesso para todos os usuários ou clique em Selecionar unidades organizacionais para escolher unidades organizacionais específicas. Clique em Continuar .
- Para Acesso a dados do Google , selecione Confiável . Para permitir apenas os escopos que os conectores solicitam, selecione Dados específicos do Google e adicione os escopos listados em Provedores OAuth gerenciados. Clique em Continuar .
- Revise as configurações e clique em Concluir .
O aplicativo aparecerá na lista Aplicativos configurados com o nível de acesso que você selecionou. Consulte Controlar quais aplicativos acessam dados do Google Workspace.
Aprovar permissões do Microsoft 365
O conector Microsoft 365 solicita suas permissões do Microsoft Graph para SharePoint, OneDrive, Teams, Outlook, Calendar e reuniões online em um único consentimento. Usuários e administradores não podem consentir apenas com alguns deles, como apenas as permissões de e-mail do Outlook. Para a lista completa, veja Escopos do Microsoft 365.
Permissões que terminam com .All normalmente requerem consentimento do administrador. Se sua organização exigir aprovação do administrador, compartilhe o nome do aplicativo na tela de consentimento com seu administrador do Microsoft Entra ID.
Para limitar o que o conector pode fazer, um administrador de metastore ou outro usuário com MANAGE em system.ai.microsoft_365 pode remover suas ferramentas de escrita. Veja Escolher ferramentas disponíveis. A remoção de ferramentas controla quais ferramentas o conector pode chamar. Isso não altera as permissões que a tela de consentimento solicita.
Habilitar acesso de gravação no GitHub e acesso a repository privados
Por default, o conector GitHub (system.ai.github) pode ler apenas repository públicos. Para acessar repository privados ou fazer alterações, como fazer commit de arquivos ou criar issues e pull requests, o proprietário do repository ou um administrador da organização do GitHub deve:
-
Instale o aplicativo de conector GitHub do Databricks e conceda acesso aos repository necessários.
Para AWS GovCloud, use o aplicativo databricks-gh-connector-gov-cloud.
-
Se a organização usar uma lista de permitidos de IP, adicione os IPs de saída serverless do Databricks para o cloud e a região do seu workspace.
Após a instalação do aplicativo, os usuários podem trabalhar com os repository concedidos por meio do conector, dentro de suas próprias permissões do GitHub.
Limitações
As conexões externas estão disponíveis apenas em regiões onde o Unity Gateway é suportado.
Consulte regiões compatíveis.
Tarefas programadas e autenticação
- O chat não avisa quando a autenticação de uma conexão expira. Você só descobre quando uma chamada de ferramenta falha ou quando abre a lista de conexões. Autentique-se novamente para resolver.
- A alteração das permissões de uma conexão exige que cada usuário se autentique novamente. As tarefas agendadas que usam a conexão falham até que o usuário se autentique novamente.
Google Drive
- Ao autorizar o Google Drive, você poderá ver uma tela de App não verificado . Clique em Avançado e continue o processo de autorização.
- Maximum file size is 25 MB.
- Apenas arquivos nativos do Google Workspace (Docs, Sheets, Slides) são compatíveis. PDFs, imagens e outros formatos binários não são compatíveis.
- O conector pode criar Google Docs, Planilhas e Apresentações, além de editar arquivos do Google Docs criados por ele. Ele não pode editar documentos criados fora do conector, nem editar Planilhas ou Apresentações existentes.
- Ler um documento muito grande pode ser lento.
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 da API do Google, incluindo os requisitos de Uso Limitado.
Gmail
- The connector can search, read, and draft email, but it can't send email or edit existing messages.
- O conector não pode adicionar arquivos do Drive como anexos nativos do Gmail. Como solução alternativa, inclua links para os arquivos no corpo do email.
Microsoft 365
- Inclui SharePoint, OneDrive, Teams, Outlook, Calendário e reuniões online.
- O conector pode redigir um email do Outlook, mas não pode enviá-lo.
- O tamanho máximo do arquivo é de 25 MB para arquivos do SharePoint.
- Os tipos de arquivo SharePoint suportados incluem documentos SharePoint integrados, planilhas e apresentações, bem como formatos comuns baseados em texto, como
.txt,.csv,.json,.mde outros. PDFs, imagens e outros formatos binários não são compatíveis.
Glean (Beta)
- Glean é apenas de pesquisa. Ele não consegue ler um documento de um Link direto.
- Um administrador do metastore deve primeiro configurar o ID do tenant 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 Glean MCP 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 Glean MCP.
Slack
- O conector não pode editar ou excluir uma mensagem após o envio.
GitHub
- As gravações são limitadas a conteúdos de arquivos, problemas (issues) e solicitações pull (pull requests).
- Por default, o conector MCP do GitHub do Databricks pode acessar apenas repository. Para acessar repository privados ou fazer alterações, como fazer commit de arquivos ou criar problemas e pull requests, o proprietário do repository ou um administrador da organização do GitHub deve concluir a configuração adicional. Consulte Habilitar acesso de escrita no GitHub e acesso a repository privados.
- Servidor corporativo GitHub (a versão auto-hospedada do GitHub) não é suportado.