Strežnik MCP

1. Kaj agent lahko naredi

Odjemalca Model Context Protocol usmerite na končno točko in lahko vpraša „katera stran ta mesec povzroča največ besnih klikov“ ali „pokaži tri seje iz Nemčije, daljše od dveh minut“ ter vam ponudi povezavo za predvajanje seje.

Orodje	Odgovori
mp_projects	katere projekte lahko ta ključ bere
mp_overview	seje, osebe, ogledi strani, trajanje, signali frustracije
mp_sessions	nedavne seje s povezavami do posnetkov, filtrirane po državi, napravi ali trajanju
mp_session	ena seja: strani po vrsti, dogodki, vir, naprava
mp_pages	strani po ogledih z enoličnimi obiskovalci
mp_frustration	besni kliki, kliki brez odziva in napake JavaScript, združeni po strani
mp_goals	vaši cilji in pogostost njihovega doseganja

2. Povezovanje

Končna točka sprejema POST na /mcp in uporablja Streamable HTTP, različico protokola 2026-07-28.

Preverjanje pristnosti uporablja običajen ključ MousePlayer za branje – takega, ki ga ustvarite pod Nastavitve, API ključi in ga sprejema tudi REST API. Druge poverilnice ni. Preklic ključa v istem trenutku prekliče agentov dostop.

Nato vklopite projekt

API ključ odpre celoten delovni prostor. Ta dostop namenoma ne: vsak projekt ima na strani integracij lastno stikalo, privzeto izklopljeno. Nevklopljen projekt se ne pojavi v mp_projects in ga ni mogoče brati, tudi če agent ugane njegov ID.

To ni birokracija. API ključ v skriptu za uvedbo je na enem mestu pod vašim nadzorom; ključ v agentovi konfiguracijski datoteki vstopa v kontekst modela, kjer je nadzor precej ohlapnejši. Dovolitev projekta za projektom je ustrezno varovalo.

3. Samo branje in zakaj bo tako ostalo

Nobeno od sedmih orodij ničesar ne zapisuje. Za to končno točko ni brisanja, izvoza ali spreminjanja nastavitev – ne zaradi pomanjkanja časa, ampak ker je orodje, ki ga agent lahko pokliče, tudi orodje, ki ga lahko pokliče po pomoti.

Česa ne vrne

Ne samih posnetkov, posnetkov stanja DOM ali naslovov IP. Agent dobi, kar človek vidi v vmesniku, ter povezavo za ogled preostalega.

Omejitve pogostosti in obsega

Šestdeset zahtev na minuto na ključ, enako kot REST API. Časovni razpon je omejen na 365 dni in seznam rezultatov na 200 vrstic; skrajšan odgovor to pove, saj je tiho skrajšan seznam videti kot popoln.

4. Za razvijalce odjemalca

Tri metode: server/discover, tools/list, tools/call. Brez sej, toka GET ali Last-Event-ID – to sodi v različice protokola do 2025-11-25 in ni del te različice. GET ali DELETE prejme 405.

Vsak POST vsebuje MCP-Protocol-Version, Mcp-Method in za tools/call, Mcp-Name, vsaka vrednost pa se mora ujemati s telesom. Neujemanje je 400 z napako JSON-RPC -32020; nepodprta različica je 400 z -32022 in seznamom podprtih različic, da lahko odjemalec izbere eno in poskusi znova.

Namenoma dve vrsti napak

Napačno oblikovana zahteva ali neznano orodje je napaka JSON-RPC. „Ta projekt ni dovoljen“ ali „ni take seje“ se vrne kot običajen rezultat z isError: true – model se lahko pri drugi vrsti odzove s poizvedbo mp_projects in poskusi znova, pri prvi pa ne.

Rezultati vsebujejo structuredContent in iste podatke, serializirane v besedilni blok, da tudi starejši odjemalci vidijo nekaj uporabnega.