MCP server

1. Šta agent može uraditi s ovim

Usmjerite klijent za Model Context Protocol na endpoint i moći će postavljati pitanja poput "koja stranica ovog mjeseca izaziva najviše klikova iz bijesa" ili "pokaži mi tri sesije iz Njemačke duže od dvije minute" — a zatim vam dati link koji reproducira sesiju.

Alat	Odgovara na pitanja o tome
mp_projects	koje projekte ovaj ključ smije čitati
mp_overview	sesijama, osobama, pregledima stranica, trajanju, signalima frustracije
mp_sessions	nedavnim sesijama s linkovima za reprodukciju, filtriranim po državi, uređaju ili trajanju
mp_session	jednoj sesiji: stranice redom, događaji, izvor, uređaj
mp_pages	stranicama prema broju pregleda, s jedinstvenim posjetiocima
mp_frustration	klikovima iz bijesa, klikovima bez reakcije i JavaScript greškama grupisanim po stranici
mp_goals	vašim ciljevima i učestalosti ostvarivanja svakog od njih

2. Povezivanje

Endpoint prihvata POST na /mcp i koristi Streamable HTTP, verziju protokola 2026-07-28.

Za autentifikaciju služi obični MousePlayer API ključ za čitanje — iste vrste koju kreirate u Postavkama, API ključevi, i koju prihvata REST API. Nema drugih pristupnih podataka. Opoziv ključa istog trenutka ukida pristup agentu.

Zatim uključite projekt

API ključ otvara cijeli vaš radni prostor. Ovaj namjerno ne radi tako: svaki projekt ima vlastiti prekidač na stranici integracija, a podrazumijevano je isključen. Projekt koji nije uključen ne pojavljuje se u mp_projects i ne može se čitati čak ni ako agent pogodi njegov ID.

To nije birokratija. API ključ u skripti za implementaciju nalazi se na jednom mjestu koje vi kontrolišete; API ključ u konfiguracijskoj datoteci agenta ulazi u kontekst modela, a to je znatno slabiji oblik čuvanja. Odobravanje jednog po jednog projekta odgovarajuća je kontrola.

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

Nijedan od sedam alata ništa ne zapisuje. Iza ovog endpointa nema brisanja, izvoza ni promjene konfiguracije — ne zato što nam je ponestalo vremena nego zato što alat koji agent može pozvati može pozvati i greškom.

Šta ne vraća

Same snimke, DOM snimke stranica ni IP adrese. Agent dobija ono što osoba vidi u interfejsu i link za gledanje ostatka.

Ograničenja učestalosti i raspona

Šezdeset zahtjeva u minuti po ključu, kao kod REST API-ja. Vremenski raspon ograničen je na 365 dana, a lista rezultata na 200 redova; skraćen odgovor to navodi jer prešutno skraćena lista izgleda potpuno isto kao potpuna.

4. Za one koji razvijaju klijent

Tri metode: server/discover, tools/list, tools/call. Bez sesija, bez GET toka, bez Last-Event-ID — to pripada verzijama protokola do 2025-11-25 i nije dio ove verzije. GET ili DELETE dobija 405.

Svaki POST nosi MCP-Protocol-Version, Mcp-Method i, za tools/call, Mcp-Name, a svaki mora odgovarati tijelu zahtjeva. Nepodudaranje daje 400 s JSON-RPC greškom -32020; nepodržana verzija daje 400 s -32022 i listom verzija koje podržavamo kako bi vaš klijent mogao odabrati jednu i pokušati ponovo.

Namjerno dvije vrste grešaka

Neispravno oblikovan zahtjev ili nepoznat alat predstavlja JSON-RPC grešku. "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 tako što zatraži mp_projects i pokuša ponovo, a od prve ne može.

Rezultati nose i structuredContent i iste podatke serijalizovane u tekstualni blok, tako da i stariji klijenti vide nešto korisno.