Un agente de programación moderno es capaz de reescribir un módulo por sí solo y enviar los cambios al repositorio, pero justo después del despliegue ese compañero inteligente se comporta de pronto como un niño impaciente en el asiento trasero del coche. Mientras la nube compila el proyecto, el agente golpea la API sin parar preguntando: «¿Ya está listo?». La actualización del servidor Vercel MCP y la beta Vercel Connect lanzadas el 30 de octubre, que analizó Julian Goldie, resuelven este problema: ahora el agente no satura el servidor con comprobaciones, sino que espera tranquilo la señal de compilación exitosa o de fallo.
La trampa del polling frente al modelo basado en eventos
Tomemos una tarea conocida: tu agente en Claude Code o basado en Vercel AI SDK actualizó paquetes, envió un commit y espera la compilación en Vercel.
En el esquema clásico de sondeo (polling), el agente no escucha notificaciones entrantes: pregunta él mismo. Cada 5–10 segundos invoca check_status y recibe como respuesta que la compilación sigue en curso. La ventana de contexto del modelo funciona como la memoria operativa humana: cada informe intermedio queda en el diálogo con todas sus cabeceras. Al final, hasta un 30–40% del presupuesto de tokens se quema en balde leyendo el estado «en proceso».
El modelo basado en eventos dentro del estándar Model Context Protocol (MCP) cambia el principio mismo. Tras enviar el commit, el agente se suscribe una sola vez a los eventos del proyecto y libera el contexto, quedando en reposo mientras dura la compilación. Si al cabo de 45 segundos la compilación falla por un conflicto de paquetes, el propio Vercel envía la señal deployment.error con la traza del error y el agente corrige al momento las dependencias.
Cómo funcionan las suscripciones y los webhooks bajo el capó de Vercel MCP
El protocolo MCP actúa como adaptador universal para conectar modelos a servicios externos (sobre su seguridad ya hablé en el análisis de arquitectura de servidores MCP). Al suscribirse mediante @vercel/mcp, @vercel/connect o @ai-sdk/mcp, el agente filtra las notificaciones por equipo (team), proyecto (project) y entorno (environment), eligiendo las señales necesarias:
deployment.succeeded— compilación exitosa, devuelve la URL pública de vista previa;deployment.error— la compilación falló, devuelve el log de la pila de errores del compilador.
Entre bastidores, Vercel MCP levanta un webhook temporal: un timbre que suena cuando el repartidor ya está en la puerta. Mientras el agente renueva la suscripción, el webhook sigue vivo, y si se olvida de él, caduca y se elimina solo. En este changelog me gustó especialmente un detalle de límites: los webhooks normales en Vercel están limitados a 40 por cuenta, pero los webhooks de eventos MCP van por una cuota aparte por equipo. Cada entrega sigue el estándar Standard Webhooks: en el campo data viaja el JSON nativo de Vercel, sellado con firma criptográfica.
Receptor de eventos en TypeScript y limitaciones de la versión beta
Para capturar la señal, consulté la receta Receive MCP Webhook Events del AI SDK Cookbook y la contrasté con la documentación de Vercel Webhooks. Montemos un receptor de servidor (receiver) que reciba la notificación tras el despliegue de 45 segundos, verifique la firma x-vercel-signature y lance la reparación ante un fallo:
import { createHmac } from "node:crypto";
import type { Request, Response } from "express";
export async function handleVercelMcpEvent(req: Request, res: Response) {
const sig = req.headers["x-vercel-signature"] as string;
const secret = process.env.VERCEL_WEBHOOK_SECRET || "";
const hmac = createHmac("sha1", secret).update(JSON.stringify(req.body)).digest("hex");
if (sig !== hmac) return res.status(401).json({ error: "Invalid signature" });
const { type, payload } = req.body;
if (type === "deployment.error") {
await triggerAgentRepairLoop({
projectId: payload.project.id,
errorLog: payload.error?.log,
commitSha: payload.deployment.meta?.githubCommitSha
});
}
return res.status(200).json({ status: "acknowledged" });
}
La llamada createHmac("sha1", secret) compara el hash del cuerpo de la petición con la cabecera x-vercel-signature y rechaza falsificaciones con código 401. Si la firma coincide, el filtro type === "deployment.error" arranca triggerAgentRepairLoop, pasando al agente el ID del proyecto, el log payload.error?.log y el hash del commit githubCommitSha.
Ten en cuenta tres detalles de la beta: cerrar el cliente MCP no cancela la suscripción (hace falta una baja explícita o que venza el temporizador), el receptor requiere un dominio HTTPS sin redirecciones con token Vercel OpenID Connect (en local te saca del apuro ngrok) y el diseño propio de MCP Events sigue siendo una propuesta experimental dentro del estándar.
Pasar del polling a las señales por eventos no solo ahorra un tercio del presupuesto de tokens. A mi modo de ver, delegamos la rutina en los agentes ante todo por tranquilidad y tiempo libre: para no hipnotizarnos mirando el indicador de compilación, sino dedicarnos a trabajo de ingeniería real mientras la automatización repara por sí sola los paquetes caídos.

