Comienza a usar la MCP de Google Workspace y la CLI de Gemini

1. Introducción

Nota: ¿Sigues usando Gemini CLI? Consulta este codelab para aprender a configurar servidores de MCP de Google Workspace con la CLI de Antigravity. Puedes encontrar más información sobre la transición en esta entrada de blog oficial.

En este codelab, aprenderás a usar el Protocolo de contexto del modelo (MCP) para conectar la CLI de Gemini a tus datos de Google Workspace. El MCP es un estándar abierto que permite que los modelos de IA usen de forma segura las herramientas que proporcionan los servidores remotos. Usarás la CLI de Gemini como cliente para interactuar con Gmail, Google Drive, el Calendario de Google, Google Chat y la API de People sin escribir código.

Actividades

• Habilita los servicios de MCP de Google Workspace en tu proyecto de Google Cloud.
• Configurar la CLI de Gemini para usar estos servicios de MCP
• Prueba la integración con instrucciones divertidas y útiles que interactúen con tus datos de Google Workspace.

Requisitos

• Un navegador web, como Chrome
• Un proyecto de Google Cloud
• Una cuenta de Google Workspace
• Gemini CLI instalada en tu máquina local

Este codelab tardará aproximadamente 30 minutos en completarse.

Acceso fácil a este codelab

2. Antes de comenzar

Programa de versión preliminar para desarrolladores de Google Workspace: El acceso a los servidores de MCP de Google Workspace forma parte del programa de versión preliminar pública para desarrolladores. Si aún no lo hiciste, regístrate y asegúrate de que tu cuenta se acepte en el programa en https://developers.google.com/workspace/preview.

Crea o selecciona un proyecto de Google Cloud

En la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

Habilita las APIs

Para usar los servidores de MCP de Google Workspace, debes habilitar las APIs estándar de Google Workspace. Si bien algunos servidores de MCP funcionan de forma independiente, otros requieren que la API estándar subyacente esté habilitada:

• Gmail y Chat aún requieren sus APIs estándar.
• Drive requiere la API estándar para ciertas herramientas.
• Calendario no requiere que se habilite la API estándar.
• La API de People controla el acceso estándar y la funcionalidad de MCP, por lo que no tiene un servicio de MCP independiente para habilitar.

Habilitar las APIs

Habilitar los servicios de MCP

A continuación, habilita los servicios de MCP dedicados para los productos.

Habilita los servicios de MCP

Configura la app de Chat

Para usar el servidor de MCP de Google Chat, debes configurar una app de Chat en tu proyecto de Google Cloud.

1. En la consola de Google Cloud, busca API de Google Chat y haz clic en API de Google Chat > Administrar > Configuración.Ir a la API de Google Chat
2. Configura la app de Chat:
   • En el campo Nombre de la app, ingresa Chat MCP.
   • En el campo URL del avatar, escribe https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • En Descripción, ingresa Chat MCP server.
   • En Funcionalidad, desactiva Habilitar funciones interactivas.
   • En Registros, selecciona Registrar errores en Logging.
3. Haz clic en Guardar.

3. Configura el consentimiento de OAuth y el cliente

Los servidores de MCP de Google Workspace usan OAuth 2.0 para la autenticación segura. Debes configurar una pantalla de consentimiento de OAuth y crear un cliente de aplicación de escritorio.

Configura la pantalla de consentimiento de OAuth

Los servidores de MCP de Google Workspace usan OAuth 2.0 para la autenticación. Primero, debes configurar la pantalla de consentimiento.

1. En la consola de Google Cloud, ve a Google Auth Platform > Desarrollo de la marca. Haz clic en Comenzar si no está configurado.
2. Configura la información de la app:
   • Nombre de la app: Google Workspace MCP Servers
   • Correo electrónico de asistencia del usuario: Selecciona tu correo electrónico.
3. Configura Público: Selecciona Interno (o Externo si Interno no está disponible).
4. Configura la Información de contacto: Ingresa tu dirección de correo electrónico.
5. Revisa y acepta la Política de Datos del Usuario y, luego, haz clic en Crear.
6. Si seleccionaste Externo, ve a Público y agrega tu correo electrónico en Usuarios de prueba.
7. Ve a Acceso a los datos > Agregar o quitar permisos. En Agrega permisos manualmente, agrega lo siguiente para los servidores que quieras usar:
   • Calendario de Google: 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.users.readstate.readonly
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • API de People: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile y https://www.googleapis.com/auth/contacts.readonly
8. Haz clic en Agregar a la tabla, luego en Actualizar y, por último, en Guardar.

Crea un ID de cliente de OAuth

Cuando configures un cliente de OAuth 2.0 para los servidores de MCP de Google Workspace, debes habilitar el parámetro de configuración de clasificación de agentes (is_agentic) seleccionando Usa este cliente para un agente potenciado por IA. Los clientes de OAuth que no tengan habilitado este parámetro de configuración no podrán llamar a los extremos del MCP de Google Workspace.

1. Ve a Google Auth Platform > Clientes > Crear cliente (o APIs y servicios > Credenciales > Crear credenciales > ID de cliente de OAuth).
2. Selecciona App para computadoras como el tipo de aplicación.
3. Asígnale el nombre Gemini CLI.
4. Selecciona Usar este cliente para un agente potenciado por IA para habilitar la marca de clasificación is_agentic en el cliente de OAuth.
5. Haz clic en Crear y copia el ID de cliente y el Secreto del cliente. Los necesitarás en el siguiente paso.

4. Configura Gemini CLI

Ahora, configuremos Gemini CLI para usar estos extremos. Si no tienes instalada la CLI de Gemini, sigue las instrucciones de instalación que se encuentran en el sitio web de la CLI de Gemini.

Se requiere un entorno local: No uses Cloud Shell para este paso. Gemini CLI requiere un navegador local para la autenticación de OAuth. Usa la terminal de tu máquina local. Consulta los requisitos de redireccionamiento del navegador para obtener más información.

Cree el archivo de configuración

Abre o crea ~/.gemini/settings.json en tu directorio principal y agrega la siguiente configuración. Reemplaza los marcadores de posición por tus credenciales de OAuth.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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.users.readstate.readonly"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. Autentica y verifica los servidores de MCP

Antes de poder usar los servidores de MCP, debes autenticarte y verificar que estén conectados.

Inicia Gemini CLI

Ejecuta el siguiente comando en la terminal para iniciar la CLI de Gemini:

gemini

Autenticar

Autentícate con los servicios que quieres probar ejecutando el comando correspondiente en Gemini CLI. Solo debes autenticarte con los servicios que planeas usar en este codelab.

Calendario

/mcp auth calendar

Chat

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Personas

/mcp auth people

Sigue las instrucciones de tu navegador para autorizar cada servicio.

Verifica la conexión

Verifica que las herramientas estén cargadas y listas:

/mcp list

Deberías ver un resultado que indica que los servicios están Ready con sus herramientas enumeradas.

6. Prueba los servidores de MCP

Ahora puedes interactuar con tus datos de Google Workspace usando lenguaje natural. Estos son algunos ejemplos de instrucciones para cada servicio.

Nota: Reemplaza los marcadores de posición entre corchetes en las instrucciones que aparecen a continuación (p.ej., [NAME], [FILE_NAME]) por valores reales de tus propios datos de Google Workspace.

Calendario de Google

Prueba preguntarle a Gemini sobre tu agenda:

• "¿Cuáles son mis próximas reuniones de esta semana?"
• "¿Tengo tiempo libre mañana por la tarde?"

Google Chat

Prueba pedirle a Gemini que busque mensajes:

• "Busca mensajes que contengan '[KEYWORD]' en '[SPACE_NAME]'"

Google Drive

Prueba pedirle a Gemini que busque o lea archivos:

• "Busca archivos en mi Google Drive que contengan '[PALABRA CLAVE]'".
• "Enumera los documentos más recientes que edité".
• "Lee el contenido de mi documento '[FILE_NAME]' y resume los objetivos principales".

Gmail

Prueba pedirle a Gemini que busque o administre tus correos electrónicos:

• "Resume los últimos 5 correos electrónicos que recibí".
• "Redacta un correo electrónico para ‘[EMAIL_ADDRESS]' en el que solicites una actualización sobre el proyecto ‘[PROJECT_NAME]'".

API de People

Prueba preguntarle a Gemini sobre tu perfil o tus contactos:

• "Según mi perfil de Google, ¿cuál es mi nombre?"
• "Busca la información de contacto de [NOMBRE]".

Combina varios servicios

El verdadero potencial del MCP se manifiesta cuando Gemini organiza tareas en varios servicios. Prueba estas instrucciones que demuestran las capacidades de varios servicios:

• "Busca archivos en Drive relacionados con las actualizaciones de los hitos de ‘[PROJECT_NAME]', resume su contenido, busca la dirección de correo electrónico de ‘[NAME]' y crea un borrador de Gmail para esa persona con el resumen".

Explora más herramientas

Estos son solo algunos ejemplos de lo que puedes hacer. Para ver la lista completa de herramientas disponibles para cada servicio y probarlas, consulta la sección Productos compatibles de la documentación oficial.

7. Limpia

Para limpiar tu proyecto sin borrarlo, puedes inhabilitar las APIs y los servicios de MCP que habilitaste:

1. En la consola de Google Cloud, ve al Panel de API y servicios.
2. Haz clic en cada una de las APIs de Google Workspace y MCP que habilitaste (p.ej., Calendar MCP, Chat MCP) y, luego, en Inhabilitar API.

Borra las credenciales de cliente de OAuth en la consola de Google Auth Platform si ya no planeas usarlas.

8. Felicitaciones

¡Felicitaciones! Configuraste y probaste correctamente los servidores de MCP oficiales de Google Workspace con la CLI de Gemini.

Qué aprendiste

• Cómo habilitar los servicios de MCP de Google Workspace en Google Cloud
• Cómo configurar un cliente de OAuth para MCP
• Cómo usar la CLI de Gemini para interactuar con los datos de Google Workspace con herramientas estándar

Documentos de referencia

• Introducción al Protocolo de contexto del modelo (MCP)
• Configura los servidores de MCP de Google Workspace
• Configura el consentimiento de OAuth