Conectores de servidor MCP do Google Workspace nos apps Gemini Enterprise

1. Introdução

Observação: está usando o Antigravity? Acesse este codelab. Este guia é específico para o Gemini Enterprise.

Neste codelab, você vai aprender a usar o Protocolo de Contexto de Modelo (MCP) para conectar apps do Gemini Enterprise aos apps do Google Workspace. O MCP é um padrão aberto que permite que os modelos de IA usem com segurança ferramentas fornecidas por servidores remotos. Você vai configurar os apps do Gemini Enterprise para interagir com o Gmail, o Google Drive, o Google Docs, o Google Planilhas, o Google Slides, o Google Agenda, o Google Chat e a API People sem escrever nenhum código.

Atividades deste laboratório

• Ative os serviços do MCP do Google Workspace no seu projeto na nuvem do Google Cloud.
• Crie e configure um app do Gemini Enterprise para acessar esses serviços do MCP.
• Teste a integração com comandos divertidos e úteis que interagem com seus dados do Google Workspace.

O que é necessário

• Um navegador da Web, como o Chrome.
• Um projeto na nuvem do Google Cloud inscrito no Programa de prévia para desenvolvedores do Google Workspace.
• Uma conta do Google Cloud com o papel Organization Policy Administrator.
• Um projeto do Google Cloud em que você é proprietário com faturamento. Para verificar se um projeto atual tem o faturamento ativado, consulte Verificar o status de faturamento dos seus projetos. Para criar um projeto na nuvem e configurar o faturamento, consulte Criar um projeto do Google Cloud. Para mudar a propriedade do projeto, consulte Gerenciar membros do projeto ou mudar a propriedade do projeto.
• As edições Gemini Enterprise Standard / Plus estão ativadas. Para comparar as edições do Gemini Enterprise, consulte este link. Se você não tiver uma licença do Gemini Enterprise, poderá criar uma licença de teste na próxima etapa.
• Uma conta do Google Workspace Business ou Enterprise com acesso ao Google Chat e aos recursos inteligentes ativados.

Acesso fácil a este codelab

2. Antes de começar

Programa de prévia para desenvolvedores do Google Workspace: o acesso aos servidores MCP do Google Workspace faz parte do programa de prévia pública para desenvolvedores. Se ainda não tiver feito isso, inscreva-se e verifique se sua conta foi aceita no programa em https://developers.google.com/workspace/preview.

Inicializar o app do Gemini Enterprise

No console do Google Cloud, siga estas etapas:

1. Selecione o projeto.
2. No campo de pesquisa do Google Cloud, pesquise e selecione Gemini Enterprise e clique em + Criar app. Se você não tiver uma licença do Gemini Enterprise, será solicitado que ative uma licença de teste sem custo financeiro de 30 dias.

Acessar a criação de apps do Gemini Enterprise

3. Defina o Nome do app como codelab.
4. Defina a Multirregião como global (Global).
5. Clique em Criar.

6. O app é criado, e você é redirecionado automaticamente para Gemini Enterprise > Visão geral.
7. Em Concluir sua configuração, clique em Configurar identidade.
8. Na nova tela, selecione Usar o Google Identity e clique em Confirmar a identidade de colaboradores.

9. A configuração é salva, e você é redirecionado automaticamente para Gemini Enterprise > Visão geral.

Desativar a política da organização do servidor MCP personalizado

Por padrão, o Gemini Enterprise bloqueia a criação de repositórios de dados personalizados do MCP usando uma restrição de política da organização gerenciada.

Para criar repositórios de dados personalizados do servidor MCP, é necessário substituir a restrição de política da organização gerenciada atual. No console do Google Cloud, siga estas etapas:

1. Acesse a página Políticas da Organização.

Acessar a página Políticas da organização

2. No campo Filtro, digite Disable custom mcp server connector for gemini enterprise.
3. Clique no nome da política para acessar a página de detalhes dela.
4. Clique em Gerenciar política.
5. Selecione a opção Substituir política do recurso pai.
6. Adicione uma nova regra e defina o botão de aplicação como DESATIVADO.
7. Clique em Definir política.

Ative as APIs

Para usar os servidores MCP do Google Workspace, é necessário ativar as APIs padrão do Google Workspace.

Ativar as APIs

Ativar serviços do MCP

Em seguida, ative os serviços do MCP do Google Workspace.

Ativar os serviços do MCP

Configurar o app do Chat

Para usar o servidor MCP do Google Chat, configure um app do Chat no seu projeto do Google Cloud.

1. No console do Google Cloud, pesquise API Google Chat e clique em API Google Chat > Gerenciar > Configuração.

Acessar a API Google Chat

2. Configure o app do Chat:
   • No campo Nome do app, digite Chat MCP.
   • No campo URL do avatar, digite https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • Em Descrição, insira Chat MCP server.
   • Em Funcionalidade, desative a opção Ativar recursos interativos.
   • Em Registros, selecione Registrar erros no Logging.
3. Clique em Salvar.

3. Configurar o consentimento e o cliente do OAuth

Os servidores MCP do Google Workspace usam o OAuth 2.0 para autenticação e autorização seguras. É necessário configurar uma tela de permissão OAuth e criar um cliente de aplicativo da Web.

Configurar a tela de permissão OAuth

Primeiro, configure a tela de permissão.

1. No console do Google Cloud, acesse Plataforma Google Auth > Branding. Clique em Começar se não estiver configurado.
2. Configure as Informações do app:
   • Nome do app: Google Workspace MCP Servers
   • E-mail para suporte do usuário: selecione seu e-mail.
3. Configure o Público-alvo: selecione Interno (ou Externo, se a opção "Interno" não estiver disponível).
4. Configure os Dados de contato: insira seu endereço de e-mail.
5. Leia e aceite a Política de Dados do Usuário e clique em Criar.
6. Se você selecionou Externo, acesse Público-alvo e adicione seu e-mail em Usuários de teste.
7. Acesse Acesso aos dados > Adicionar ou remover escopos. Em Adicionar escopos manualmente, adicione o seguinte para os servidores que você quer usar:
   • Universal: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Google Docs: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/documents.readonly, https://www.googleapis.com/auth/documents
   • Google Planilhas: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/spreadsheets.readonly, https://www.googleapis.com/auth/spreadsheets
   • Google Slides: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/presentations.readonly, https://www.googleapis.com/auth/presentations
   • Google Agenda: https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat: https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.messages.create, https://www.googleapis.com/auth/chat.users.readstate.readonly
   • API People: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. Clique em Adicionar à tabela, em Atualizar e em Salvar.

Criar um ID do cliente OAuth

1. Acesse Google Auth Platform > Clientes > Criar cliente.
2. Selecione Aplicativo da Web como o tipo de aplicativo.
3. Dê o nome codelab a ela.
4. Em URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://vertexaisearch.cloud.google.com/oauth-redirect.
5. Selecione Usar este cliente para um agente com tecnologia de IA.
6. Clique em Criar e copie o ID do cliente e a chave secreta do cliente. Você vai precisar deles na próxima etapa.

4. Configurar o app do Gemini Enterprise

Agora vamos configurar o app do Gemini Enterprise para usar esses endpoints como conectores de servidor MCP personalizados.

Universal

Abra o Gemini Enterprise no console do Cloud e siga estas etapas:

1. Clique no app chamado codelab.
2. No menu de navegação, clique em Repositórios de dados conectados.
3. Clique em + Novo repositório de dados.
4. Em Origem, pesquise Servidor MCP personalizado e clique em Adicionar servidor MCP.

5. Na seção Dados:
   1. Defina o URL do servidor MCP como https://workspacemcp.googleapis.com/mcp/v1.
   2. Defina o URL de autorização como https://accounts.google.com/o/oauth2/auth.
   3. Defina o URL do token como https://oauth2.googleapis.com/token.
   4. Defina o ID do cliente e a chave secreta do cliente com os valores salvos nas etapas anteriores.
   5. Defina os escopos como https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/chat.messages.readonly.
   6. Clique em Verificar autenticação e siga as etapas para autenticar e autorizar o cliente OAuth.
   7. Clique em Continuar e depois em Continuar.

6. Na seção Configuração, defina o Nome do conector de dados como gws-mcp-universal.
7. Clique em Criar.
8. Você será redirecionado automaticamente para a página de configuração do repositório de dados recém-criado.
9. Acesse Ações.
10. Clique em Atualizar ações personalizadas, selecione todas e clique em Ativar ações.

Gmail

Siga as mesmas etapas realizadas anteriormente para o Google Agenda, com o Nome do conector de dados definido como gws-mcp-gmail na seção Configuração e com os seguintes valores definidos na seção Dados:

1. Defina o URL do servidor MCP como https://gmailmcp.googleapis.com/mcp/v1.
2. Defina os escopos como https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.compose.

Google Drive

Siga as mesmas etapas realizadas anteriormente para o Google Agenda, com o Nome do conector de dados definido como gws-mcp-drive na seção Configuração e com os seguintes valores definidos na seção Dados:

1. Defina o URL do servidor MCP como https://drivemcp.googleapis.com/mcp/v1.
2. Defina os escopos como https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file.

Google Docs

Siga as mesmas etapas realizadas anteriormente para o Google Agenda, com o Nome do conector de dados definido como gws-mcp-docs na seção Configuração e com os seguintes valores definidos na seção Dados:

1. Defina o URL do servidor MCP como https://docsmcp.googleapis.com/mcp/v1.
2. Defina os escopos como https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/documents.readonly https://www.googleapis.com/auth/documents.

Google Planilhas

Siga as mesmas etapas realizadas anteriormente para o Google Agenda, com o Nome do conector de dados definido como gws-mcp-sheets na seção Configuração e com os seguintes valores definidos na seção Dados:

1. Defina o URL do servidor MCP como https://sheetsmcp.googleapis.com/mcp/v1.
2. Defina os escopos como https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/spreadsheets.

Google Slides

Siga as mesmas etapas realizadas anteriormente para o Google Agenda, com o Nome do conector de dados definido como gws-mcp-slides na seção Configuração e com os seguintes valores definidos na seção Dados:

1. Defina o URL do servidor MCP como https://slidesmcp.googleapis.com/mcp/v1.
2. Defina os escopos como https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/presentations.

Google Agenda

Siga as mesmas etapas realizadas anteriormente para o Google Agenda, com o Nome do conector de dados definido como gws-mcp-calendar na seção Configuração e com os seguintes valores definidos na seção Dados:

1. Defina o URL do servidor MCP como https://calendarmcp.googleapis.com/mcp/v1.
2. Defina os escopos como https://www.googleapis.com/auth/calendar.calendarlist.readonly https://www.googleapis.com/auth/calendar.events.freebusy https://www.googleapis.com/auth/calendar.events.readonly.

Google Chat

Siga as mesmas etapas realizadas anteriormente para o Google Agenda, com o Nome do conector de dados definido como gws-mcp-chat na seção Configuração e com os seguintes valores definidos na seção Dados:

1. Defina o URL do servidor MCP como https://chatmcp.googleapis.com/mcp/v1.
2. Defina os escopos como https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.users.readstate.readonly.

API People

Siga as mesmas etapas realizadas anteriormente para o Google Agenda, com o Nome do conector de dados definido como gws-mcp-people-api na seção Configuração e com os seguintes valores definidos na seção Dados:

1. Defina o URL do servidor MCP como https://people.googleapis.com/mcp/v1.
2. Defina os escopos como https://www.googleapis.com/auth/directory.readonly https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/contacts.readonly.

Verificar status

Após alguns minutos, o status dos conectores será Ativo. Se houver erros, clique na fonte de dados para ver os detalhes.

5. Ferramentas de teste

Agora você pode interagir com seus dados do Google Workspace usando linguagem natural. Confira alguns exemplos de comandos para cada serviço.

Observação: substitua os marcadores entre colchetes nos comandos abaixo (por exemplo, [NAME], [FILE_NAME]) por valores reais dos seus dados do Google Workspace.

Inicializar o web app Gemini Enterprise

Abra o Gemini Enterprise no console do Cloud em uma nova guia e siga estas etapas:

1. Clique no app chamado codelab.
2. Clique no URL exibido para abrir o web app do Gemini Enterprise em uma nova guia.
3. No rodapé do campo de nova mensagem de chat, clique no ícone Conectores e autorize todos eles.

Universal

Tente pesquisar em produtos diferentes:

• "Resuma em algumas frases o que aconteceu recentemente na minha conta do Google Workspace."
• "Encontre tudo relacionado a [NOME_DO_PROJETO] nos meus e-mails, documentos e mensagens de chat."
• "Quando é minha próxima reunião sobre o plano de marketing e quais são as últimas notas e mensagens de chat sobre ele?"

Gmail

Tente pesquisar ou gerenciar seus e-mails:

• "Resuma os últimos 5 e-mails que recebi."
• "Escreva um e-mail para '[EMAIL_ADDRESS]' pedindo uma atualização sobre o projeto '[PROJECT_NAME]'."

Google Drive

Tente pesquisar ou ler arquivos:

• "Pesquise arquivos no meu Google Drive que contenham '[PALAVRA-CHAVE]'."
• "Liste os documentos mais recentes que editei."
• "Leia o conteúdo do meu documento '[FILE_NAME]' e resuma os objetivos principais."

Google Docs, Planilhas, Slides

Tente pesquisar seus recursos do Drive:

• "Mostre o conteúdo estrutural do documento Google [DOCS_TITLE]."
• "Ler a planilha Sheet1 do arquivo do Google Planilhas [SHEETS_TITLE]"
• "Mostre o layout verbalizado da apresentação do Google Slides [SLIDES_TITLE]."

Google Agenda

Tente pesquisar sua programação:

• "Quais são minhas próximas reuniões esta semana?"
• "Tenho algum tempo livre amanhã à tarde?"

Google Chat

Tente pesquisar mensagens:

• "Procure mensagens que contenham '[PALAVRA-CHAVE]' em '[NOME_DO_ESPAÇO]'"

API People

Tente pesquisar seu perfil ou contatos:

• "De acordo com meu perfil do Google, qual é meu nome?"
• "Encontrar dados de contato de '[NOME]'."

Como combinar vários serviços

O verdadeiro poder do MCP é percebido ao orquestrar tarefas em vários serviços. Teste estes comandos que mostram os recursos de vários serviços:

• "Pesquise no Drive arquivos relacionados a 'atualizações de marcos do [NOME_DO_PROJETO]', resuma o conteúdo deles, encontre o endereço de e-mail de '[NOME]' e crie um rascunho do Gmail para essa pessoa com o resumo."

Conheça mais ferramentas

Estes são apenas alguns exemplos do que você pode fazer. Para conferir a lista completa de ferramentas disponíveis para cada serviço e testá-las, consulte a seção Produtos compatíveis da documentação oficial.

6. Limpar

Excluir projeto do Google Cloud

Para evitar cobranças na conta do Google Cloud pelos recursos usados neste codelab, é recomendável excluir o projeto do Google Cloud.

Atenção: a exclusão de um projeto do Google Cloud resulta no seguinte:

• Tudo no projeto é excluído. Se você usou um projeto existente neste codelab, vai excluir outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um ID do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL em appspot.com, exclua os recursos selecionados dentro do projeto em vez de todo o projeto.

No console do Google Cloud, siga estas etapas:

1. Clique em Menu ☰ > IAM e administrador > Configurações.

Acessar IAM e administrador > Configurações

2. Clique em Encerrar.
3. Digite o ID do projeto.
4. Clique em Encerrar mesmo assim.

7. Parabéns

Parabéns! Você configurou e testou os servidores MCP oficiais do Google Workspace nos apps do Gemini Enterprise.

Documentos de referência

• Introdução ao Protocolo de Contexto de Modelo (MCP)
• Configurar servidores MCP do Google Workspace
• Configurar o consentimento do OAuth
• Gemini Enterprise: configurar o repositório de dados do servidor MCP personalizado