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

Por que usar

Principais recursos

De primeira mão — mantido pela GoogleCloudPlatform
Implante a partir de pasta local OU conteúdo de arquivo bruto (sem necessidade de build Docker)
Puxe logs de serviço para depuração sem sair do agente
Autenticação via ADC — o mesmo gcloud auth que você já usa

Demo ao vivo

Como fica na prática

cloud-run.replay ▶ pronto

0/0

Instalar

Escolha seu 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"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Google Cloud Run

Implante um pequeno serviço no Cloud Run a partir do agente

👤 Engenheiros de backend, fundadores solo lançando protótipos ⏱ ~10 min intermediate

Quando usar: Você tem um serviço Node/Python pronto. Você quer que fique ativo no Cloud Run sem trocar de contexto para o console.

Pré-requisitos

SDK gcloud instalado + autenticado — gcloud auth login && gcloud auth application-default login
Um projeto GCP com faturamento habilitado — gcloud projects list

Fluxo

Liste projetos, escolha o correto

Liste meus projetos GCP. Quero implantar no que está marcado como 'staging'.✓ Copiado

→ Projeto identificado
Implante a pasta local

Implante ./my-api como serviço Cloud Run nomeado 'api-staging' em us-central1. Permita invocações não autenticadas. Use o buildpack detectado automaticamente.✓ Copiado

→ Deploy concluído, URL retornada
Verifique

Obtenha os detalhes do serviço. Chame a URL com um teste de estilo curl. Confirme 200.✓ Copiado

→ URL de serviço funcionando

Resultado: Um serviço Cloud Run em execução em 3-5 minutos, com o agente registrando a URL para você.

Armadilhas

Sinalizador não autenticado expõe o serviço publicamente — ótimo para staging, ruim para prod — Para qualquer coisa adjacent a prod, omita allow_unauthenticated e use IAM; coloque na frente com Cloud Armor se voltado para o usuário
Cada implantação cria uma nova revisão, as antigas ficam e fixam recursos — Limpe periodicamente as revisões antigas com gcloud ou configure a retenção de revisão

Combine com: fastmcp · fastapi-mcp

Diagnostique um serviço Cloud Run a partir de seus logs

👤 Engenheiros de plantão ⏱ ~10 min intermediate

Quando usar: Um serviço Cloud Run está retornando 500s. Você quer ver os logs sem abrir o console.

Fluxo

Puxe logs recentes

Obtenha as últimas 200 entradas de log para o serviço 'api-prod' em us-central1. Filtre para severidade ERROR.✓ Copiado

→ Entradas de log de erro
Encontre padrões

Agrupe os erros por modelo de mensagem. Qual é o mais comum? Inclua um stacktrace de exemplo.✓ Copiado

→ Erro superior com stacktrace
Proponha remediação

Com base no stacktrace, aponte o caminho do código provável. Recomende uma reversão para a revisão anterior se os erros estão concentrados na última implantação.✓ Copiado

→ Hipótese de causa raiz + ação

Resultado: De alerta para decisão de reversão em 5 minutos.

Armadilhas

A retenção de log é curta por padrão (30 dias) — Para qualquer coisa que você possa precisar consultar depois, exporte logs para BigQuery ou GCS via Log Router

Combine com: sentry

Implante um servidor MCP (FastMCP / fastapi-mcp) no Cloud Run

👤 Engenheiros de plataforma hospedando MCPs compartilhados ⏱ ~30 min advanced

Quando usar: Você construiu um servidor MCP e quer que seja hospedado para uso em toda a equipe.

Pré-requisitos

Dockerfile ou projeto compatível com buildpack — Cloud Run pode usar buildpacks para a maioria das linguagens

Fluxo

Implante o servidor

Implante ./my-mcp como serviço Cloud Run 'acme-mcp', região us-central1. Defina variáveis de ambiente do meu .env.prod. Exija autenticação.✓ Copiado

→ Serviço implantado atrás de IAM
Conceda acesso IAM

Conceda a função 'roles/run.invoker' neste serviço para o grupo [email protected].✓ Copiado

→ Equipe agora pode invocar
Conecte clientes

Escreva a configuração do Claude Desktop que se conecta via gcloud run services proxy ou mcp-remote com token IAM.✓ Copiado

→ Equipe tem configuração copy-paste

Resultado: Um MCP hospedado pela equipe com autenticação nativa do GCP, mesmo modelo de implantação que seus outros serviços.

Armadilhas

Conexões SSE caem no timeout de solicitação padrão de 5 minutos do Cloud Run — Defina --timeout=3600 no serviço; conexões MCP precisam de tolerância de inatividade mais longa

Combine com: fastmcp · fastapi-mcp · mcp-context-forge

Combinações

Combine com outros MCPs para 10× de alavancagem

cloud-run + fastmcp

Escreva um MCP Python, implante no Cloud Run em uma sessão

Crie um servidor FastMCP expondo nossa API de preços, depois implante no serviço Cloud Run 'pricing-mcp' com autenticação IAM.✓ Copiado

cloud-run + sentry

Erros de Cloud Run → Sentry para triage de incidente

Se a taxa de erro do nosso serviço Cloud Run aumentar, puxe o problema correspondente do Sentry e correlacione stacktraces com a última implantação.✓ Copiado

cloud-run + mcp-context-forge

Hospede o próprio ContextForge no Cloud Run para federar MCPs

Implante mcp-contextforge-gateway no Cloud Run com Redis para estado de federação. Registre nossos 3 MCPs existentes como backends.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list-projects		Descubra qual projeto direcionar (apenas local)	free
create-project	name, project_id?	Inicialize um novo projeto GCP (apenas local)	free
list-services	project, region?	Veja o que está sendo executado em um projeto/região	free
get-service	project, region, service	Inspecione a configuração de um serviço específico	free
get-service-log	project, region, service, filter?, limit?	Depuração — puxe logs recentes	free
deploy-local-folder	folder_path, service, region, project, allow_unauthenticated?	Implante código que você tem localmente (apenas local)	free (build) + per-request Cloud Run pricing
deploy-file-contents	files: {path,content}[], service, region, project	Implante código gerado por agente sem arquivos locais	free (build) + per-request Cloud Run pricing

Custo e limites

O que custa rodar

Cota de API: Quotas GCP — generosas para API de implantação do Cloud Run
Tokens por chamada: Respostas de log podem ser grandes — pagine ou filtre agressivamente
Monetário: Cloud Run: tier gratuito ~2M req/mês, depois ~$0,40 por milhão de req + $0,000024 por vCPU-seg
Dica: Defina min-instances=0 para serviços não críticos — cold starts afetam, mas o custo cai para próximo de zero em inatividade

Segurança

Permissões, segredos, alcance

Escopos mínimos: roles/run.admin roles/iam.serviceAccountUser

Armazenamento de credenciais: Application Default Credentials via gcloud auth application-default login — nenhum arquivo de chave

Saída de dados: Chamadas para *.googleapis.com

Nunca conceda: roles/owner

Solução de problemas

Erros comuns e correções

Permissão negada na implantação

Sua conta precisa de roles/run.admin E roles/iam.serviceAccountUser na conta de serviço de tempo de execução. Verifique via gcloud projects get-iam-policy.

Build falhou com 'buildpack not detected'

Adicione um Dockerfile ou um arquivo que buildpacks reconheçam (package.json para Node, requirements.txt para Python, etc.).

Serviço implantado mas retorna 403

Ou allow_unauthenticated não foi definido, ou sua identidade de invocação carece de roles/run.invoker. Decida: público ou com gate IAM.

Conexões SSE MCP pendem / caem

Aumente --timeout=3600 e garanta min-instances=1 para evitar desconexões de cold start.

Alternativas

Google Cloud Run vs. outros

Alternativa	Quando usar	Troca
Vercel (for Next.js)	Você está hospedando especificamente um aplicativo Next.js	DX mais simples para Next.js; mais estreito que Cloud Run
AWS App Runner / Lambda MCP	Você está em AWS	Modelo serverless comparável, ecossistema diferente
Fly.io	Você quer edge global por padrão e preço mais simples	Ecossistema menor; sem MCP oficial ainda

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills