MCP serveris

1. Ką agentas su tuo gali daryti

Nukreipkite Model Context Protocol klientą į galinį adresą, ir jis galės klausti „kuris puslapis šį mėnesį sukelia daugiausia įnirtingų paspaudimų“ arba „parodykite tris ilgesnius nei dviejų minučių seansus iš Vokietijos“ ir pateikti seansą atkuriančią nuorodą.

Įrankis	Atsako
mp_projects	kuriuos projektus šis raktas gali skaityti
mp_overview	seansai, žmonės, puslapių peržiūros, trukmė, nusivylimo signalai
mp_sessions	naujausi seansai su atkūrimo nuorodomis, filtruojami pagal šalį, įrenginį ar trukmę
mp_session	vienas seansas: puslapiai iš eilės, įvykiai, šaltinis, įrenginys
mp_pages	puslapiai pagal peržiūras, su unikaliais lankytojais
mp_frustration	įnirtingi paspaudimai, paspaudimai be atsako ir JavaScript klaidos pagal puslapį
mp_goals	jūsų tikslai ir kiek kartų kiekvienas pasiektas

2. Prijungimas

Galinis adresas priima POST adresu /mcp ir naudoja Streamable HTTP, protokolo versija 2026-07-28.

Autentifikavimui naudojamas įprastas MousePlayer skaitymo API raktas, toks pat, kokį kuriate nustatymų API raktų skiltyje ir kokį priima REST API. Antro prisijungimo duomens nėra. Atšaukus raktą tą pačią akimirką atšaukiama agento prieiga.

Tada įjunkite projektą

API raktas atveria visą darbo sritį. Šis kelias sąmoningai ne: kiekvienas projektas integracijų puslapyje turi atskirą jungiklį, išjungtą pagal numatytuosius nustatymus. Neįjungtas projektas nerodomas mp_projects ir jo negalima skaityti net agentui atspėjus ID.

Tai ne biurokratija. Diegimo scenarijaus API raktas yra vienoje jūsų valdomoje vietoje; agento konfigūracijos failo raktas patenka į modelio kontekstą, kur jį valdyti gerokai sunkiau. Atskirų projektų leidimas yra atitinkama kontrolė.

3. Tik skaitymui ir kodėl tai nesikeis

Nė vienas iš septynių įrankių nieko nerašo. Šis galinis adresas nesiūlo ištrynimo, eksporto ar konfigūracijos pakeitimo: ne dėl laiko trūkumo, o todėl, kad agento iškviečiamas įrankis gali būti iškviestas ir per klaidą.

Ko negrąžina

Pačių įrašų, DOM būsenos kopijų ar IP adresų. Agentas gauna tai, ką žmogus mato sąsajoje, ir nuorodą likusiai daliai peržiūrėti.

Dažnio ir intervalų ribos

Šešiasdešimt užklausų vienam raktui per minutę, kaip REST API. Laikotarpis ribojamas iki 365 dienų, rezultatų sąrašas iki 200 eilučių; sutrumpintas atsakymas tai nurodo, nes tyliai sutrumpintas sąrašas atrodo lygiai kaip visas.

4. Kuriantiems klientą

Trys metodai: server/discover, tools/list, tools/call. Be seansų, be GET srauto, be Last-Event-ID – jie priklauso protokolo versijoms iki 2025-11-25 ir į šią neįtraukti. GET arba DELETE gauna 405.

Kiekvienas POST turi MCP-Protocol-Version, Mcp-Method ir metodui tools/call, Mcp-Name; kiekvienas turi atitikti turinį. Neatitiktis reiškia 400 su JSON-RPC klaida -32020; nepalaikoma versija reiškia 400 su -32022 ir palaikomų versijų sąrašu, kad klientas galėtų pasirinkti ir bandyti dar kartą.

Dviejų tipų klaidos sąmoningai

Netinkama užklausa arba nežinomas įrankis yra JSON-RPC klaida. „Šis projektas neleistinas“ ar „tokio seanso nėra“ grąžinama kaip įprastas rezultatas su isError: true – nes modelis iš antro tipo gali atsigauti užklausdamas mp_projects ir bandydamas dar kartą, o iš pirmo ne.

Rezultatai turi structuredContent ir tuos pačius duomenis, serializuotus teksto bloke, kad senesni klientai vis dar gautų naudingą informaciją.