Integra Gemini Cloud Assist con herramientas de terceros usando MCP

El Protocolo de contexto del modelo (MCP) te permite integrar las capacidades de agente de Gemini Cloud Assist y App Design Center directamente en herramientas de terceros, como Antigravity, Gemini CLI y Cursor. Esta integración aporta experiencia en operaciones en la nube y asistencia en arquitectura a tus flujos de trabajo de desarrollo existentes. Para obtener más información, consulta Configura el 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 del MCP con el patrón de agentes como herramientas. A diferencia de las herramientas que recuperan datos o realizan un procesamiento procedimental, 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 aGoogle Cloud. Se publicaron las siguientes herramientas de MCP para que los agentes las consuman:

  • ask_cloud_assist: Esta es la interfaz principal para la Google Cloudasistencia y el agente de Gemini Cloud Assist. Se puede acceder a todas las funciones de Gemini Cloud Assist a través de esta herramienta, que abarca la funcionalidad de las demás 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 del App Design Center para administrar el ciclo de vida del diseño de tu infraestructura, por ejemplo, ejecutar y corregir hallazgos de seguridad, o bien implementar y corregir problemas.
  • investigate_issue: Esto admite flujos de trabajo para solucionar problemas enGoogle 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 los costos de Google Cloud . Proporciona desgloses detallados de la inversión e identifica oportunidades para lograr eficiencia en los costos, ya que encuentra recursos inactivos o subutilizados.

Herramientas de MCP de App Design Center

Estas herramientas, a menudo coordinadas por la herramienta design_infra de Gemini Cloud Assist, administran los ciclos de vida de las aplicaciones de infraestructura con App Design Center, lo que incluye 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 poder usar otras herramientas del App Design Center.
  • manage_application: Administra el ciclo de vida de la implementación de una aplicación. Usa esta herramienta para implementar un diseño verificado con el 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) de tu diseño de infraestructura. Usa esta opción para guardar el diseño como una plantilla de App Design Center, exportarlo como archivos de Terraform o actualizarlo. 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 devuelve un informe con hallazgos prácticos para la corrección.
  • list_application_templates: Enumera 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 procedimentales. Es posible que, con el tiempo, se cambie el nombre, se redefinan, se quiten o se agreguen herramientas de esta lista o sus parámetros para tener en cuenta las capacidades en evolución de Gemini Cloud Assist. Las capacidades de Gemini Cloud Assist seguirán siendo estables para que los agentes del cliente puedan ejecutar las mismas tareas de manera coherente, 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 un rol de Identity and Access Management que contenga el permiso mcp.googleapis.com/tools.call, como uno de los siguientes roles de Gemini Cloud Assist:

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

  2. Si aún no lo hiciste, instala la CLI de gcloud 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 de Google Cloud .

  4. Realiza la autenticación con las credenciales predeterminadas de la aplicación ejecutando el siguiente comando:

    gcloud auth application-default login

Configura MCP para tu cliente

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

Para habilitar el flujo de trabajo completo desde el diseño hasta la 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.

Antigravity

Para agregar los servidores de MCP remotos de Gemini Cloud Assist y App Design Center a Antigravity, sigue las instrucciones que se indican en Antigravity Editor: MCP Integration o completa los siguientes pasos:

  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 archivo mcp_config.json. 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 tu configuración.

    Después de modificar los archivos mcp_config.json y SKILL.md, reinicia Antigravity. En el panel del agente, ejecuta 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.

ChatGPT

Debes tener una suscripción a ChatGPT Business para usar los servidores de Google y Google Cloud MCP con ChatGPT.

Para agregar los servidores MCP remotos de Gemini Cloud Assist y App Design Center a ChatGPT, crea un ID de cliente y un secreto del cliente de OAuth 2.0 y, luego, agrega los servidores MCP como complementos en ChatGPT:

  1. Crea un ID de cliente y secreto del cliente de OAuth 2.0:

    1. En la consola de Google Cloud , ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección Orígenes autorizados de JavaScript, haz clic en + Agregar URI y, luego, ingresa https://chatgpt.com en el campo URIs.

    5. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://chatgpt.com/connector_platform_oauth_redirect en el campo URIs.

    6. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    7. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, bórralo y crea uno nuevo.

  2. Accede a ChatGPT con el modo de desarrollador activado.

  3. Sigue las instrucciones que se indican en Cómo compilar un complemento para agregar un conector personalizado para cada servidor de MCP:

    • En el caso de Gemini Cloud Assist, configura la URL del servidor como https://geminicloudassist.googleapis.com/mcp.
    • En App Design Center, establece la URL del servidor en https://designcenter.googleapis.com/mcp.

  4. En OAuth o Configuración avanzada, ingresa tu ID de cliente y secreto del cliente de OAuth.

  5. Completa el mensaje de acceso para habilitar los servidores de MCP en el chat.

Claude.ai

Para agregar los servidores MCP remotos de Gemini Cloud Assist y App Design Center a Claude.ai, configura conectores personalizados con un ID de cliente y un secreto del cliente de OAuth 2.0:

  1. Crea un ID de cliente y secreto del cliente de OAuth 2.0:

    1. En la consola de Google Cloud , ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección Orígenes autorizados de JavaScript, haz clic en + Agregar URI y, luego, ingresa https://claude.ai en el campo URIs.

    5. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://claude.ai/api/mcp/auth_callback en el campo URIs.

    6. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    7. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, bórralo y crea uno nuevo.

  2. Sigue las instrucciones para crear un conector personalizado para cada servidor de MCP:

    • En el caso de Gemini Cloud Assist, configura la URL del servidor como https://geminicloudassist.googleapis.com/mcp.
    • En App Design Center, establece la URL del servidor en https://designcenter.googleapis.com/mcp.

  3. En el menú Configuración avanzada, ingresa tu ID de cliente y secreto del cliente de OAuth.

  4. Completa el mensaje de acceso para habilitar los servidores de MCP en el chat.

Claude Code

Para agregar los servidores MCP remotos de Gemini Cloud Assist y App Design Center a Cloud Code, configura conectores personalizados con un ID de cliente y un secreto del cliente de OAuth 2.0:

  1. Instala Claude Code.

  2. Crea un ID de cliente y secreto del cliente de OAuth 2.0:

    1. En la consola de Google Cloud , ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://claude.ai/api/mcp/auth_callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, bórralo y crea uno nuevo.

  3. Sigue las instrucciones para crear un conector personalizado para cada servidor de MCP:

    • En el caso de Gemini Cloud Assist, configura la URL del servidor como https://geminicloudassist.googleapis.com/mcp.
    • En App Design Center, establece la URL del servidor en https://designcenter.googleapis.com/mcp.

  4. En el menú Configuración avanzada, ingresa tu ID de cliente y secreto del cliente de OAuth.

  5. Completa el mensaje de acceso para habilitar los servidores de MCP en el chat.

Claude para computadoras de escritorio

Para agregar los servidores MCP remotos de Gemini Cloud Assist y App Design Center a Claude Desktop, configura conectores personalizados con un ID de cliente y un secreto del cliente de OAuth 2.0:

  1. Instala Claude para computadoras de escritorio.

  2. Crea un ID de cliente y secreto del cliente de OAuth 2.0:

    1. En la consola de Google Cloud , ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://claude.ai/api/mcp/auth_callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, bórralo y crea uno nuevo.

  3. Sigue las instrucciones para crear un conector personalizado para cada servidor de MCP:

    • En el caso de Gemini Cloud Assist, configura la URL del servidor como https://geminicloudassist.googleapis.com/mcp.
    • En App Design Center, establece la URL del servidor en https://designcenter.googleapis.com/mcp.

  4. En el menú Configuración avanzada, ingresa tu ID de cliente y secreto del cliente de OAuth.

  5. Completa el mensaje de acceso para habilitar los servidores de MCP en el chat.

Codex

Para agregar los servidores de MCP remotos de Gemini Cloud Assist y App Design Center a Codex Enterprise, completa los siguientes pasos:

  1. En la IU de Codex Enterprise, abre Configuración, selecciona Servidores de MCP y, luego, haz clic en Ver configuración sin procesar para abrir el editor de mcp_config.json.

  2. Agrega o combina el siguiente bloque de configuración en el archivo mcp_config.json. 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"
    }
  }
}

Cursor

Para agregar los servidores MCP remotos de Gemini Cloud Assist y App Design Center a Cursor, crea un ID de cliente y un secreto del cliente de OAuth 2.0 y, luego, configura los servidores MCP con OAuth estático. Cursor usa diferentes URIs de redireccionamiento según si accedes a Cursor a través de la Web o de una app para computadoras:

  1. Crea un ID de cliente y secreto del cliente de OAuth 2.0:

    Agentes web o de cursor

    1. En la consola de Google Cloud , ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://www.cursor.com/agents/mcp/oauth/callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, bórralo y crea uno nuevo.

    Computadora de escritorio

    1. En la consola de Google Cloud , ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa http://localhost:8787/callback en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, bórralo y crea uno nuevo.

  2. Sigue las instrucciones para configurar el servidor de MCP con OAuth estático y agrega o combina el siguiente bloque de configuración en tu configuración de MCP de Cursor:

    {
  "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"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

  3. Configura las variables de entorno OAUTH_CLIENT_ID y OAUTH_CLIENT_SECRET en tu entorno.

  4. Usa el servidor de MCP en Chat.

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

Configurar manualmente

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

    Abre el archivo de configuración de Gemini CLI con alcance del usuario en ~/.gemini/settings.json o el archivo de configuración con 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 completa tus archivos de habilidad.

    Crea un archivo SKILL.md en uno de los siguientes directorios. Copia y pega el contenido de Markdown de la habilidad que elegiste de la sección 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/

    Reemplaza SKILL_NAME por el nombre del directorio de tu skill.

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

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

  3. Verifica tus habilidades.

    Después de modificar los archivos settings.json y SKILL.md, reinicia Gemini CLI y, luego, ejecuta los siguientes comandos para verificar tu configuració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.

Gemini Enterprise

Para registrar los servidores de MCP remotos de Gemini Cloud Assist y App Design Center en Gemini Enterprise, un administrador debe completar los siguientes pasos:

  1. Crea un ID de cliente y un secreto del cliente de OAuth 2.0 con el URI de redireccionamiento de Gemini Enterprise:

    1. En la consola de Google Cloud , ve a Google Auth Platform > Clients > Create client.

      Ir a Crear cliente

      Se te solicitará que crees un proyecto si no tienes uno seleccionado.

    2. En la lista Tipo de aplicación, selecciona Aplicación web.

    3. En el campo Nombre, ingresa un nombre para tu aplicación.

    4. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, ingresa https://vertexaisearch.cloud.google.com/oauth-redirect en el campo URIs.

    5. Haz clic en Crear. Se creó el cliente.

      Se abrirá el diálogo Se creó el cliente de OAuth 2.0.

    6. En la sección Secretos del cliente, copia el Secreto del cliente y guárdalo en un lugar seguro. Solo puedes copiarlo una vez. Si lo pierdes, bórralo y crea uno nuevo.

  2. En la consola de Google Cloud , ve a Gemini Enterprise > Almacenes de datos y haz clic en Crear almacén de datos. Para obtener más información, consulta Configura tu almacén de datos del servidor de MCP personalizado.

  3. Selecciona Servidor de MCP personalizado como la fuente de datos.

  4. Configura un almacén de datos del servidor de MCP personalizado para cada extremo:

    • En el caso de Gemini Cloud Assist, ingresa https://geminicloudassist.googleapis.com/mcp.
    • En App Design Center, ingresa https://designcenter.googleapis.com/mcp.

  5. Ingresa el ID de cliente y el secreto del cliente de OAuth y, luego, guarda el almacén de datos. Las herramientas estarán disponibles para los agentes de Gemini Enterprise.

Habilidades de Gemini Cloud Assist

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

  • Encadena varias herramientas en un flujo de trabajo.
  • Procesa información local pertinente, como el código de implementación de Terraform, para razonar sobre tu contexto local.
  • Responder a las invocaciones explícitas cuando haces referencia a la skill 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. Dado que estas herramientas proporcionan amplias capacidades 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 las intenciones y los casos de uso para los que deseas invocar a 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. Invocar 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 con @ (@). Este enfoque te permite elegir con precisión cuándo usar Gemini Cloud Assist en lugar de otra herramienta especializada.

Referencia de la habilidad de Gemini Cloud Assist

Recomendamos el siguiente archivo SKILL.md en todos los agentes configurados con las herramientas de MCP de Gemini Cloud Assist. Este archivo guía a tu agente sobre cómo usar las herramientas de manera adecuada.

¿Qué sigue?