Kanji
・Ingeniero Cloud / Freelance ・Nacido en 1993 ・De Ehime / Residente en Shibuya, Tokio ・5 años de experiencia en AWS Detalles del perfil
Índice
Cuando comencé a integrar agentes de codificación IA como Antigravity y Claude Code en flujos de infraestructura a finales de 2025, una de mis prioridades fue desplegar servidores remotos del Model Context Protocol (MCP) para consultar bases de datos internas, conjuntos de datos en BigQuery y scripts operativos.
En aquel momento, el transporte estándar en MCP era Server-Sent Events (SSE) con estado sobre HTTP. En localhost funcionaba sin inconvenientes, pero al desplegar el contenedor en Google Cloud Run surgieron fallos críticos en producción:
localhost
initialize
tools/call
404 Session Not Found
min-instances: 1
La publicación de la especificación MCP 2026-07-28 resolvió este problema de raíz al eliminar el estado del núcleo del protocolo.
▲ Arquitectura general: Acceso zero-trust desde agentes IA locales hacia servidores MCP sin estado en Cloud Run mediante Google Cloud IAM
Mcp-Session-Id
_meta
Mcp-Method
Mcp-Name
Cuando una herramienta requiere aprobación humana (HITL), el servidor ya no mantiene el socket abierto: devuelve input_required junto con un continuation_token y cierra limpiamente la petición HTTP .
input_required
continuation_token
En lugar de exponer claves estáticas en cabeceras X-Api-Key , desplegamos Cloud Run con --no-allow-unauthenticated y otorgamos el rol de mínimo privilegio roles/run.invoker .
X-Api-Key
--no-allow-unauthenticated
roles/run.invoker
# 0. Otorgar roles/run.invoker de mínimo privilegio a la identidad llamante gcloud run services add-iam-policy-binding mcp-secops-server \ --region=asia-northeast1 \ --member="user:developer@example.com" \ --role="roles/run.invoker" # 1. Obtener la URL del servicio Cloud Run SERVICE_URL=$(gcloud run services describe mcp-secops-server --region asia-northeast1 --format 'value(status.url)') # 2. Generar un token OIDC con la audiencia exacta del servicio ID_TOKEN=$(gcloud auth print-identity-token --audiences="${SERVICE_URL}") # 3. Enviar petición stateless con cabecera Mcp-Method y Bearer token curl -s -X POST "${SERVICE_URL}/mcp" \ -H "Authorization: Bearer ${ID_TOKEN}" \ -H "Mcp-Method: tools/list" \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | jq .
▲ Seguridad en Cloud Run: Bloqueo de tráfico no autenticado y asignación de mínimo privilegio con roles/run.invoker
// src/server.ts import express, { Request, Response } from 'express'; const app = express(); app.use(express.json()); app.get('/healthz', (_req: Request, res: Response) => { res.status(200).send('OK'); }); app.post('/mcp', async (req: Request, res: Response) => { const mcpMethod = req.header('Mcp-Method') || req.body?.method; const requestId = req.body?.id ?? 1; if (mcpMethod === 'tools/list' || req.body?.method === 'tools/list') { return res.json({ jsonrpc: '2.0', id: requestId, result: { tools: [ { name: 'query_security_audit_logs', description: 'Consulta eventos críticos de seguridad en Cloud Logging', inputSchema: { type: 'object', properties: { hoursAgo: { type: 'number', description: 'Ventana de búsqueda en horas' }, severity: { type: 'string', enum: ['WARNING', 'ERROR', 'CRITICAL'] } }, required: ['severity'] } } ] } }); } if (mcpMethod === 'tools/call' || req.body?.method === 'tools/call') { const { name, arguments: args } = req.body.params; if (name === 'query_security_audit_logs') { const severity = args?.severity || 'ERROR'; const mockLogs = [ { timestamp: new Date().toISOString(), severity: severity, resource: 'projects/my-prod-project/instances/db-01', message: 'IAM authorization check failed' } ]; return res.json({ jsonrpc: '2.0', id: requestId, result: { content: [{ type: 'text', text: JSON.stringify(mockLogs, null, 2) }], isError: false } }); } return res.status(404).json({ jsonrpc: '2.0', id: requestId, error: { code: -32601, message: `Tool ${name} not found` } }); } return res.status(400).json({ jsonrpc: '2.0', id: requestId, error: { code: -32600, message: `Unsupported method: ${mcpMethod}` } }); }); const PORT = process.env.PORT || 8080; app.listen(PORT, () => { console.log(`[MCP Server] Stateless Remote MCP listening on port ${PORT}`); });
FROM node:22-alpine AS builder WORKDIR /app COPY package*.json tsconfig.json ./ RUN npm ci COPY src ./src RUN npm run build FROM node:22-alpine AS runner WORKDIR /app ENV NODE_ENV=production COPY package*.json ./ RUN npm ci --only=production COPY --from=builder /app/dist ./dist USER node EXPOSE 8080 CMD ["node", "dist/server.js"]
PROJECT_ID="your-gcp-project-id" REGION="asia-northeast1" SERVICE_NAME="mcp-secops-server" gcloud run deploy "${SERVICE_NAME}" \ --source . \ --region "${REGION}" \ --project "${PROJECT_ID}" \ --no-allow-unauthenticated \ --min-instances 0 \ --max-instances 10 \ --cpu 1 \ --memory 512Mi \ --concurrency 80 \ --timeout 60s
mcp_config.json
{ "mcpServers": { "cloudrun-secops": { "command": "node", "args": [ "/usr/local/bin/cloudrun-mcp-proxy.js", "--url", "https://mcp-secops-server-xyz-an.a.run.app/mcp" ], "env": { "CLOUD_RUN_AUDIENCE": "https://mcp-secops-server-xyz-an.a.run.app" } } } }
Para pruebas locales también puede ejecutar gcloud run services proxy mcp-secops-server --region=asia-northeast1 --port=8080 , que inyecta automáticamente tokens OIDC hacia http://localhost:8080/mcp .
gcloud run services proxy mcp-secops-server --region=asia-northeast1 --port=8080
http://localhost:8080/mcp
▲ Registro de verificación demostrando la generación dinámica de tokens con gcloud auth y la ejecución exitosa de herramientas MCP sin estado
--min-instances 1
gcloud auth print-identity-token
Authorization
X-Upstream-Authorization
La especificación MCP 2026-07-28 marca la madurez cloud-native del protocolo para agentes IA, permitiendo aprovechar al máximo el autoescalado, scale-to-zero y la seguridad IAM de Google Cloud Run.
Real-time AI quant analysis of corporate earnings reports.
Entrene habilidades sociales con llamadas simuladas realistas, retroalimentación en 5 ejes, academia interactiva y fotos de perfil con IA.
Fotografíe recibos para un desglose instantáneo con IA. Conexión directa con LINE para liquidar gastos compartidos sin fricción.
Personajes de IA (Adivina, Mayordomo, Barman) moderan dinámicas y retos en tiempo real para animar cualquier reunión.
人工甘味料や添加物のNG除外と有効成分あたりの実質単価比較データベース。