Google Cloud para desarrolladores web: setup, gcloud CLI y caso de uso con Stitch

Google Cloud para desarrolladores web: setup, gcloud CLI y caso de uso con Stitch

Si llevas un tiempo en el mundo del desarrollo web, habrás oído hablar de Google Cloud. Pero probablemente lo asocias a grandes empresas con infraestructuras enormes y facturas astronómicas.

La realidad es que Google Cloud tiene herramientas muy útiles para proyectos pequeños y medianos, muchas de ellas gratuitas.

En este artículo te explico qué es Google Cloud, cómo conectarte desde tu máquina y, como caso de uso práctico, cómo integrar Google Stitch con Cursor para generar interfaces UI directamente desde tu editor.

¿Qué es Google Cloud?

Google Cloud Platform (GCP) es la infraestructura cloud de Google. Básicamente son los mismos servidores y servicios que usa Google internamente, puestos a disposición de cualquiera.

¿Qué puedes hacer con él?

  • Hospedar aplicaciones y bases de datos
  • Usar APIs de inteligencia artificial (Vision, Speech, Translation…)
  • Almacenar archivos con Google Cloud Storage
  • Ejecutar funciones serverless
  • Acceder a herramientas experimentales de Google Labs como Stitch

Para proyectos pequeños o experimentales, muchos servicios entran dentro del nivel gratuito. Solo necesitas una cuenta de Google y un proyecto creado.

¿Qué es gcloud CLI?

Para interactuar con Google Cloud desde tu terminal usas gcloud CLI, la herramienta de línea de comandos oficial. Con ella puedes autenticarte, crear proyectos, habilitar APIs, gestionar recursos y mucho más, todo sin tocar la consola web.

Es el equivalente a lo que sería la CLI de AWS o de Azure, pero para el ecosistema de Google.

Instalación de gcloud en macOS

Antes de nada, comprueba si ya lo tienes instalado:

gcloud --version

Si obtienes command not found, hay que instalarlo. Lo primero es saber qué chip tienes:

uname -m

Si devuelve arm64 tienes Apple Silicon (M1/M2/M3). Si devuelve x86_64 tienes Intel.

Podrías intentar instalarlo con Homebrew, pero en macOS con Apple Silicon falla con frecuencia por un problema con el path de Python. La forma más fiable es usar el instalador oficial de Google.

Descarga el paquete según tu chip:

# Apple Silicon (arm64)
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-darwin-arm.tar.gz
 
# Intel (x86_64)
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-darwin-x86_64.tar.gz

Extrae e instala:

tar -xzf google-cloud-cli-darwin-arm.tar.gz
./google-cloud-sdk/install.sh

El instalador te preguntará si quiere modificar el PATH. Di yes. Cuando termine, añade el PATH en tu sesión actual para poder usarlo sin reiniciar la terminal:

export PATH="/Users/TU_USUARIO/google-cloud-sdk/bin:$PATH"

Sustituye TU_USUARIO por tu nombre de usuario. Puedes obtenerlo con whoami.

Verifica que funciona:

gcloud --version

Hacer el PATH permanente

El export PATH que hiciste antes solo dura en la sesión actual. La próxima vez que abras una terminal, gcloud volverá a no encontrarse. Para evitarlo, añádelo a tu perfil de shell.

Si usas zsh (el shell por defecto en macOS moderno):

echo 'export PATH="/Users/TU_USUARIO/google-cloud-sdk/bin:$PATH"' >> ~/.zshrc

Si usas bash:

echo 'export PATH="/Users/TU_USUARIO/google-cloud-sdk/bin:$PATH"' >> ~/.bash_profile

Aviso: Si usas bash y ves el error ${candidate_name^^}: bad substitution al hacer source ~/.bash_profile, no te preocupes. Es un problema de compatibilidad del script de gcloud con bash antiguo y no afecta al funcionamiento. Abre una terminal nueva en su lugar.

Autenticarte y crear un proyecto

Una vez instalado, el primer paso es autenticarte con tu cuenta de Google:

gcloud auth login

Se abre el navegador, seleccionas tu cuenta y listo. Ahora crea un proyecto. En Google Cloud todo se organiza en proyectos, que actúan como contenedores para recursos, APIs y facturación.

gcloud projects create mi-proyecto --name="Mi Proyecto"
gcloud config set project mi-proyecto

Si ya tienes proyectos creados, puedes listarlos con:

gcloud projects list

Por último, genera las credenciales por defecto que usarán las aplicaciones y librerías que se conecten a Google Cloud desde tu máquina:

gcloud auth application-default login
gcloud auth application-default set-quota-project mi-proyecto

💡 Las Application Default Credentials son las credenciales que usan automáticamente las SDKs y herramientas de Google Cloud cuando se ejecutan en tu máquina. Las guardas una vez y cualquier herramienta que las necesite las encuentra sola.

Caso de uso: Google Stitch + Cursor

Ahora que tienes Google Cloud configurado, puedes empezar a usar sus servicios. Un ejemplo muy práctico para desarrolladores web es Google Stitch.

Stitch es una herramienta experimental de Google Labs que genera diseños de UI completos a partir de texto. Le describes lo que quieres y te devuelve pantallas con HTML y CSS listo para usar, impulsado por Gemini 2.5 Pro. Y lo mejor: tiene soporte MCP, lo que significa que puedes conectarlo directamente a Cursor.

Habilitar la API de Stitch

Cada servicio de Google Cloud se activa por separado en tu proyecto. Para Stitch:

gcloud beta services enable stitch.googleapis.com --project=mi-proyecto

Verifica que quedó activa:

gcloud beta services list --enabled --project=mi-proyecto | grep stitch

Conectar Stitch con Cursor vía MCP

Edita el archivo ~/.cursor/mcp.json y añade la configuración de Stitch:

{
  "mcpServers": {
    "stitch": {
      "command": "npx",
      "args": ["-y", "stitch-mcp"],
      "env": {
        "GOOGLE_CLOUD_PROJECT": "mi-proyecto",
        "CLOUDSDK_ROOT_DIR": "/Users/TU_USUARIO/google-cloud-sdk",
        "PATH": "/Users/TU_USUARIO/google-cloud-sdk/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

⚠️ Es importante especificar las rutas absolutas en el env. Cursor no hereda el PATH de tu terminal, así que si no lo indicas, no encuentra el binario de gcloud y obtienes el error Authentication failed.

Reinicia Cursor y ve a Settings → MCP. Deberías ver el servidor stitch con un punto verde. A partir de aquí, en un chat de Cursor en modo Agent puedes pedirle cosas como:

  • «Genera una pantalla de login con diseño moderno»
  • «Crea una landing page para un producto SaaS»
  • «Diseña un formulario de registro con validación visual»

El agente llama a Stitch, genera el diseño y te devuelve el HTML/CSS directamente en el chat.

Las credenciales caducan: cómo renovarlas

Las Application Default Credentials tienen una vida útil limitada. Pasado un tiempo, herramientas como el MCP de Stitch dejarán de funcionar con un error como este:

Authentication failed. Run: gcloud auth application-default login

La solución es simple: vuelve a ejecutar los dos comandos de autenticación. Primero asegúrate de que gcloud está en el PATH de tu sesión actual (si no lo tienes permanente):

export PATH="/Users/TU_USUARIO/google-cloud-sdk/bin:$PATH"

Y luego renueva las credenciales:

gcloud auth application-default login
gcloud auth application-default set-quota-project mi-proyecto

Se abre el navegador, aceptas y listo. Reinicia Cursor y el MCP vuelve a funcionar.

Si tienes el PATH configurado de forma permanente en ~/.zshrc como expliqué antes, no necesitarás el export manual y bastará con los dos comandos de autenticación.

¿Para qué más puedes usar Google Cloud?

Una vez tienes gcloud configurado, tienes la puerta abierta a un montón de servicios. Algunos que uso o que me parecen interesantes para proyectos web:

  • Cloud Vision API — análisis de imágenes, OCR, detección de objetos
  • Cloud Translation API — traducciones automáticas en tu app
  • Firebase — base de datos en tiempo real, autenticación, hosting
  • Gemini API — acceso a los modelos de lenguaje de Google
  • Cloud Storage — almacenamiento de archivos escalable

La mayoría tienen un nivel gratuito generoso para proyectos personales o en fase de pruebas.

Google Cloud no es solo para grandes empresas. Con diez minutos de setup tienes acceso a un ecosistema enorme de herramientas, muchas de ellas gratuitas.

La curva de entrada es baja si lo haces desde la terminal con gcloud, y una vez autenticado puedes ir habilitando servicios según los vayas necesitando. Stitch es solo un ejemplo de lo que puedes conectar a tu flujo de trabajo.

Comentarios (0)

Deja un comentario

Tu dirección de correo no será publicada. Los campos obligatorios están marcados con *