Iseva ye-MCP

1. I-ejenti ingenzani ngalokhu

Khomba iklayenti le-Model Context Protocol esiphethweni bese libuza imibuzo enjengokuthi “yiliphi ikhasi elikhiqiza ukuchofoza ngentukuthelo okuningi kakhulu kule nyanga” noma “ngibonise amaseshini amathathu aseJalimane amade kunemizuzu emibili” — bese likunika isixhumanisi esidlala iseshini kabusha.

Ithuluzi	Liphendula
mp_projects	ukuthi yiziphi iziphrojekthi lo khiye ongazifunda
mp_overview	amaseshini, abantu, ukubukwa kwamakhasi, isikhathi, izimpawu zokukhungatheka
mp_sessions	amaseshini akamuva anezixhumanisi zokudlala kabusha, ahlungwe ngezwe, idivayisi noma ubude
mp_session	iseshini eyodwa: amakhasi ngokulandelana, izehlakalo, umthombo, idivayisi
mp_pages	amakhasi ngokubukwa, anezivakashi ezihlukile
mp_frustration	ukuchofoza ngentukuthelo, ukuchofoza okungaphendulwa namaphutha e-JavaScript kuhlanganiswe ngekhasi
mp_goals	imigomo yakho nokuthi ngamunye ufinyelelwe kangaki

2. Ukuxhuma

Isiphetho samukela i-POST ku- /mcp futhi sisebenzisa i-Streamable HTTP, inguqulo yephrothokholi 2026-07-28.

Ukuqinisekisa kusebenzisa ukhiye ojwayelekile we-API wokufunda we-MousePlayer — uhlobo olufanayo oludala ngaphansi kokuthi Izilungiselelo, Okhiye Be-API, nolwamukelwa yi-REST API. Asikho isiqinisekiso sokungena sesibili. Ukuhoxisa ukhiye kuhoxisa ukufinyelela kwe-ejenti ngaleso sikhathi.

Bese uvula iphrojekthi

Ukhiye we-API uvula yonke indawo yakho yokusebenzela. Lokhu kukhetha ukungakwenzi lokho: iphrojekthi ngayinye ineswishi yayo ekhasini lokuhlanganisa, futhi ivaliwe ngokuzenzakalela. Iphrojekthi engavuliwe ayiveli ku- mp_projects futhi ayikwazi ukufundwa ngisho noma i-ejenti iqagela i-ID yayo.

Lokho akuwona umsebenzi wephepha ongenasidingo. Ukhiye we-API embhalweni wohlelo wokufaka uhlala endaweni eyodwa oyilawulayo; ukhiye we-API efayeleni lokusetha le-ejenti ungena emongweni wemodeli, okuwukugcinwa okuxegayo kakhulu. Ukukhulula iphrojekthi eyodwa ngesikhathi yindlela yokulawula efanele lokho.

3. Ukufunda kuphela nokuthi kungani lokho kungeke kushintshe

Akukho kulawo mathuluzi ayisikhombisa okubhala lutho. Akukho ukususa, ukuthekelisa noma ukushintsha ukusetha ngemuva kwalesi siphetho — hhayi ngoba siphelelwe isikhathi, kodwa ngoba ithuluzi i-ejenti engalibiza yilona engalibiza nangephutha.

Okungabuyiswa

Akubuyiswa okurekhodiwe uqobo, izithombe ze-DOM noma amakheli e-IP. I-ejenti ithola lokho umuntu akubonayo kusixhumi esibonakalayo, kanye nesixhumanisi sokubuka okunye.

Imikhawulo yezinga nebanga

Izicelo ezingamashumi ayisithupha ngomzuzu ngokhiye, njenge-REST API. Ibanga lesikhathi likhawulelwe ezinsukwini ezingu-365, uhlu lwemiphumela emigqeni engu-200; impendulo enqanyuliwe iyakusho lokho, ngoba uhlu olunqanyulwe buthule lubukeka lufana ncamashi noluphelele.

4. Okwabantu abakha iklayenti

Izindlela ezintathu: server/discover, tools/list, tools/call. Awekho amaseshini, akukho ukusakazwa kwe-GET, akukho Last-Event-ID — lokho kungokwezinguqulo zephrothokholi kuze kube ngu-2025-11-25 futhi akuyona ingxenye yalena. I-GET noma i-DELETE ithola u-405.

Yonke i-POST iqukethe MCP-Protocol-Version, Mcp-Method futhi, ku- tools/call, Mcp-Name, futhi ngakunye kufanele kufane nomzimba. Ukungafani kuba 400 nephutha le-JSON-RPC elithi -32020; inguqulo engasekelwa iba 400 kanye no- -32022 nohlu lwezinguqulo esizisekelayo, ukuze iklayenti lakho likhethe eyodwa liphinde lizame.

Izinhlobo ezimbili zamaphutha, ngamabomu

Isicelo esakheke kabi noma ithuluzi elingaziwa kuyiphutha le-JSON-RPC. “Le phrojekthi ayikhululiwe” noma “ayikho leyo seshini” kubuya njengomphumela ojwayelekile oqukethe isError: true — ngoba imodeli ingalulama ohlotsheni lwesibili ngokucela mp_projects bese izama futhi, kodwa ayikwazi ukululama kolokuqala.

Imiphumela iqukethe kokubili structuredContent nedatha efanayo ehlelwe yaba ibhulokhi yombhalo, ukuze amaklayenti amadala asabona okuthile okuwusizo.