Server MCP

1. Čo s tým môže agent robiť

Nasmerujte klienta Model Context Protocol na koncový bod a môže klásť otázky ako „ktorá stránka tento mesiac vytvára najviac zúrivých kliknutí“ alebo „ukážte tri relácie z Nemecka dlhšie než dve minúty“ – a potom vám odovzdať odkaz na prehratie relácie.

Nástroj	Odpovedá na
mp_projects	ktoré projekty môže tento kľúč čítať
mp_overview	relácie, ľudia, zobrazenia stránok, trvanie, signály frustrácie
mp_sessions	nedávne relácie s odkazmi na prehrávanie, filtrované podľa krajiny, zariadenia alebo dĺžky
mp_session	jedna relácia: stránky v poradí, udalosti, zdroj, zariadenie
mp_pages	stránky podľa zobrazení s jedinečnými návštevníkmi
mp_frustration	zúrivé kliknutia, kliknutia bez odozvy a chyby JavaScriptu zoskupené podľa stránky
mp_goals	vaše ciele a počet dosiahnutí každého z nich

2. Pripojenie

Koncový bod prijíma POST na /mcp a používa Streamable HTTP, verziu protokolu 2026-07-28.

Overovanie používa bežný API kľúč MousePlayer na čítanie – rovnaký typ, aký vytvárate v časti Nastavenia, API kľúče a aký prijíma REST API. Neexistuje druhý prístupový údaj. Odvolanie kľúča v rovnakom okamihu odvolá aj prístup agenta.

Potom zapnite projekt

API kľúč otvára celý pracovný priestor. Tento prístup zámerne nie: každý projekt má vlastný prepínač na stránke integrácií a predvolene je vypnutý. Nezapnutý projekt sa neobjaví v mp_projects a nemožno ho čítať, ani keď agent uhádne jeho ID.

Nie je to byrokracia. API kľúč v nasadzovacom skripte je na jednom mieste, ktoré ovládate; API kľúč v konfiguračnom súbore agenta vstupuje do kontextu modelu a to je oveľa voľnejší spôsob správy. Sprístupňovanie projektov po jednom je zodpovedajúcou kontrolou.

3. Iba na čítanie a prečo sa to nezmení

Žiadny zo siedmich nástrojov nič nezapisuje. Za týmto koncovým bodom nie je vymazanie, export ani zmena konfigurácie – nie preto, že by nám došiel čas, ale preto, že nástroj, ktorý môže agent zavolať, môže zavolať aj omylom.

Čo nevracia

Žiadne samotné záznamy, snímky DOM ani IP adresy. Agent dostáva to, čo človek vidí v rozhraní, a odkaz na pozretie zvyšku.

Limity počtu a rozsahu

Šesťdesiat požiadaviek za minútu na kľúč, rovnako ako REST API. Časový rozsah je obmedzený na 365 dní a zoznam výsledkov na 200 riadkov; skrátená odpoveď to oznámi, pretože potichu skrátený zoznam vyzerá presne ako úplný.

4. Pre tvorcov klienta

Tri metódy: server/discover, tools/list, tools/call. Žiadne relácie, žiadny prúd GET, žiadne Last-Event-ID – tie patria verziám protokolu do 2025-11-25 a nie sú súčasťou tejto verzie. GET alebo DELETE dostane 405.

Každý POST obsahuje MCP-Protocol-Version, Mcp-Method a pri tools/call aj Mcp-Name; každá hodnota sa musí zhodovať s telom. Nezhoda je 400 s chybou JSON-RPC -32020; nepodporovaná verzia je 400 s -32022 a zoznamom podporovaných verzií, aby klient mohol vybrať inú a zopakovať pokus.

Zámerne dva druhy chýb

Nesprávne formátovaná požiadavka alebo neznámy nástroj je chyba JSON-RPC. „Tento projekt nie je sprístupnený“ alebo „taká relácia neexistuje“ sa vráti ako bežný výsledok s isError: true – pretože z druhého druhu sa model vie zotaviť zavolaním mp_projects a novým pokusom, z prvého nie.

Výsledky obsahujú structuredContent aj rovnaké údaje serializované do textového bloku, takže aj starší klienti vidia niečo užitočné.