MCP server

1. Šta agent može sa ovim

Usmerite Model Context Protocol klijent na endpoint i može da postavlja pitanja poput „koja stranica proizvodi najviše klikova iz frustracije ovog meseca“ ili „pokaži tri sesije iz Nemačke duže od dva minuta“ — i zatim vam da link koji reprodukuje sesiju.

Alat	Odgovara
mp_projects	koje projekte ovaj ključ sme da čita
mp_overview	sesije, osobe, prikazi stranica, trajanje, signali frustracije
mp_sessions	nedavne sesije sa linkovima snimaka, filtrirane po zemlji, uređaju ili dužini
mp_session	jedna sesija: stranice po redu, događaji, izvor, uređaj
mp_pages	stranice po prikazima, sa jedinstvenim posetiocima
mp_frustration	klikovi iz frustracije, klikovi bez reakcije i JavaScript greške grupisani po stranici
mp_goals	vaši ciljevi i koliko puta je svaki dostignut

2. Povezivanje

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

Autentifikacija je običan MousePlayer API ključ za čitanje — isti koji pravite pod Podešavanja, API ključevi i isti koji prima REST API. Nema drugih pristupnih podataka. Opoziv ključa istovremeno opoziva pristup agentu.

Zatim uključite projekat

API ključ otvara ceo radni prostor. Ovaj pristup namerno ne: svaki projekat ima sopstveni prekidač na stranici integracija i podrazumevano je isključen. Projekat koji nije uključen ne pojavljuje se u mp_projects i ne može da se čita čak i ako agent pogodi ID.

To nije birokratija. API ključ u skripti postavljanja nalazi se na jednom mestu koje kontrolišete; API ključ u konfiguracionoj datoteci agenta ulazi u kontekst modela, što je znatno slabija kontrola čuvanja. Odobravanje jednog projekta odjednom je odgovarajuća kontrola.

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

Nijedan od sedam alata ništa ne upisuje. Iza ovog endpoint-a nema brisanja, izvoza ili promene konfiguracije — ne zato što nismo stigli, već zato što alat koji agent može da pozove može da pozove i greškom.

Šta ne vraća

Nema samih snimaka, DOM snimaka ni IP adresa. Agent dobija ono što osoba vidi u interfejsu i link za gledanje ostatka.

Ograničenja učestalosti i opsega

Šezdeset zahteva u minuti po ključu, kao REST API. Period je ograničen na 365 dana, lista rezultata na 200 redova; skraćen odgovor to navodi jer neprimetno skraćena lista izgleda potpuno isto kao potpuna.

4. Za one koji prave klijent

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

Svaki POST sadrži MCP-Protocol-Version, Mcp-Method i za tools/call, Mcp-Name, a svako mora da odgovara telu. Neslaganje je 400 sa JSON-RPC greškom -32020; nepodržana verzija je 400 sa -32022 i listom podržanih verzija, pa klijent može da izabere jednu i pokuša ponovo.

Dve vrste greške, namerno

Neispravan zahtev ili nepoznat alat je JSON-RPC greška. „Ovaj projekat nije odobren“ ili „nema takve sesije“ vraća se kao običan rezultat sa isError: true — jer model može da se oporavi od druge vrste tako što zatraži mp_projects i pokuša ponovo, a od prve ne može.

Rezultati sadrže i structuredContent i iste podatke serijalizovane u tekstualni blok, pa i stariji klijenti vide nešto korisno.