‏MCP Events: ChatGPT به رویدادهای سرور تو گوش می‌ده

اوپن‌ای‌آی مستندات قابلیتی به اسم MCP Events رو منتشر کرده. ایده‌ش ساده‌ست: سرور MCP تو (همون سروری که ابزارهات رو در اختیار ChatGPT می‌ذاره) می‌تونه به ChatGPT خبر بده یه اتفاق تازه افتاده، مثلا پیام جدید، تغییر محتوا یا عوض شدن وضعیت. خود کاربر انتخاب می‌کنه چی مانیتور بشه و با رسیدن خبر، ChatGPT چی کار کنه.

تو مستندات دو مثال اومده: مانیتور کردن کانال بازخورد محصول برای گزارش باگ و باز کردن pull request پیش‌نویس همراه فیکس و تست، یا زیر نظر گرفتن یه سند برای کامنت‌های ریویو و اعمال ویرایش‌های خواسته‌شده. فیلتر هم داره؛ مثلا message.created فقط برای یه channel_id خاص یا comment.created فقط برای یه document_id.

از نظر فنی، سرور باید events رو به capabilities جواب server/discover اضافه کنه و سه متد events/list و events/subscribe و events/unsubscribe رو پیاده کنه. ChatGPT موقع اشتراک یه آدرس callback و یه کلید امضا می‌فرسته و سرور از اون به بعد رویدادهای منطبق رو به همون آدرس POST می‌کنه. شکل چیزی که سرور می‌فرسته این‌جوریه:

{
  "eventId": "evt_456",
  "name": "comment.created",
  "timestamp": "2026-10-01T12:05:00Z",
  "data": {
    "document_id": "doc_123",
    "comment_id": "comment_456",
    "text": "Can we add the rollout dates to this section?"
  }
}

فیلدهای خود برنامه باید داخل data بمونن و با payloadSchema همون رویداد بخونن؛ یه type در سطح بالا یعنی این پیام یه نوتیفیکیشن کنترلی پروتکله، نه داده.

اوپن‌ای‌آی روی امنیت تاکید زیادی داره. آدرس callback حتما باید HTTPS باشه، قبل از فرستادن داده واقعی باید با یه challenge یک‌بارمصرف تایید بشه، ریدایرکت نباید دنبال بشه و آدرس‌های محلی و خصوصی باید بلاک بشن. امضای هر تحویل هم با Standard Webhooks و کلید اختصاصی همون اشتراک انجام می‌شه. یه توصیه مهم دیگه: متنی که کاربرها نوشتن رو داده حساب کن، نه دستور، و توش به مدل نگو چطور رفتار کنه.

محدودیت‌ها هم کم نیستن. این قابلیت به MCP 2.0 (نسخه پروتکل 2026-07-28) نیاز داره، فقط تحویل با وب‌هوک پشتیبانی می‌شه و polling و streaming و نوتیفیکیشن‌های کنترلی gap و terminated از اسپک پیش‌نویس پشتیبانی نمی‌شن. بدنه هر رویداد هم نباید از ۲۵۶ کیلوبایت رد بشه؛ برای رکوردهای بزرگ باید خلاصه فرستاد و یه ابزار read برای گرفتن نسخه کامل گذاشت.

نکات کلیدی:

• نیازمند MCP 2.0 با نسخه پروتکل 2026-07-28
• سه متد لازم روی همون اندپوینت احرازهویت‌شده ابزارها: events/list، events/subscribe، events/unsubscribe
• تحویل فقط با وب‌هوک؛ polling، streaming و کنترل‌های gap و terminated پشتیبانی نمی‌شن
• امضا با Standard Webhooks و کلید whsec_ که بعد از decode باید ۲۴ تا ۶۴ بایت باشه
• سقف حجم بدنه هر رویداد ۲۵۶ کیلوبایت