MCP server
Laske tehisaru agendil lugeda teie analüütikat: seitse tööriista Model Context Protocoli kaudu, kõik ainult lugemiseks, autentimiseks teie juba olemasolev API võti.
1. Mida agent sellega teha saab
Ühendage Model Context Protocoli klient lõpp-punktiga ja see saab küsida näiteks „milline leht põhjustab sel kuul kõige rohkem raevuklõpse“ või „näita kolme Saksamaa seanssi, mis kestavad üle kahe minuti“ ning anda teile seejärel lingi seansi taasesitamiseks.
| Tööriist | Vastab |
|---|---|
mp_projects | milliseid projekte see võti lugeda tohib |
mp_overview | seansid, inimesed, lehevaatamised, kestus ja pettumuse signaalid |
mp_sessions | hiljutised seansid koos taasesituse linkidega, filtreeritud riigi, seadme või kestuse järgi |
mp_session | üks seanss: lehed järjekorras, sündmused, allikas ja seade |
mp_pages | lehed vaatamiste järgi koos unikaalsete külastajatega |
mp_frustration | raevuklõpsud, toimeta klõpsud ja JavaScripti vead lehtede kaupa |
mp_goals | teie eesmärgid ja iga eesmärgi saavutamise sagedus |
Iga agendi kirjeldatud seanss sisaldab linki, mille inimene saab avada. Nähtut kokku võttev agent on kasulik; agent, mis näitab ka kokkuvõtte aluseks olnud kahtkümmet sekundit, on kontrollitav.
2. Ühendamine
Lõpp-punkt võtab vastu POST-päringuid aadressil /mcp ja kasutab Streamable HTTP-d, protokolliversioon 2026-07-28.
Autentimiseks kasutatakse tavalist MousePlayeri lugemisõigusega API võtit – samasugust, nagu loote seadete jaotises „API võtmed“ ja mida kasutab REST API. Teist pääsuandmete komplekti pole. Võtme tühistamine tühistab samal hetkel agendi juurdepääsu.
Seejärel lülitage projekt sisse
API võti avab kogu teie tööruumi. See ühendus teadlikult ei ava: igal projektil on integratsioonide lehel oma lüliti, mis on vaikimisi välja lülitatud. Sisselülitamata projekt ei ilmu tööriista mp_projects ning seda ei saa lugeda isegi siis, kui agent arvab selle ID ära.
See pole bürokraatia. Paigaldusskripti API võti asub ühes teie kontrollitavas kohas; agendi seadistusfaili API võti jõuab mudeli konteksti, kus kontroll selle üle on palju hajusam. Ühe projekti kaupa lubamine annab sellele vastava kontrolli.
3. Ainult lugemiseks ja miks see nii jääb
Ükski seitsmest tööriistast ei kirjuta midagi. Lõpp-punkt ei võimalda kustutamist, eksporti ega seadistuse muutmist – mitte ajapuuduse tõttu, vaid seepärast, et iga tööriista, mida agent saab kutsuda, võib ta kutsuda ka kogemata.
Mida ei tagastata
Ei salvestisi endid, DOM-i hetktõmmiseid ega IP-aadresse. Agent saab selle, mida inimene liideses näeb, ning lingi ülejäänu vaatamiseks.
Sageduse ja ulatuse piirangud
Kuuskümmend päringut minutis võtme kohta, nagu REST API-s. Ajavahemiku ülempiir on 365 päeva ja tulemuste loendi ülempiir 200 rida; kärbitud vastus ütleb seda, sest vaikimisi kärbitud loend näib täpselt nagu täielik.
4. Kliendi arendajatele
Kolm meetodit: server/discover, tools/list, tools/call. Ei seansse, GET-voogu ega Last-Event-ID – need kuuluvad protokolliversioonidesse kuni 2025-11-25 ega ole selle versiooni osa. GET või DELETE saab vastuse 405.
Iga POST sisaldab päiseid MCP-Protocol-Version, Mcp-Method ning meetodi tools/call korral ka Mcp-Name, kusjuures igaüks peab vastama päringukehale. Mittevastavuse korral tagastatakse 400 JSON-RPC veaga -32020; toetamata versioon annab vastuse 400 koos -32022 ja toetatud versioonide loendiga, et klient saaks valida ühe neist ja uuesti proovida.
Kaks vealiiki, teadlikult
Vigane päring või tundmatu tööriist annab JSON-RPC vea. „See projekt pole lubatud“ või „sellist seanssi pole“ tagastatakse tavalise tulemusena koos väljaga isError: true – sest teist liiki veast saab mudel taastuda, küsides tööriistalt mp_projects ja proovides uuesti, esimesest aga mitte.
Tulemused sisaldavad nii structuredContent kui ka samu andmeid tekstiplokiks serialiseerituna, et vanemad kliendid näeksid endiselt midagi kasulikku.
Kõik siin nimetatud kaubamärgid kuuluvad nende omanikele. MousePlayeril puudub nende pakkujatega ärisuhe.