የ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 ቁልፍ፣ እርስዎ በሚቆጣጠሩት አንድ ቦታ ይቆያል። በወኪል ውቅር ፋይል ውስጥ ያለ የ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 እና ተመሳሳይ ውሂብ ወደ ጽሑፍ ክፍል ተቀይሮ ይይዛሉ፣ ስለዚህ የቆዩ ደንበኞችም ጠቃሚ ነገር ያያሉ።