API Gateway MCP de Google: qué es y cómo usarlo hoy

API Gateway MCP de Google Cloud es la función en Public Preview anunciada el 24 de septiembre de 2026 que convierte tu gateway en un servidor MCP remoto: anotas el OpenAPI 3.x que ya despliegas y tus operaciones REST pasan a ser tools para agentes, sin montar ni mantener un servidor MCP aparte.

• Producto: Model Context Protocol en Google Cloud API Gateway (Public Preview)
• Empresa: Google Cloud / Google Developers
• Fecha: 24 de septiembre de 2026 (anuncio en Google Developers Blog; preview también documentada desde ~11 sep 2026 en release notes)
• Qué hace: recibe JSON-RPC MCP en /mcp, transcodifica tools/call a REST y aplica las mismas políticas (JWT, API key, cuota, logging)
• Requisito de spec: OpenAPI 3.0.x o 3.1.x (OpenAPI 2.0 no soportado)
• Para quién: equipos con APIs en Cloud Run / REST detrás de API Gateway que quieren exponerlas a agentes (ADK, Gemini Enterprise, clientes MCP)
• Fuente: Google Developers Blog (24 sep 2026)

Qué cambió el 24 de septiembre de 2026

• Gateway = servidor MCP: ya no necesitas reimplementar routing, auth y cuota en un MCP server separado.
• Una sola ruta de políticas: MCP y REST comparten auth, cuota y logs; una operación consume la misma cuota sin importar cómo se invoque.
• Opt-in por OpenAPI: x-google-api-management.mcp a nivel documento; x-google-mcp-tool por operación (nombre, descripción o false para excluir).
• Descubrimiento controlable: tools/list por defecto sin auth (útil en dev); en producción se recomienda JWT (API key no vale para list).
• Encaje en el stack Google: API Gateway = on-ramp ligero; Apigee para plataforma enterprise; Agent Gateway para gobernar llamadas salientes de agentes.

Para quién sirve

• Equipos Latam con microservicios en Cloud Run que ya tienen API Gateway y quieren que Claude, Gemini o agentes ADK llamen esas APIs como tools.
• Ops y plataforma que no quieren operar otro servicio solo para MCP.
• Productos B2B que ya documentan OpenAPI 3.x y necesitan que agentes descubran tools con descripción clara.

Cómo usarlo paso a paso

1. Migra a OpenAPI 3.x si tu gateway aún usa OpenAPI 2.0 (MCP no soporta 2.0).
2. Anota el spec: activa MCP con x-google-api-management.mcp: true (o el objeto con tools-list.security). En cada operación útil define x-google-mcp-tool con name y una descripción orientada a cuándo usarla (no solo qué devuelve). Cada operación necesita backend y descripción no vacía.
3. Despliega la API config como siempre. El gateway sirve MCP en la ruta base /mcp (según URL del gateway / x-google-endpoint).
4. Asegura discovery en producción: configura JWT en tools-list.security. tools/call siempre aplica la auth de la operación REST subyacente.
5. Conecta tu agente: apunta el cliente MCP (p. ej. McpToolset en ADK con StreamableHTTPConnectionParams) a https://TU-GATEWAY.../mcp e incluye el header de credencial que ya espera el gateway (API key, Bearer, etc.).
6. Prueba con curl un tools/call JSON-RPC (método + params.name + arguments) y verifica que la respuesta del backend vuelve como resultado MCP.

Límites del Public Preview (importante)

• Cubre REST + OpenAPI 3.x con la autenticación actual del gateway.
• Aún no: MCP resources/prompts, response streaming, inspección Model Armor (roadmap).
• Operaciones con cuerpo vacío (p. ej. HTTP 204) no se exponen.
• Schemas de objetos muy anidados pueden no renderizar completo en tools/list.
• Hasta 1.000 tools por gateway.
• MCP y model routing no pueden ir en la misma API config.

FAQ

¿Qué es API Gateway MCP de Google?

Es la capacidad de Google Cloud API Gateway (Public Preview, anuncio 24 sep 2026) de actuar como servidor MCP remoto y exponer operaciones REST existentes como tools para agentes, sin un servidor MCP separado.

¿Necesito reescribir mi backend?

No. Anotas el OpenAPI 3.x, despliegas y el gateway transcodifica tools/call a la petición REST equivalente bajo las mismas políticas.

¿Cómo protejo el listado de tools?

Por defecto tools/list está abierto. En producción usa JWT en tools-list.security; las API keys no aseguran ese método. Las invocaciones sí respetan la auth REST de cada operación.

¿API Gateway o Apigee?

API Gateway es el on-ramp ligero (p. ej. Cloud Run + agentes en minutos). Para ciclo de vida enterprise, políticas avanzadas y monetización, Google apunta a Apigee. Para gobernar qué llaman tus agentes hacia afuera, Agent Gateway.

¿Dónde está la fuente?

Google Developers Blog del 24 de septiembre de 2026 (“Turn your REST APIs into MCP tools with Google Cloud API Gateway”) y la documentación de MCP en API Gateway.

Enlaces útiles

• Google Developers Blog · REST a MCP tools (24 sep 2026)
• Docs · MCP overview en API Gateway
• Docs · Configurar MCP
• Más noticias IA · IA University
• IA University · Cursos gratis edu.ia.university · Certificación Asesor-IALab

Certifícate y sigue aprendiendo

1) Certifícate GRATIS en http://edu.ia.university/
2) Certificación IA internacional: https://ia.university/Asesor-IALab