Integra Gemini Cloud Assist con herramientas de terceros usando MCP

En este documento, se muestra cómo integrar Gemini Cloud Assist y App Design Center con herramientas de terceros, incluidas Antigravity, Gemini CLI y Cursor, mediante el Protocolo de contexto del modelo (MCP).

MCP te permite integrar las capacidades de agente de Gemini Cloud Assist y App Design Center directamente en tus herramientas de terceros y flujos de trabajo personalizados preferidos para que puedas acceder a la experiencia en operaciones en la nube exactamente donde ya trabajas. Para obtener más detalles sobre MCP, consulta Configura MCP para tu aplicación de IA.

Herramientas de MCP de Gemini Cloud Assist

Gemini Cloud Assist es un agente al que se puede acceder a través de un conjunto de herramientas de MCP con el patrón de agentes como herramientas. A diferencia de las herramientas que recuperan datos o realizan procesamiento de procedimientos, las herramientas de Gemini Cloud Assist exponen la funcionalidad de agente de todo Gemini Cloud Assist o de flujos de trabajo específicos. El agente invocado por las llamadas a herramientas de MCP realiza sus propias llamadas a herramientas de forma interna a Google Cloud. Las siguientes herramientas de MCP se publican para que los agentes las consuman:

  • ask_cloud_assist: Es la interfaz principal para Google Cloud obtener asistencia y para el agente de Gemini Cloud Assist. Se puede acceder a todas las funciones de Gemini Cloud Assist a través de esta herramienta, y abarca la funcionalidad de las otras herramientas de MCP.
  • design_infra: Admite flujos de trabajo para diseñar y crear la arquitectura de la infraestructura en Google Cloud. Funciona con las herramientas del servidor de MCP de App Design Center para administrar el ciclo de vida del diseño de tu infraestructura, por ejemplo, ejecutar y corregir resultados de seguridad, o implementar y corregir problemas.
  • investigate_issue: Admite flujos de trabajo para solucionar problemas en Google Cloud. Puede realizar una solución de problemas rápida o más profunda a través de un recurso de investigación.
  • invoke_operation: Admite flujos de trabajo para crear, actualizar y borrar recursos en Google Cloud. Esta herramienta solo funciona cuando las acciones del agente están habilitadas. Las operaciones de escritura en Gemini Cloud Assist solo se pueden ejecutar a través de la invocación de esta herramienta.
  • optimize_costs: Admite flujos de trabajo para analizar, hacer un seguimiento y optimizar Google Cloud los costos. Proporciona desgloses detallados del gasto y, además, identifica oportunidades para lograr eficiencia en los costos mediante la búsqueda de recursos inactivos o subutilizados.

Herramientas de MCP de App Design Center

Estas herramientas, que a menudo son organizadas por la herramienta design_infra de Gemini Cloud Assist, administran los ciclos de vida de las aplicaciones de infraestructura con App Design Center, incluida la administración de plantillas, el cumplimiento y la corrección de la seguridad, y la implementación. Las herramientas son las siguientes:

  • setup_adc: Inicializa el entorno de App Design Center. Este es un paso de configuración único que se debe realizar antes de que se puedan usar otras herramientas de App Design Center.
  • manage_application: Administra el ciclo de vida de implementación de una aplicación. Usa esta herramienta para implementar un diseño verificado con App Design Center o recuperar el estado y los detalles de una implementación existente. Este es el último paso que convierte tu diseño en una infraestructura implementada en Google Cloud.
  • manage_application_template: Administra el contenido de infraestructura como código (IaC) del diseño de tu infraestructura. Úsala para guardar el diseño como una plantilla de App Design Center, exportar el diseño como archivos de Terraform o actualizar el diseño. Por ejemplo, puedes usar esta herramienta para actualizar el diseño modificando la configuración de los componentes y los parámetros.
  • assess_best_practices: Realiza una auditoría integral de seguridad y configuración en el diseño de tu aplicación antes de la implementación. Valida el diseño en función de los frameworks de Security Command Center y los controles pertinentes, y muestra un informe con resultados prácticos para la corrección.
  • list_application_templates: Muestra todos los diseños de aplicaciones disponibles.

Estas herramientas de MCP no deben tratarse como APIs estables ni configurarse a través de clientes de API de procedimientos. Las herramientas de esta lista o sus parámetros pueden cambiar de nombre, volver a definirse, quitarse o agregarse con el tiempo para tener en cuenta las capacidades en evolución de Gemini Cloud Assist. Las capacidades de Gemini Cloud Assist permanecerán estables para que los agentes cliente puedan ejecutar de manera coherente las mismas tareas, pero la forma en que los agentes interactúan con Gemini Cloud Assist y lo invocan a través de estas herramientas cambiará con el tiempo.

Antes de comenzar

  1. Otorga acceso: Para usar MCP, debes tener una función de Identity and Access Management que contenga el permiso mcp.googleapis.com/tools.call, como una de las siguientes funciones de Gemini Cloud Assist:

    • roles/geminicloudassist.user
    • roles/geminicloudassist.editor
    • roles/geminicloudassist.admin

  2. Si aún no lo hiciste, instala la gcloud CLI y sus componentes beta.

  3. Habilita el servicio de MCP en tu proyecto con el siguiente comando:

    gcloud beta services mcp enable geminicloudassist.googleapis.com \
    --project=PROJECT_ID

    Reemplaza PROJECT_ID por el ID del proyecto. Google Cloud

  4. Para autenticarte con las credenciales predeterminadas de la aplicación , ejecuta el siguiente comando:

    gcloud auth application-default login

Configura MCP para tu cliente

La configuración del agente cliente depende del agente que uses. En las siguientes secciones, se proporcionan instrucciones para configurar MCP para diferentes clientes.

Para habilitar el flujo de trabajo completo de diseño a implementación, debes configurar tu cliente para que se conecte a los servidores de MCP de Gemini Cloud Assist y App Design Center, y debes incluir el archivo SKILL.md pertinente. En los siguientes fragmentos, se muestra la configuración combinada.

Gemini CLI

Configura con una extensión

Instala el servidor de MCP como una extensión de Gemini CLI con el siguiente comando:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Configuración manual

  1. Configura los parámetros del servidor de MCP.

    Abre el archivo de configuración de alcance del usuario de Gemini CLI en ~/.gemini/settings.json o la configuración de alcance del espacio de trabajo en .gemini/settings.json. Si el archivo no existe, créalo. Agrega o combina el siguiente bloque de configuración en la clave mcpServers. Asegúrate de que el archivo use un formato JSON válido. Esta configuración usa automáticamente tus credenciales predeterminadas de la aplicación. 

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    },
    "application_design_center": {
      "httpUrl": "https://designcenter.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    }
  }
}

  2. Crea y propaga tus archivos de habilidades.

    Crea un archivo SKILL.md en uno de los siguientes directorios. Copia y pega el contenido de Markdown de la habilidad elegida de la sección de referencia de habilidades de este documento en el archivo.

    • Alcance del espacio de trabajo: .gemini/skills/<skill-name>/
    • Alcance del usuario: ~/.gemini/skills/<skill-name>/

    A continuación, se muestra un ejemplo de estructura de directorios:

    .gemini/
└── skills/
    ├── design-and-deploy/
    │   └── SKILL.md
    └── google-gemini-cloud-assist/
        └── SKILL.md

  3. Verifica tus habilidades.

    Una vez que hayas modificado los archivos settings.json y SKILL.md, reinicia Gemini CLI. Usa los siguientes comandos para verificarlo:

    • /skills list: Para verificar que se hayan descubierto correctamente tus habilidades locales.
    • /mcp list: Para verificar que los servidores de MCP de Gemini Cloud Assist y App Design Center estén conectados.

Antigravity

  1. Instala la extensión.

    En Antigravity, abre el marketplace de Extensiones. Busca la extensión de Gemini Cloud Assist, haz clic en Instalar y, luego, en Actualizar.

  2. Configura los servidores de MCP de forma manual.

    Abre el panel Administrar servidores de MCP y haz clic en Ver configuración sin procesar para editar el mcp_config.json archivo. Agrega o combina el siguiente bloque de configuración. Esta configuración usa tus credenciales predeterminadas de la aplicación para la autenticación.

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    },
    "application_design_center": {
      "serverUrl": "https://designcenter.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    }
  }
}

  3. Verifica la configuración.

    Una vez que hayas modificado los archivos mcp_config.json y SKILL.md, reinicia Antigravity. En el panel del agente, usa los siguientes comandos de barra para verificar la conexión:

    • /skills list: Verifica que se hayan descubierto tus habilidades locales.
    • /mcp list: Verifica que los servidores de MCP de Gemini Cloud Assist y App Design Center estén conectados.

Cursor

  1. En tu Google Cloud proyecto, crea un ID de cliente de OAuth 2.0 para una app de escritorio.

  2. Configura URI://anysphere.cursor-mcp/oauth/callback como la URL de redireccionamiento. Para obtener más información, consulta la documentación de Cursor.

  3. Agrega o combina el siguiente bloque de configuración:

       {
     "mcpServers": {
       "gemini_cloud_assist": {
         "url": "https://geminicloudassist.googleapis.com/mcp",
         "auth": {
           "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
           "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
           "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
         }
       }
     }
   }

Habilidades de Gemini Cloud Assist

Las herramientas de MCP de Gemini Cloud Assist y App Design Center usan habilidades de agente para dar instrucciones a tu agente. La habilidad guía a tu agente para realizar las siguientes tareas:

  • Encadenar varias herramientas en un flujo de trabajo
  • Procesar información local pertinente, como el código de implementación de Terraform, para razonar sobre tu contexto local
  • Responder a invocaciones explícitas cuando haces referencia a la habilidad directamente

Cuando usas agentes interactivos como Antigravity o Gemini CLI, puedes integrar las herramientas de MCP de Gemini Cloud Assist con otros agentes y flujos de trabajo. Debido a que estas herramientas proporcionan capacidades amplias que pueden superponerse con tus herramientas especializadas existentes, usa las siguientes estrategias para optimizar tu entorno y caso de uso específicos:

  1. Personaliza la definición de la habilidad: Actualiza el archivo SKILL.md para especificar los intents y los casos de uso para los que deseas invocar Gemini Cloud Assist. Esto garantiza que el agente solo se active para las tareas en las que se requiere su amplia experiencia en la nube.
  2. Invoca habilidades de forma explícita: Muchos agentes interactivos te permiten controlar cuándo se activa una habilidad. Si tu agente lo admite, puedes configurar la habilidad para que requiera una invocación manual con comandos de barra (/) o menciones (@). Este enfoque te permite elegir con precisión cuándo usar Gemini Cloud Assist en comparación con otra herramienta especializada.

Referencia de habilidades de Gemini Cloud Assist

Te recomendamos el siguiente archivo SKILL.md en cualquier agente que esté configurado con herramientas de MCP de Gemini Cloud Assist. Este archivo guía a tu agente sobre cómo usar las herramientas de forma adecuada.

¿Qué sigue?