Google Cloud Run MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

De primera parte — mantenido por GoogleCloudPlatform
Desplegar desde carpeta local O contenidos de archivos sin procesar (sin necesidad de compilación Docker)
Extrae registros de servicios para depuración sin salir del agente
Autenticación vía ADC — la misma gcloud auth que ya usas

Demo en vivo

Cómo se ve en la práctica

cloud-run.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "cloud-run",
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "cloud-run": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@google-cloud/cloud-run-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add cloud-run -- npx -y @google-cloud/cloud-run-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Google Cloud Run

Desplegar un servicio pequeño a Cloud Run desde el agente

👤 Ingenieros de backend, emprendedores en solitario publicando prototipos ⏱ ~10 min intermediate

Cuándo usarlo: Tienes un servicio Node/Python listo. Quieres que esté en vivo en Cloud Run sin cambiar de contexto a la consola.

Requisitos previos

SDK de gcloud instalado + autenticado — gcloud auth login && gcloud auth application-default login
Un proyecto de GCP con facturación habilitada — gcloud projects list

Flujo

Enumera proyectos, elige el correcto

Enumera mis proyectos de GCP. Quiero desplegar al que está etiquetado con 'staging'.✓ Copiado

→ Proyecto identificado
Desplega la carpeta local

Desplega ./my-api como un servicio Cloud Run llamado 'api-staging' en us-central1. Permite invocaciones no autenticadas. Utiliza el buildpack detectado automáticamente.✓ Copiado

→ Se completa el despliegue, se devuelve URL
Verifica

Obtén los detalles del servicio. Llama a la URL con una prueba estilo curl. Confirma 200.✓ Copiado

→ URL de servicio funcional

Resultado: Un servicio Cloud Run ejecutándose en 3-5 minutos, con el agente registrando la URL para ti.

Errores comunes

La bandera sin autenticar expone el servicio públicamente — genial para staging, malo para prod — Para cualquier cosa cercana a prod, omite allow_unauthenticated y usa IAM; protege con Cloud Armor si es de cara al usuario
Cada despliegue crea una nueva revisión, las antiguas persisten y anclan recursos — Limpia periódicamente las revisiones antiguas con gcloud, o configura la retención de revisiones

Combinar con: fastmcp · fastapi-mcp

Diagnosticar un servicio de Cloud Run a partir de sus registros

👤 Ingenieros de guardia ⏱ ~10 min intermediate

Cuándo usarlo: Un servicio de Cloud Run está devolviendo 500s. Quieres ver los registros sin abrir la consola.

Flujo

Extrae registros recientes

Obtén las últimas 200 entradas de registro para el servicio 'api-prod' en us-central1. Filtra a severidad ERROR.✓ Copiado

→ Entradas de registro de error
Encuentra patrones

Agrupa los errores por plantilla de mensaje. ¿Cuál es el más común? Incluye un stacktrace de muestra.✓ Copiado

→ Error principal con stacktrace
Propón remediación

Basándote en el stacktrace, señala el camino de código probable. Recomienda una reversión a la revisión anterior si los errores se concentran en el último despliegue.✓ Copiado

→ Hipótesis de causa raíz + acción

Resultado: De alerta a decisión de reversión en 5 minutos.

Errores comunes

La retención de registros es corta por defecto (30 días) — Para cualquier cosa que podrías necesitar revisar más tarde, exporta registros a BigQuery o GCS vía Log Router

Combinar con: sentry

Desplegar un servidor MCP (FastMCP / fastapi-mcp) a Cloud Run

👤 Ingenieros de plataforma que albergan MCPs compartidos ⏱ ~30 min advanced

Cuándo usarlo: Construiste un servidor MCP y quieres que esté alojado para uso de todo el equipo.

Requisitos previos

Proyecto compatible con Dockerfile o buildpack — Cloud Run puede usar buildpacks para la mayoría de lenguajes

Flujo

Desplega el servidor

Desplega ./my-mcp como servicio Cloud Run 'acme-mcp', región us-central1. Establece variables de entorno desde mi .env.prod. Requiere autenticación.✓ Copiado

→ Servicio desplegado detrás de IAM
Otorga acceso IAM

Otorga el rol 'roles/run.invoker' en este servicio al grupo [email protected].✓ Copiado

→ El equipo ahora puede invocar
Conecta clientes

Escribe la configuración de Claude Desktop que se conecta vía gcloud run services proxy o mcp-remote con token IAM.✓ Copiado

→ El equipo tiene configuración de copiar-pegar

Resultado: Un MCP alojado por el equipo con autenticación nativa de GCP, mismo modelo de despliegue que tus otros servicios.

Errores comunes

Las conexiones SSE se caen con el tiempo de espera de solicitud predeterminado de 5 minutos de Cloud Run — Establece --timeout=3600 en el servicio; las conexiones MCP necesitan mayor tolerancia de inactividad

Combinar con: fastmcp · fastapi-mcp · mcp-context-forge

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

cloud-run + fastmcp

Escribe un MCP Python, desplega a Cloud Run en una sesión

Scaffolding de un servidor FastMCP exponiendo nuestra API de precios, luego despliégalo al servicio Cloud Run 'pricing-mcp' con autenticación IAM.✓ Copiado

cloud-run + sentry

Errores de Cloud Run → Sentry para triage de incidentes

Si la tasa de error de nuestro servicio Cloud Run se dispara, extrae el problema coincidente de Sentry y correlaciona stack traces con el último despliegue.✓ Copiado

cloud-run + mcp-context-forge

Aloja ContextForge en Cloud Run para federar MCPs

Desplega mcp-contextforge-gateway a Cloud Run con Redis para estado de federación. Registra nuestros 3 MCPs existentes como backends.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list-projects		Descubre qué proyecto usar como destino (solo local)	gratuito
create-project	name, project_id?	Inicia un nuevo proyecto de GCP (solo local)	gratuito
list-services	project, region?	Ve qué se está ejecutando en un proyecto/región	gratuito
get-service	project, region, service	Inspecciona la configuración de un servicio específico	gratuito
get-service-log	project, region, service, filter?, limit?	Depuración — extrae registros recientes	gratuito
deploy-local-folder	folder_path, service, region, project, allow_unauthenticated?	Desplega código que tienes localmente (solo local)	gratuito (compilación) + precios de Cloud Run por solicitud
deploy-file-contents	files: {path,content}[], service, region, project	Desplega código generado por agentes sin archivos locales	gratuito (compilación) + precios de Cloud Run por solicitud

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Cuotas de GCP — generosas para la API de despliegue de Cloud Run
Tokens por llamada: Las respuestas de registro pueden ser grandes — pagina o filtra agresivamente
Monetario: Cloud Run: nivel gratuito ~2M req/mes, luego ~$0.40 por millón de req + $0.000024 por vCPU-sec
Consejo: Establece min-instances=0 para servicios no críticos — los arranques en frío duelen pero el costo cae a casi cero en inactividad

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: roles/run.admin roles/iam.serviceAccountUser

Almacenamiento de credenciales: Application Default Credentials vía gcloud auth application-default login — sin archivos de clave

Salida de datos: Llamadas a *.googleapis.com

No conceder nunca: roles/owner

Resolución de problemas

Errores comunes y soluciones

Permiso denegado en despliegue

Tu cuenta necesita roles/run.admin Y roles/iam.serviceAccountUser en la cuenta de servicio en tiempo de ejecución. Verifica vía gcloud projects get-iam-policy.

La compilación falló con 'buildpack no detectado'

Añade un Dockerfile, o un archivo que buildpacks reconozca (package.json para Node, requirements.txt para Python, etc.).

Servicio desplegado pero devuelve 403

O allow_unauthenticated no fue configurado, o tu identidad de invocación carece de roles/run.invoker. Decide: público o protegido por IAM.

Las conexiones SSE MCP se cuelgan / caen

Aumenta --timeout=3600 y asegura min-instances=1 para evitar desconexiones por arranque en frío.

Alternativas

Google Cloud Run vs otros

Alternativa	Cuándo usarla	Contrapartida
Vercel (para Next.js)	Estás alojando específicamente una aplicación Next.js	UX más simple para Next.js; más estrecho que Cloud Run
AWS App Runner / Lambda MCP	Estás en AWS	Modelo sin servidor comparable, ecosistema diferente
Fly.io	Quieres edge global por defecto y precios más simples	Ecosistema más pequeño; sin MCP oficial aún

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills