- Centraliza habilidades de Google Cloud en paquetes instalables compatibles con estándares abiertos.
- Integra documentación oficial en tiempo real mediante servidores MCP para evitar alucinaciones de la IA.
- Implementa capas de seguridad y validación de IAM antes de ejecutar cambios en la infraestructura.
- Soporta la integración nativa con herramientas como Claude Code, Codex y Antigravity CLI.
Si te mueves por el mundo del desarrollo y usas agentes de IA para picar código, sabrás que a veces es un quebradero de cabeza que la máquina entienda exactamente cómo funciona la infraestructura de la nube. Hasta ahora, teníamos que darle documentación a mano o configurar servidores MCP remotos, pero la cosa se volvía inmanejable cuando necesitábamos que varias herramientas trabajaran juntas para resolver un problema complejo. Para solucionar este lío, ha nacido el plugin de Google Cloud para agentes de IA, una solución diseñada para empaquetar habilidades y herramientas en un solo bloque instalable.
La gran ventaja de este sistema es que evita que el desarrollador tenga que gestionar dependencias complicadas o configuraciones distintas para cada asistente. Al basarse en un estándar abierto y neutral, permite que el agente tenga acceso a conocimientos profundos de productos específicos sin saturar la ventana de contexto, haciendo que la interacción con el ecosistema de Google sea mucho más fluida y, sobre todo, más efectiva en entornos reales de trabajo.
¿Qué es exactamente el plugin google-cloud-developer?
Este plugin es básicamente el kit de supervivencia para cualquier agente de IA que tenga que operar en Google Cloud. Su misión principal es ayudar al asistente a navegar por los fundamentos de la plataforma, abarcando temas críticos como la gestión de proyectos, la autorización, la autenticación y, muy importante, la implementación de barreras de seguridad al ejecutar comandos de la CLI de gcloud.
Una de las joyas de la corona es que integra la configuración del servidor MCP de Developer Knowledge. Gracias a esto, el agente no se inventa las cosas, sino que tiene un anclaje en tiempo real con la documentación oficial de Google, lo que garantiza que las respuestas estén actualizadas y no basadas en datos obsoletos.
Tipos de plugins y su funcionamiento
Google ha estructurado su repositorio de habilidades para que el crecimiento sea ordenado, dividiendo los complementos en dos grandes bloques:
- Plugins fundacionales: Son los básicos para todo el mundo. Se centran en la configuración de proyectos, el diseño arquitectónico y la capacidad de descubrir documentación relevante.
- Plugins enfocados a dominios: Estos son más especializados y ofrecen mejores prácticas técnicas para áreas concretas dentro de la nube de Google.
Para evitar que el agente se pierda, existe un mapa de rutas llamado google-cloud-discovery.md. Este mecanismo actúa como una guía que redirige al agente hacia habilidades más profundas (como las de GKE o el WAF de Google Cloud) solo cuando la tarea realmente lo requiere, optimizando así el uso de los recursos de computación de la IA.
Poniendo el plugin a prueba: El caso del onboarding
Imagina que eres nuevo en la plataforma y necesitas montar un proyecto desde cero con facturación activa y autenticación local para que tus scripts funcionen con una identidad de servicio. Con el plugin instalado, el agente no se lanza a ciegas, sino que sigue un proceso lógico:
- Análisis del entorno: El asistente comprueba en silencio si tienes instalada la CLI y si ya existen organizaciones o proyectos creados.
- Revisión de seguridad: Analiza las mejores prácticas de IAM para evitar que, por un descuido, filtres claves privadas en un commit de Git.
- Hoja de ruta: Te propone un plan de acción detallado y te pide permiso antes de tocar cualquier recurso real en la nube.
Guía de instalación paso a paso
Dependiendo de la herramienta que utilices, el proceso varía ligeramente, pero siempre requiere habilitar la API de Developer Knowledge mediante el comando gcloud services enable developerknowledge.googleapis.com.
Para usuarios de Antigravity CLI
Es la opción más directa. Solo tienes que ejecutar el comando de instalación apuntando a la ruta del repositorio de GitHub: agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer.
Para Claude Code CLI
Aquí el proceso es un poco más detallado. Primero añades el marketplace de Google y luego instalas el plugin específico. Es fundamental generar una clave de API para la Developer Knowledge API y exportarla en tu terminal mediante la variable de entorno DEVELOPERKNOWLEDGE_API_KEY, preferiblemente añadiéndola a tu archivo .bashrc o .zshrc para no tener que hacerlo cada vez.
Para Codex CLI
Al igual que con Claude, se utiliza el marketplace. La diferencia radica en que debes actualizar el archivo de configuración ~/.codex/config.toml para añadir la URL del servidor MCP y la cabecera de autenticación con tu clave de API. No te asustes si después de esto ves un estado de ‘not logged in’; es un comportamiento normal que no afecta al funcionamiento.
Herramientas complementarias y entorno local
Para que todo esto rinda al máximo, es vital tener el entorno local bien cuadrado. Esto implica instalar la CLI de gcloud, ejecutar gcloud init para el proyecto por defecto y configurar las Application Default Credentials (ADC) con gcloud auth application-default login. Esto permite que las librerías cliente de Java, Python o Go se autentiquen solas sin complicaciones.
Este ecosistema transforma la manera de desarrollar en la nube, pasando de una gestión manual y propensa a errores a un flujo donde la IA tiene acceso directo a la documentación y herramientas de control, permitiendo que el programador se centre en la lógica del negocio mientras el agente se encarga de la complejidad técnica de la infraestructura.