MCP سرور

1. ایجنٹ اس سے کیا کر سکتا ہے

Model Context Protocol کلائنٹ کو اینڈپوائنٹ دیں، اور وہ پوچھ سکتا ہے “اس ماہ کس صفحے پر سب سے زیادہ غصے میں کلکس ہیں” یا “جرمنی کے دو منٹ سے طویل تین سیشن دکھائیں” — پھر سیشن چلانے والا لنک دے سکتا ہے۔

ٹول	جواب
mp_projects	یہ کلید کون سے پروجیکٹس پڑھ سکتی ہے
mp_overview	سیشنز، اشخاص، صفحے کے نظارے، دورانیہ، پریشانی کے اشارے
mp_sessions	ریکارڈنگ لنکس والے حالیہ سیشنز، ملک، آلے یا دورانیے سے چھانٹے گئے
mp_session	ایک سیشن: ترتیب سے صفحات، ایونٹس، ماخذ، آلہ
mp_pages	نظاروں سے ترتیب دیے صفحات، منفرد ملاحظہ کاروں سمیت
mp_frustration	صفحے کے مطابق غصے میں کلکس، بےاثر کلکس اور JavaScript کی خرابیاں
mp_goals	آپ کے اہداف اور ہر ایک کی تکمیل کی تعداد

2. رابطہ قائم کرنا

اینڈپوائنٹ یہاں POST لیتا ہے: /mcp اور Streamable HTTP استعمال کرتا ہے، پروٹوکول ورژن: 2026-07-28۔

توثیق عام MousePlayer پڑھنے والی API کلید سے ہے — وہی جو ترتیبات، API کلیدیں کے تحت بناتے ہیں، اور REST API لیتی ہے۔ دوسری سند نہیں۔ کلید منسوخ کرتے ہی ایجنٹ کی رسائی بھی ختم ہوتی ہے۔

پھر پروجیکٹ فعال کریں

API کلید پورا ورکاسپیس کھولتی ہے۔ یہ جان بوجھ کر ایسا نہیں کرتا: ہر پروجیکٹ کا انضمامات کے صفحے پر اپنا سوئچ ہے، جو طے شدہ طور پر بند ہے۔ غیر فعال پروجیکٹ اس میں نہیں آتا: mp_projects اور ایجنٹ ID کا اندازہ لگا کر بھی اسے نہیں پڑھ سکتا۔

یہ غیر ضروری کارروائی نہیں۔ تعیناتی اسکرپٹ کی API کلید ایک زیرِ اختیار جگہ رہتی ہے؛ ایجنٹ کی ترتیبات والی فائل کی کلید ماڈل کے سیاق میں جاتی ہے، جہاں حفاظت کی نوعیت کہیں ڈھیلی ہے۔ ایک وقت میں ایک پروجیکٹ کی اجازت موزوں کنٹرول ہے۔

3. صرف پڑھنا، اور یہ کیوں نہیں بدلے گا

ساتوں ٹولز میں سے کوئی کچھ نہیں لکھتا۔ اینڈپوائنٹ میں حذف، برآمد یا ترتیب کی تبدیلی نہیں — وقت کی کمی سے نہیں، بلکہ اس لیے کہ ایجنٹ جس ٹول کو چلا سکتا ہے اسے غلطی سے بھی چلا سکتا ہے۔

کیا واپس نہیں آتا

نہ اصل ریکارڈنگز، نہ DOM اسنیپ شاٹس، نہ IP پتے۔ ایجنٹ کو وہ ملتا ہے جو شخص انٹرفیس میں دیکھتا ہے، اور باقی دیکھنے کا لنک۔

شرح اور مدت کی حدود

فی کلید ساٹھ درخواستیں فی منٹ، REST API کی طرح۔ وقت کی مدت زیادہ سے زیادہ 365 دن اور فہرست 200 قطاریں؛ مختصر کیا گیا جواب یہ بتاتا ہے، کیونکہ خاموشی سے کٹی فہرست مکمل جیسی لگتی ہے۔

4. کلائنٹ بنانے والوں کے لیے

تین طریقے: server/discover، tools/list، tools/call۔ نہ سیشنز، نہ GET اسٹریم، نہ Last-Event-ID — یہ 2025-11-25 تک کے پروٹوکول ورژنز کا حصہ ہیں، اس کا نہیں۔ GET یا DELETE کو 405 ملتا ہے۔

ہر POST میں یہ ہوتا ہے: MCP-Protocol-Version، Mcp-Method اور اس کے لیے: tools/call، Mcp-Name، اور ہر ایک متن سے ملنا چاہیے۔ فرق ہونے پر یہ ملتا ہے: 400، JSON-RPC کی اس خرابی کے ساتھ: -32020؛ غیر معاون ورژن پر یہ ملتا ہے: 400، اس کے ساتھ: -32022 اور معاون ورژنز کی فہرست، تاکہ کلائنٹ ایک منتخب کر کے دوبارہ کوشش کرے۔

جان بوجھ کر دو طرح کی خرابیاں

غلط ساخت کی درخواست یا نامعلوم ٹول JSON-RPC خرابی ہے۔ “یہ پروجیکٹ اجازت یافتہ نہیں” یا “ایسا سیشن نہیں” عام نتیجہ لوٹاتا ہے، اس کے ساتھ: isError: true — کیونکہ دوسری قسم کے بعد ماڈل یہ پوچھ کر mp_projects دوبارہ کوشش کر سکتا ہے، پہلی سے بحال نہیں ہو سکتا۔

نتائج میں یہ ہوتا ہے: structuredContent اور وہی ڈیٹا متنی بلاک میں سیریلائز کیا جاتا ہے، تاکہ پرانے کلائنٹس کو بھی مفید معلومات ملیں۔