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 a sua organização bloqueia o login, consulte Configuração adicional de aplicativo de terceiros.
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
Os administradores do Slack, Google Workspace, Microsoft 365 ou GitHub podem precisar aprovar ou configurar o aplicativo Databricks antes que os usuários possam fazer login. Para os passos de cada provedor, consulte Configuração adicional de aplicativos de terceiros.
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.