Sabar MCP

1. Abin da wakili yake iya yi da wannan

A nuna wa abokin hulɗar Model Context Protocol wurin ƙarshen kuma zai iya tambayar “wane shafi ya samar da mafi yawan dannawa cikin fushi a wannan watan” ko “a nuna zamuka uku daga Jamus da suka fi mintuna biyu” - sannan ya bayar da hanyar sake kunna zaman.

Kayan aiki	Amsoshi
mp_projects	ayyukan da wannan mabuɗi yake iya karantawa
mp_overview	zamuka, mutane, kallon shafuka, tsawon lokaci, alamomin takaici
mp_sessions	zamukan baya-bayan nan da hanyoyin sake kunnawa, an tace ta ƙasa, na’ura ko tsawo
mp_session	zama guda: shafuka a jeri, abubuwan da suka faru, tushe, na’ura
mp_pages	shafuka ta yawan kallo, tare da baƙi na musamman
mp_frustration	dannawa cikin fushi, dannawa marasa amsa da kurakuran JavaScript a rukuni ta shafi
mp_goals	manufofi da yawan lokacin da aka cimma kowacce

2. Haɗawa

Wurin ƙarshen yana karɓar POST a /mcp kuma yana amfani da Streamable HTTP, sigar protocol 2026-07-28.

Tabbatar da shiga mabuɗin API na karantawa na MousePlayer na yau da kullum ne - irin wanda ake ƙirƙira ƙarƙashin Saituna, Mabuɗan API, kuma irin wanda REST API yake ɗauka. Babu shaidar shiga ta biyu. Soke mabuɗi yana soke damar wakili a lokaci ɗaya.

Sannan a kunna aikin

Mabuɗin API yana buɗe duk wurin aiki. Wannan da gangan ba ya yi haka: kowane aiki yana da maɓallinsa a shafin haɗe-haɗe, kuma yana kashe a tsohon saitin. Aikin da ba a kunna ba ba ya bayyana a mp_projects kuma ba a iya karanta shi ko da wakili ya hasashe ID nasa.

Wannan ba jan aiki ba ne. Mabuɗin API a rubutun girkawa yana wuri guda da ake sarrafawa; mabuɗin API a fayil ɗin saitin wakili yana ciyar da mahallin model, kuma wannan riƙewa ce mafi sakaci. Sakin aiki ɗaya a lokaci ɗaya shi ne sarrafawar da ta dace.

3. Karantawa kaɗai, da dalilin da hakan ba zai canza ba

Babu ɗayan kayan aiki bakwai da yake rubuta komai. Babu gogewa, babu fitarwa, babu sauya saiti a bayan wannan wurin ƙarshen - ba domin lokaci ya ƙare mana ba, amma domin kayan aikin da wakili yake iya kira zai iya kira bisa kuskure.

Abin da ba ya mayarwa

Babu rikodi kansu, babu hotunan DOM, babu adiresoshin IP. Wakili yana samun abin da mutum yake gani a fuskar amfani, tare da hanyar kallon sauran.

Iyakokin yawan buƙata da zango

Buƙatu sittin a minti ga kowane mabuɗi, daidai da REST API. Zangon lokaci yana da iyakar kwanaki 365 kuma jerin sakamako yana da iyakar layuka 200; amsar da aka yanke tana bayyana hakan, domin jerin da aka yanke a shiru yana kama da cikakke daidai.

4. Don masu gina abokin hulɗa

Hanyoyi uku: server/discover, tools/list, tools/call. Babu zamuka, babu GET stream, babu Last-Event-ID - waɗannan na sigogin protocol har zuwa 2025-11-25 ne kuma ba sa cikin wannan. GET ko DELETE yana samun 405.

Kowane POST yana ɗauke da MCP-Protocol-Version, Mcp-Method kuma, don tools/call, Mcp-Name, kuma dole kowanne ya dace da jiki. Rashin dacewa shi ne 400 da kuskuren JSON-RPC -32020; sigar da ba a goyon baya ita ce 400 tare da -32022 da jerin sigogin da muke goyon baya, don abokin hulɗa ya zaɓi ɗaya ya sake gwadawa.

Nau’ikan kuskure biyu, da gangan

Buƙata mai tsarin da bai dace ba ko kayan aikin da ba a sani ba kuskuren JSON-RPC ne. “Ba a saki wannan aikin ba” ko “babu irin wannan zama” yana dawowa a matsayin sakamako na yau da kullum da isError: true - domin model yana iya murmurewa daga nau’i na biyu ta tambayar mp_projects da sake gwadawa, amma ba ya iya murmurewa daga na farko.

Sakamako yana ɗauke da structuredContent da kuma bayanan ɗaya da aka yi wa serialisation a block na rubutu, don tsofaffin abokan hulɗa su ci gaba da ganin abu mai amfani.