Vercel AI SDK, MCP 서버가 변경을 알려주면 에이전트가 바로 받아요 — 폴링 없이 웹훅으로

Vercel Connect가 MCP 서버의 웹훅 이벤트를 받아 서명 검증·구독 관리·자동 갱신까지 처리해 줘요. AI 에이전트가 새 이슈나 댓글을 폴링 없이 실시간으로 알 수 있어요.

컨텐츠랩 편집부 · 읽는 시간 3분

핵심 3줄

AI SDK 에이전트가 MCP 서버 이벤트를 웹훅으로 구독하면, 서버가 변경을 밀어주고(push) Vercel Connect가 서명을 검증해 전달해요. 폴링(주기적 확인)이 필요 없어요.
Connect가 구독 저장·리스 갱신·만료 정리를 대신 해요. 개발자는 수신 라우트(배달 검증 + 내구성 있는 인박스 + 중복 제거)만 맡으면 돼요. 패키지는 @vercel/connect 2.5.0 이상, @ai-sdk/mcp 2.0.74 이상이에요.
아직 퍼블릭 베타예요. 프로덕션 또는 커스텀 환경에서만 되고, 배달 내역 저장이나 재전송은 아직 없어서 수신 쪽에서 내구성 있는 인박스를 직접 만들어야 해요. 요금은 배달 1건 = 트리거 1건이에요.

🧪 CONTENTSLAB 평지켜보세요★★★★★실전 활용도 3/5

개발자

이벤트를 지원하는 MCP 서버와 연동하는 AI 에이전트를 만든다면, 폴링 루프를 걷어내고 이벤트가 올 때만 모델을 호출할 수 있어요. @vercel/connect + @ai-sdk/mcp 두 패키지로 구독·검증이 되고, 받은 이벤트를 저장하는 인박스는 직접 만들어요.

AI 크리에이터·마케터

새 메시지 요약, 새로 만든 이슈 검토, 문서 피드백 응답 같은 자동화를 만들 때(원문 예시), 폴링 대신 이 방식을 쓰면 호출 횟수와 지연이 줄어요. 단, 쓰는 MCP 서버가 이벤트를 지원해야 해요.

1인 사업자·기획자

Vercel에 에이전트를 올려서 '고객 피드백 → 자동 분류·답변 초안'을 만들고 싶을 때, 폴링 없이 이벤트가 올 때만 돌아가니 서버 비용을 아낄 수 있어요.

$ 바로 해 보기

1) pnpm add @vercel/connect @ai-sdk/mcp (쿡북 기준 @vercel/connect@^2.5.0 @ai-sdk/mcp@^2.0.74)
2) Vercel Connect에서 이벤트를 지원하는 MCP 서버용 커넥터를 만들고, 프로젝트·배포 환경 연결 + 계정 인증
3) 구독보다 먼저 app/hooks/route.ts 수신 라우트를 프로덕션(또는 커스텀 환경)에 배포 — experimental_verifyMcpEvent (@vercel/connect/mcp)로 배달 검증
4) createMCPClient + connectAuthProvider·experimental_connectEventsAdapter (@vercel/connect/ai-sdk)로 client.experimental_events.subscribe() 구독 (문서의 watchDocument 예제 따르기)
5) 구독 상태는 experimental_getSubscription (@vercel/connect/mcp)으로 확인

CONTENTSLAB 생각 · 이렇게 써 볼 수 있을 것 같아요

MCP 서버에 에이전트를 연결해서 변경이 생길 때만 모델을 호출하는 자동화를 만들어 보면 좋을 것 같아요. 아직 베타라 배달 재전송이 없는 점은 확인이 필요해요.

Vercel이 10월 15일 Vercel Connect의 MCP Events 지원을 퍼블릭 베타로 공개했고, AI SDK에서도 MCP Events를 쓸 수 있게 됐어요. MCP(Model Context Protocol) 서버가 보내는 웹훅 이벤트를 에이전트가 구독하고, Vercel Connect가 서명 검증·구독 저장·자동 갱신을 대신 처리해 줘요.

폴링 대신 밀어주기(push)

지금까지 에이전트가 외부 서비스의 변경을 알려면, 일정 간격으로 "새 것 있어?"라고 물어야 했어요(폴링). MCP Events는 서버가 변경이 생기면 웹훅으로 밀어줘요. Vercel Connect가 중간에서 서버 웹훅을 검증하고, 서명된 배달(authenticated delivery)로 앱에 전달해요. 앱은 experimental_verifyMcpEvent로 Connect가 보낸 것이 맞는지 확인한 뒤 처리하면 돼요.

구독 생명주기는 Connect가 관리

구독을 만들면 Connect가 MCP 서버에 웹훅을 등록하고, 리스(lease)가 만료되기 전에 자동으로 갱신해요. 개발자가 직접 갱신 타이머를 돌리거나 이벤트 저장소를 구현할 필요가 없어요. experimental_connectEventsAdapter를 쓰면 구독 생성·저장·갱신이 한 번에 돼요.

SDK 구성

두 패키지가 필요해요.

@vercel/connect 2.5.0 이상 — @vercel/connect/ai-sdk에서 connectAuthProvider(인증)와 experimental_connectEventsAdapter(구독 위임), @vercel/connect/mcp에서 experimental_verifyMcpEvent(배달 검증)
@ai-sdk/mcp 2.0.74 이상 — createMCPClient로 MCP 연결, client.experimental_events.subscribe()로 구독

구독 흐름은 이래요.

수신 라우트(예: app/hooks/route.ts)를 먼저 배포해요. experimental_verifyMcpEvent로 Connect가 보낸 배달인지 검증해요.
커넥터와 토큰 파라미터로 MCP 클라이언트를 만들어요.
experimental_events.list()로 서버가 지원하는 이벤트 목록을 확인해요.
subscribe()에 이벤트 이름·인자·멱등성 키·기간(ttlMs 또는 expiresAt)을 넣어 구독해요.

아직 베타 — 알아둘 것

프로덕션(Production) 또는 커스텀 환경(Custom Environment)에서만 돼요. 프리뷰 배포에서는 구독이 안 만들어져요.
Connect는 배달 내역 저장(durable outbox)이나 예약 재전송을 아직 제공하지 않아요. 수신 쪽에서 내구성 있는 인박스를 직접 만들어야 해요.
Connect가 보내는 배달은 세 가지예요. 비즈니스 이벤트(event), 다시 받을 수 없는 이벤트 간격(control.type: 'gap'), 서버가 구독을 끊음(control.type: 'terminated'). (onEvent·onGap·onTerminated는 Connect 없이 직접 받는 AI SDK 경로의 콜백이에요.)
요금은 Connect 트리거와 같아요. 배달 1건 = 트리거 1건이에요.

X 게시물 보기 · https://x.com/aisdk/status/2110785290885538113

MCP Events 설계는 아직 드래프트 사양 단계예요. Vercel 쪽 함수도 이름에 experimental_이 붙어 있어서, 사양이 바뀌면 API도 바뀔 수 있어요.

원문 화면 · Vercel Changelog · MCP Events support in Vercel Connect is now in public beta (2026-10-15)

원문 화면 · AI SDK Cookbook · Receive MCP Webhook Events — 구독·검증·수신 코드 예제

출처 (원문)