Seerfarka MCP

1. Waxa wakiilku tan ku samayn karo

Macmiil Model Context Protocol ah u jeedi endpoint-ka, wuxuuna weydiin karaa su'aalo sida “boggee soo saara gujinnada caro leh ee ugu badan bishan” ama “i tus saddex fadhi oo Germany ka yimid oo ka dheer laba daqiiqo” — dabadeedna wuxuu ku siin karaa xiriir fadhiga dib u ciyaara.

Qalab	Waxa uu ka jawaabo
mp_projects	mashaariicda furahani akhrin karo
mp_overview	fadhiyada, dadka, daawashooyinka bogga, muddada, calaamadaha niyad-jabka
mp_sessions	fadhiyadii dhowaa oo wata xiriirro dib-u-ciyaaris, lagu shaandheeyay dal, qalab ama dherer
mp_session	hal fadhi: bogagga siday u kala horreeyaan, dhacdooyinka, isha, qalabka
mp_pages	bogagga iyadoo daawashooyin lagu kala saaray, oo leh booqdayaal gaar ah
mp_frustration	gujinno caro leh, gujinno aan jawaab lahayn iyo khaladaad JavaScript oo bog ahaan loo qaybiyay
mp_goals	yoolalkaaga iyo inta jeer ee mid kasta la gaaray

2. Isku-xiridda

Endpoint-ku wuxuu POST ka qaataa /mcp wuxuuna adeegsadaa Streamable HTTP, nooca protocol-ka 2026-07-28.

Xaqiijinta aqoonsigu waa fure API akhris oo MousePlayer ah oo caadi ah — isla nooca aad ka abuurto Dejimaha, Furayaasha API iyo isla nooca REST API qaato. Aqoonsi labaad ma jiro. Kala-noqoshada furuhu waxay isla waqtigaas kala noqotaa gelitaanka wakiilka.

Dabadeed shid mashruuca

Fure API wuxuu furaa goobtaada shaqada oo dhan. Tani si ula kac ah sidaas ma aha: mashruuc kasta wuxuu leeyahay beddel u gaar ah oo bogga isku-xirrada ah, caadi ahaanna waa dansan yahay. Mashruuc aan la shidin kama muuqdo mp_projects lamana akhrin karo xitaa haddii wakiilku qiyaaso ID-giisa.

Taasi ma aha maamul badan. Fure API oo iskribti daahfur ah ku jira wuxuu ku nool yahay hal meel oo aad maamusho; fure API oo faylka dejinta wakiilka ku jira wuxuu quudiyaa context moodel, taasina waa hayn aad uga dabacsan. Oggolaanshaha hal mashruuc mar kasta waa xakamaynta ku habboon.

3. Akhris keliya iyo sababta aysan taasi isu beddelayn

Toddobada qalab midna wax ma qoro. Ma jiro tirtirid, dhoofin ama beddel dejin oo endpoint-kan ka dambeeya — ma aha inaan waqti ka dhammaannay, laakiin qalab wakiil wici karo waa qalab uu si khalad ah u wici karo.

Waxa uusan soo celin

Duubisyada laftooda ma jiraan, sawirro DOM ma jiraan, cinwaanno IP ma jiraan. Wakiilku wuxuu helaa waxa qofku muuqaalka ku arko iyo xiriirka uu inta kale ku daawado.

Xadadka codsiyada iyo baaxadda

Lixdan codsi daqiiqaddii fure kasta, sida REST API. Muddo waqti waxay ku xaddidan tahay 365 maalmood, liiska natiijooyinkuna 200 saf; jawaab la soo gaabiyay sidaas ayay sheegtaa, sababtoo ah liis si aamusan loo soo gaabiyay si sax ah ayuu ugu egyahay mid dhammaystiran.

4. Dadka dhisa macmiilka

Saddex hab: server/discover, tools/list, tools/call. Fadhiyo ma jiraan, GET stream ma jiro, Last-Event-ID na ma jiro — kuwaas waxay ka tirsan yihiin noocyada protocol-ka ilaa 2025-11-25, mana aha qayb ka mid ah kan. GET ama DELETE wuxuu helaa 405.

POST kasta wuxuu wataa MCP-Protocol-Version, Mcp-Method iyo, marka ay tahay tools/call, Mcp-Name, mid kastana waa inuu jirka waafaqaa. Iswaafaq la'aantu waa 400 oo leh khalad JSON-RPC -32020; nooc aan la taageerin waa 400 oo leh -32022 iyo liiska noocyada aan taageerno, si macmiilkaagu u doorto mid oo mar kale isku dayo.

Laba nooc oo khalad ah, si ula kac ah

Codsi qaab khaldan ama qalab aan la aqoon waa khalad JSON-RPC. “Mashruucan lama oggola” ama “fadhi noocaas ah ma jiro” wuxuu ku soo noqdaa natiijo caadi ah oo leh isError: true — sababtoo ah moodelku nooca labaad wuu ka soo kaban karaa isagoo weydiiya mp_projects oo mar kale isku daya, kan koowaadna kama soo kaban karo.

Natiijooyinku waxay wataan structuredContent iyo isla xogta oo text block loo serialise-gareeyay, si macaamiishii hore weli u arkaan wax waxtar leh.