MCP poslužitelj

1. Što agent time može raditi

Usmjerite Model Context Protocol klijent na krajnju točku i može postavljati pitanja poput „koja stranica ovog mjeseca uzrokuje najviše bijesnih klikova“ ili „prikažite tri sesije iz Njemačke dulje od dvije minute“ – a zatim vam dati poveznicu za reprodukciju sesije.

Alat	Odgovara
mp_projects	koje projekte ovaj ključ smije čitati
mp_overview	sesije, osobe, prikazi stranica, trajanje, signali frustracije
mp_sessions	nedavne sesije s poveznicama za reprodukciju, filtrirane prema državi, uređaju ili duljini
mp_session	jedna sesija: stranice redom, događaji, izvor, uređaj
mp_pages	stranice prema prikazima, s jedinstvenim posjetiteljima
mp_frustration	bijesni klikovi, klikovi bez reakcije i JavaScript pogreške grupirani po stranici
mp_goals	vaši ciljevi i učestalost njihova ostvarivanja

2. Povezivanje

Krajnja točka prihvaća POST na /mcp i koristi Streamable HTTP, verziju protokola 2026-07-28.

Za autentifikaciju služi običan MousePlayer API ključ za čitanje – isti koji izrađujete pod Postavke, API ključevi i koji prihvaća REST API. Nema druge vjerodajnice. Opoziv ključa istodobno opoziva pristup agenta.

Zatim uključite projekt

API ključ otvara cijeli radni prostor. Ova krajnja točka namjerno ne: svaki projekt ima vlastiti prekidač na stranici integracija, zadano isključen. Projekt koji nije uključen ne pojavljuje se u mp_projects i ne može se čitati čak ni ako agent pogodi ID.

To nije birokracija. API ključ u skripti za postavljanje nalazi se na jednom mjestu pod vašom kontrolom; ključ u konfiguracijskoj datoteci agenta ulazi u kontekst modela, što je mnogo slabije kontrolirano okruženje. Odobravanje pojedinih projekata odgovarajuća je kontrola.

3. Samo čitanje i zašto se to neće promijeniti

Nijedan od sedam alata ništa ne zapisuje. Iza ove krajnje točke nema brisanja, izvoza ni promjene konfiguracije – ne zbog manjka vremena, nego zato što alat koji agent može pozvati može pozvati i pogreškom.

Što ne vraća

Bez samih snimki, snimki stanja DOM-a i IP adresa. Agent dobiva ono što osoba vidi u sučelju i poveznicu za gledanje ostaloga.

Ograničenja zahtjeva i raspona

Šezdeset zahtjeva u minuti po ključu, jednako kao REST API. Vremenski raspon ograničen je na 365 dana, a popis rezultata na 200 redaka; skraćen odgovor to navodi jer neprimjetno skraćen popis izgleda kao potpun.

4. Za one koji izrađuju klijent

Tri metode: server/discover, tools/list, tools/call. Bez sesija, GET toka ili Last-Event-ID – pripadaju verzijama protokola do 2025-11-25 i nisu dio ove. GET ili DELETE dobiva 405.

Svaki POST sadrži MCP-Protocol-Version, Mcp-Method i, za tools/call, Mcp-Name, a svaki se mora podudarati s tijelom. Nepodudaranje vraća 400 uz JSON-RPC pogrešku -32020; nepodržana verzija vraća 400 uz -32022 i popis podržanih verzija kako bi klijent odabrao jednu i pokušao ponovno.

Dvije vrste pogrešaka, namjerno

Neispravno oblikovan zahtjev ili nepoznat alat JSON-RPC je pogreška. „Ovaj projekt nije odobren“ ili „nema takve sesije“ vraća se kao običan rezultat s isError: true – jer se model od druge vrste može oporaviti upitom mp_projects i ponovnim pokušajem, a od prve ne može.

Rezultati sadrže structuredContent i iste podatke serijalizirane u tekstualni blok kako bi i stariji klijenti vidjeli nešto korisno.