MCP Events は、MCP(Model Context Protocol)に「外の出来事でエージェントを起こす」入口を加える公式の拡張だ。2026年11月20日に仕様 SEP-3415 が Final になり、拡張はベータとして公開された。編集部は仕様の原文と対応表を読み、Webhook で届くイベントの署名を手元で検証した。

WHAT CHANGES何が変わるか

「聞かれたら答える」MCP に、外の出来事で起きる入口が加わる

これまでの通知

resources/updated・list_changed

  • 「変わった」だけで、引数も中身も無い
  • つながっている間しか届かない
  • 切れている間の出来事は失われる

MCP Events(ベータ)

io.modelcontextprotocol/events

  • 引数で絞って購読し、中身つきで届く
  • Poll・Push・Webhook の3方式
  • cursor で再開。取りこぼしは truncated で分かる
出典: modelcontextprotocol.io Events overview・SEP-3415(Final、2026-11-20 にベータ)

30秒でわかる MCP Events(2026-11-21時点)

  • ・何ができる:新着メール・push・障害などの「上流の出来事」を、引数で絞って購読し、起きたらエージェントに渡す
  • ・届け方:Poll(取りに行く)・Push(流してもらう)・Webhook(POST してもらう)の3方式。サーバーが種類ごとに選ぶ
  • ・対応:対応表では MCPJam(3方式)と ChatGPT(Webhook のみ)。Claude・Cursor などはまだ印が無い
  • ・実測:Webhook の署名を検証した。生の本文なら一致し、1文字の改ざんでも、JSON を整形し直しただけでも一致しない

仕様の作者による告知と紹介動画(X 投稿)は次のとおり。

MCP サーバーの作り方の基本は MCPサーバーの作り方2026年完全ガイド:TypeScript・Python両対応チュートリアルにまとめている。Events が前提にする 2026-07-28 版までの仕様の流れは MCPの仕組み|リクエストの流れ・3つの機能・仕様改訂(2024-11-05〜2026-07-28)を図解、本番のエージェントでの MCP の使い方は Anthropic MCPガイド2026|Model Context Protocolで本番エージェントを構築 にある。

MCP Events とは:聞かれなくても動くための拡張

MCP Events は、利用者がいないあいだに起きた出来事にエージェントを反応させるための拡張だ。 MCP はリクエストで動く。利用者かモデルが聞き、サーバーが答える。しかしエージェントには、新しいメール、リポジトリへの push、本番の障害のように「誰も聞いていないときに起きること」に動いてほしい場面が増えている、と公式の概要は書く。

これまでも MCP には notifications/resources/updated や list_changed の通知があった。仕様(SEP-3415)は、それでは足りない理由を3つ挙げる。

これまでの通知の限界 Events での扱い
引数も中身も無い。「P1 の障害がサービス X で起きた」を表せない 購読に引数(inputSchema)、中身に型(payloadSchema)がある
開いた接続の上でしか届かない。つながっていないクライアントには何も届かない Poll・Push・Webhook から、配置に合う方式を選べる
再開できない。切れている間の出来事は失われ、失ったことも分からない cursor で続きから再開。取りこぼしは truncated: true で知らせる

告知したのは、仕様の作者で Tasks and Events Working Group のリーダーの Peter Alexander 氏(@Poita_)だ。「クライアントとサーバーが採用してフィードバックできる段階になった。仕様の問題を直して安定させたい」と書いている。同じワーキンググループのリーダーには、AWS と Microsoft の人も名を連ねる。

MCP Events の仕組み:発見・購読・配信・再開

サーバーが出来事の種類を示し、クライアントが引数をつけて購読し、届いた出来事を cursor つきで受け取る。 公式の概要は、流れを6段階で説明している。

HOW AN EVENT TRAVELS届くまで

上流の出来事が、cursor つきでエージェントに届く

  1. 上流のシステム

    メール、リポジトリへの push、障害など

  2. MCP サーバー

    events/list で種類と schema を示す

  3. 届け方

    Poll・Push・Webhook のどれか

  4. クライアント SDK

    cursor を保存、eventId で重複を除く

  5. エージェント

    新しいターンを始めるかを決める

出典: modelcontextprotocol.io Events overview「How Events work」
  1. 能力の確認:サーバーは server/discover で io.modelcontextprotocol/events を示す
  2. 発見:クライアントが events/list を呼ぶ。種類ごとに名前・引数の型・中身の型・使える届け方が返る
  3. 購読:名前と引数で購読する。cursor: null は「今から」を意味する
  4. 配信:出来事は {eventId, name, timestamp, data, cursor} の形で届く
  5. 再開:切れたあとは保存した cursor で購読し直す。その位置から出せないときは truncated: true
  6. 反応:クライアント SDK がエージェントの実行環境に渡し、新しいターンを始めるかを決める

THREE DELIVERY MODES3つの届け方

サーバーは種類ごとに使える方式を選ぶ(必須の方式は無い)

  1. Poll

    events/poll

    指示された間隔で取りに行く。サーバーはクライアントごとの状態を持たない

    サーバーレス向き

  2. Push

    events/stream

    長く開いた要求の上に、通知として流れてくる

    stdio・つなぎっぱなし

  3. Webhook

    events/subscribe

    https のコールバック URL に署名つきで POST。TTL で更新

    リモート・接続を保てない

出典: modelcontextprotocol.io Events overview「Delivery modes」・SEP-3415

3つの方式に必須のものは無い。サーバーは種類ごとに使える方式を並べ、クライアント SDK はそこから選ぶ。SDK は普通、コールバックの受け口があれば Webhook、なければ Push、最後に Poll の順で選ぶ、と概要にある。

保証の範囲も仕様に書かれている。上流が履歴を保てて、クライアントが最後の cursor から再開すれば「少なくとも1回」届く。履歴を持たない種類は cursor: null を返し、その場合は空白の期間の出来事を取り戻せない。順序は Poll と Push では購読の中で保たれ、Webhook はベストエフォートで、timestamp で並べる。購読の一覧はクライアントが持ち、サーバーには購読を一覧するメソッドが無い。

範囲外として、購読より前の出来事の再生、SQS・Kafka などのメッセージキューへの直結、あるサーバーの出来事で別のサーバーのツールを動かすこと、確実な配達の保証が挙げられている。

MCP Events のセキュリティ:届いたイベントは信用しない

届いたイベントの中身は外部のデータとして扱い、イベントを受けたことは、エージェントが行動してよい許可にはならない。 仕様はこの2点をはっきり書いている。

WEBHOOK HARDENINGWebhook の門

届いたイベントは信用しない前提で、署名と宛先で止める

受け口の門

  • 届く署名が合い5分以内 受けるwebhook-signature(HMAC-SHA256)
  • 届く改ざんした配信 拒否署名が一致しない
  • 登録http の URL InvalidParamsevents/subscribe
  • 渡すイベントの中身 ツール結果と同じく未信頼外部システム由来
出典: SEP-3415「Webhook security」「Event payloads are untrusted data」
決まり 仕様の内容
中身は未信頼 外部システムから来るので、プロンプトインジェクションを含みうる。ツールの結果と同じく、モデルに渡す前に無害化か隔離をする
中身は最小に 送るのは見分けて振り分けるのに足りる分(差出人・件名・ID など)。全文はクライアントがツールで取りに行く
認可は毎回 購読時に確かめ、配信時にも確かめ直し、権限が取り消されたら購読を終える。イベントを受けても行動の許可にはならず、続くツール呼び出しは通常の MCP の認可を通る
Webhook の宛先 https 以外の URL は拒否。宛先 IP を調べて SSRF を防ぐ。配信前に、受け口が本当に受けたいかを確かめる(チャレンジの往復・許可リスト・/.well-known/mcp-webhook-receiver.json など)
Webhook の署名 Standard Webhooks 方式の HMAC-SHA256。秘密鍵はクライアントが whsec_+24〜64バイトの base64 で渡し、サーバーは作らない。5分より古い配信は受け口で拒否してよい

署名は「受け取った生の本文」で計算しなければならない、と仕様は念を押している(パースして書き直した JSON で計算してはいけない)。

Webhook の署名を自分で検証する

受け口を作るなら、まず署名の検証だけを単体で動かしておくとよい。 編集部は、Standard Webhooks の公式 Python ライブラリ(standardwebhooks 1.3.0)で署名つきの配信を作り、OpenSSL だけで検証できるかを確かめた。

# Webhook 用の秘密鍵を作る(whsec_ と 32 バイトの base64。仕様は 24〜64 バイト)
printf 'whsec_%s\n' "$(openssl rand -base64 32)"

検証は次のスクリプトで行う。届いたヘッダーの値を環境変数に入れ、受け取った本文をファイルのまま渡す。

# verify-webhook.sh — 使い方:
# SECRET=whsec_... ID=<webhook-id> TS=<webhook-timestamp> SIG='<webhook-signature>' sh verify-webhook.sh <受け取った本文のファイル>
key=$(printf '%s' "${SECRET#whsec_}" | base64 -d | od -An -tx1 | tr -d ' \n')
calc=$(printf '%s.%s.' "$ID" "$TS" | cat - "$1" | openssl dgst -sha256 -mac HMAC -macopt hexkey:"$key" -binary | base64)
case " $SIG " in *" v1,$calc "*) echo "OK: 署名が一致" ;; *) echo "NG: 署名が一致しない"; exit 1 ;; esac
MCP Events の Webhook 署名を検証した端末画面の比較。左は受け取った本文のままで、1行の JSON のまま検証すると OK: 署名が一致。右は同じ中身をパースして整形し直した本文で、検証すると NG: 署名が一致しない

結果は次のとおり(OpenSSL 3.0.13・2026-11-21)。

渡した本文 結果
受け取った本文のまま OK(ライブラリが作った署名と一致)
1文字だけ書き換えた本文(P1 → P3) NG
同じ中身を整形し直した JSON NG
署名欄に2つの署名(鍵の切り替え中を想定) OK(どちらかが合えば通す)

整形し直した JSON が通らないのは、仕様の「生の本文で計算する」とおりの結果だ。フレームワークが本文を先にパースする作りだと、ここでつまずく。なお xxd が入っていない環境もあるので、鍵の16進変換は od で書いている。

MCP Events に対応しているクライアントと、今やること

2026年11月21日時点で、Events の印があるクライアントはまだ2つだけだ。 使うにはクライアントとサーバーの両方が拡張を有効にし、プロトコルの 2026-07-28 版以降に対応している必要がある。

クライアント Events の対応(公式の対応表)
MCPJam 対応(Poll・Push・Webhook)
ChatGPT 一部(Webhook のみ)
Claude(web・Desktop)・Claude Code・Cursor・VS Code の GitHub Copilot・Goose・Postman など 印なし

対応表には「多くの実装は SEP-3415 が Final になる前の下書きの仕様を追っている」という注記もある。Postman で MCP を担当する Infoxicador 氏は、3方式すべての対応を進めているとポストしている。

動画では、Postman の MCP リクエスト画面に「Events」タブがあり、counter.changed という出来事を push・poll・webhook から方式を選んで購読している。increment ツールでカウンターを上げると、右の AI のチャットに「値が5に変わった」「6に変わった」とイベントが届き、エージェントが内容を伝え直す。公式の対応表にはまだ Postman の印が無いので、開発中の機能の紹介として見ておきたい。

参照実装は、公式 TypeScript SDK のプルリクエスト(typescript-sdk#3209:サーバーとクライアント、3方式すべて)と、公式 Python SDK の上に載せたサーバー側の実装(mcp-webhook-events)がある。適合テスト(conformance#521)はレビュー中だ。仕様リポジトリ ext-events の README には「実験的なインキュベーションの場」という注記が残っていて、仕様の本文は specification/beta にある。

立場 今やること
MCP サーバーを作る人 出来事の種類ごとに inputSchema・payloadSchema と届け方を決める。上流の ID を eventId に、上流の位置を cursor に入れる
Webhook を受ける人 生の本文で署名を検証し、X-MCP-Subscription-Id で購読ごとの鍵を選ぶ。eventId での重複除去は購読ごとに行う
エージェントを使う人 対応表で使うクライアントの印を確かめる。届いた中身をそのまま指示として扱わない

SDK がイベントをエージェントにどう渡すか(文脈に入れるか、特別なメッセージにするか)は、仕様でも未解決の論点として残っている。

参照ソース