MCP سرور

1. ايجنٽ ان سان ڇا ڪري سگهي ٿو

Model Context Protocol ڪلائنٽ کي endpoint ڏيو ته “هن مهيني ڪهڙو صفحو سڀ کان وڌيڪ ڪاوڙ وارا ڪلڪ پيدا ڪري ٿو” يا “جرمني جا ٻن منٽن کان ڊگها ٽي سيشن ڏيکاريو” جهڙا سوال پڇي سگهي — ۽ پوءِ سيشن هلائيندڙ لنڪ ڏئي.

اوزار	جواب ڏئي ٿو
mp_projects	هي key ڪهڙا پروجيڪٽ پڙهي سگهي ٿي
mp_overview	سيشن، ماڻهو، صفحن جا ڏيک، مدو، مايوسي جا اشارا
mp_sessions	ٻيهر پلے لنڪن سان تازا سيشن، ملڪ، اوزار يا مدي موجب فلٽر ٿيل
mp_session	هڪ سيشن: ترتيب ۾ صفحا، واقعا، ذريعو، اوزار
mp_pages	ڏيکن موجب صفحا، منفرد مهمانن سان
mp_frustration	ڪاوڙ وارا ڪلڪ، بي اثر ڪلڪ ۽ JavaScript غلطيون، صفحي موجب گڏ
mp_goals	توهان جا مقصد ۽ هر هڪ ڪيترا ڀيرا حاصل ٿيو

2. ڳنڍڻ

Endpoint هتي POST وٺي ٿو /mcp ۽ Streamable HTTP، پروٽوڪول ورزن هي استعمال ڪري ٿو 2026-07-28.

تصديق عام MousePlayer پڙهڻ واري API key آهي — ساڳي جيڪا سيٽنگون، API key هيٺ ٺاهيو ٿا، ۽ ساڳي قسم جيڪا REST API وٺي ٿي. ڪا ٻي سند ناهي. Key واپس وٺڻ سان ساڳئي لمحي ايجنٽ جي رسائي واپس ٿئي ٿي.

پوءِ پروجيڪٽ فعال ڪريو

API key سڄي ڪم جي جاءِ کولي ٿي. هي ڄاڻي واڻي ائين نٿو ڪري: هر پروجيڪٽ جو ڳانڍاپن جي صفحي تي پنهنجو سوئچ آهي، ڊفالٽ بند. غير فعال پروجيڪٽ هن ۾ نٿو اچي mp_projects ۽ ايجنٽ ID جو اندازو لڳائي تڏهن به پڙهي نٿو سگهي.

اها بي سبب ڪارروائي ناهي. Deploy اسڪرپٽ ۾ API key توهان جي ڪنٽرول واري هڪ هنڌ تي رهي ٿي؛ ايجنٽ جي ترتيب فائل واري key ماڊل جي پس منظر ۾ وڃي ٿي، جتي سنڀال گهڻي ڍري آهي. هڪ وقت هڪ پروجيڪٽ کولڻ ان سان ٺهڪندڙ ڪنٽرول آهي.

3. رڳو پڙهڻ، ۽ اهو ڇو نه بدلجندو

ستن مان ڪو اوزار ڪجهه نٿو لکي. هن endpoint پويان نه ختم ڪرڻ، نه ايڪسپورٽ، نه ترتيب بدلائڻ — وقت نه هجڻ سبب نه، پر ايجنٽ جنهن اوزار کي سڏي سگهي، اهو غلطي سان به سڏي سگهي ٿو.

ڇا نٿو موٽائي

خود رڪارڊنگون نه، DOM تصويرون نه، IP پتا نه. ايجنٽ کي اهو ملي ٿو جيڪو ماڻهو انٽرفيس ۾ ڏسي ٿو، ۽ باقي ڏسڻ جو لنڪ.

درخواست ۽ حد جون پابنديون

هر key لاءِ هر منٽ سٺ درخواستون، REST API جهڙيون. وقت جي حد 365 ڏينهن ۽ نتيجن جي فهرست 200 قطارن تائين؛ ڪٽيل جواب ائين ٻڌائي ٿو، ڇاڪاڻ ته خاموش ڪٽيل فهرست مڪمل جهڙي لڳي ٿي.

4. ڪلائنٽ ٺاهيندڙن لاءِ

ٽي طريقا: server/discover، tools/list، tools/call. نه سيشن، نه GET stream، نه Last-Event-ID — اهي 2025-11-25 تائين پروٽوڪول ورزنن جا آهن، هن جو حصو ناهن. GET يا DELETE کي 405 ملي ٿو.

هر POST هي کڻي ٿو MCP-Protocol-Version، Mcp-Method ۽، هن لاءِ tools/call، Mcp-Name، ۽ هر هڪ body سان ملڻ گهرجي. نه ملڻ تي هي آهي 400 ، JSON-RPC غلطي هن سان -32020؛ غير سهائتا ورزن هي آهي 400 هن سان -32022 ۽ سهائتا ڪيل ورزنن جي فهرست سان، ته ڪلائنٽ هڪ چونڊي ٻيهر ڪوشش ڪري.

ٻه قسم جون غلطيون، ڄاڻي واڻي

غلط صورت جي درخواست يا اڻڄاتل اوزار JSON-RPC غلطي آهي. “هي پروجيڪٽ اجازت ڏنل ناهي” يا “اهڙو سيشن ناهي” عام نتيجي طور هن سان واپس اچي ٿو isError: true — ڇاڪاڻ ته ماڊل ٻئي قسم مان هي پڇي سنڀالي سگهي ٿو mp_projects ۽ وري ڪوشش ڪري، پر پهرئين مان نه.

نتيجا ٻئي هي کڻن ٿا structuredContent ۽ ساڳي ڊيٽا متن بلاڪ ۾ سيريئلائيز ٿيل، ته پراڻا ڪلائنٽ به ڪارائتو ڪجهه ڏسن.