Событийная модель Vercel MCP: как webhooks избавили ИИ-агентов от бесконечного опроса серверовЗаметка · дайджест за 12 ноября
Событийный конвейер мгновенных вебхуков между облачным сервером и автономным кодинг-агентом
Заметка3 раздела≈ 4 мин

Событийная модель Vercel MCP: как webhooks избавили ИИ-агентов от бесконечного опроса серверов

Современный кодинг-агент способен сам переписать модуль и отправить правки в репозиторий, но сразу после деплоя этот умный напарник вдруг ведёт себя как нетерпеливый ребёнок на заднем сиденье машины. Пока облако собирает проект, агент бесконечно дёргает API вопросом: «Уже готово?». Вышедшее 30 октября обновление сервера Vercel MCP и бета Vercel Connect, которые разобрал Джулиан Голди, решают эту проблему: теперь агент не спамит сервер проверками, а спокойно ждёт сигнала об успешной сборке или сбое.

Ловушка поллинга и контраст с событийной моделью

Возьмём знакомую задачу: твой агент в Claude Code или на базе Vercel AI SDK обновил пакеты, отправил коммит и ждёт сборки на Vercel.

В классической схеме опроса (polling) агент не слышит входящие уведомления — он спрашивает сам. Каждые 5–10 секунд он вызывает check_status и получает ответ, что сборка ещё идёт. Контекстное окно модели работает как оперативная память человека: каждый промежуточный отчёт остаётся в диалоге со всеми заголовками. В итоге до 30–40% бюджета токенов сгорает впустую на чтение статуса «в процессе».

Событийная модель в стандарте Model Context Protocol (MCP) меняет сам принцип. Отправив коммит, агент один раз подписывается на события проекта и освобождает контекст, засыпая на время компиляции. Если через 45 секунд сборка падает из-за конфликта пакетов, Vercel сам присылает сигнал deployment.error со стеком ошибки, и агент сразу чинит зависимости.

Как устроены подписки и вебхуки под капотом Vercel MCP

Протокол MCP служит универсальным переходником для подключения моделей к внешним сервисам (о его защите я уже рассказывал в разборе архитектуры MCP-серверов). Подписываясь через @vercel/mcp, @vercel/connect или @ai-sdk/mcp, агент фильтрует уведомления по команде (team), проекту (project) и окружению (environment), выбирая нужные сигналы:

  • deployment.succeeded — сборка успешна, возвращается публичный URL превью;
  • deployment.error — сборка упала, возвращается лог стека ошибок сборщика.

За кулисами Vercel MCP поднимает временный вебхук (webhook) — дверной звонок, который звенит, когда курьер уже на пороге. Пока агент продлевает подписку, вебхук живёт, а если про него забыть, он сам истекает и удаляется. Меня в этом чейнджлоге особенно порадовала деталь с лимитами: обычные вебхуки в Vercel ограничены 40 штуками на аккаунт, но событийные вебхуки MCP идут по отдельной квоте на команду. Каждая доставка следует стандарту Standard Webhooks: в поле data лежит нативный JSON от Vercel, скреплённый криптографической подписью.

Приёмник событий на TypeScript и ограничения бета-версии

Чтобы поймать сигнал, я заглянул в рецепт Receive MCP Webhook Events из AI SDK Cookbook и сверил его с документацией Vercel Webhooks. Соберём серверный приёмник (receiver), который примет уведомление после 45-секундного деплоя, проверит подпись x-vercel-signature и запустит ремонт при сбое:

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" });
}

Вызов createHmac("sha1", secret) сверяет хеш тела запроса с заголовком x-vercel-signature и отбивает подделки кодом 401. При совпадении подписи фильтр type === "deployment.error" запускает triggerAgentRepairLoop, передавая агенту ID проекта, лог payload.error?.log и хеш коммита githubCommitSha.

Учти три детали беты: закрытие MCP-клиента не отменяет подписку (нужна явная отписка или истечение таймера), приёмнику требуется HTTPS-домен без редиректов с токеном Vercel OpenID Connect (локально выручит ngrok), а сам дизайн MCP Events пока остаётся экспериментальным предложением внутри стандарта.

Переход от поллинга к событийным сигналам бережёт не только треть бюджета токенов. По-моему, мы поручаем рутину агентам прежде всего ради спокойствия и свободы времени: чтобы не гипнотизировать индикатор сборки, а заниматься живой инженерной работой, пока автоматика сама чинит упавшие пакеты.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2