Server MCP

1. Co s tím může agent dělat

Nasměrujte klienta Model Context Protocol na endpoint a může klást otázky jako „která stránka tento měsíc vytváří nejvíc vzteklých kliknutí“ nebo „ukaž tři relace z Německa delší než dvě minuty“ a potom vám předat odkaz na přehrání relace.

Nástroj	Odpovídá na
mp_projects	které projekty smí tento klíč číst
mp_overview	relace, osoby, zobrazení stránek, dobu trvání a signály frustrace
mp_sessions	nedávné relace s odkazy na přehrávání, filtrované podle země, zařízení nebo délky
mp_session	jednu relaci: stránky v pořadí, události, zdroj a zařízení
mp_pages	stránky podle počtu zobrazení s unikátními návštěvníky
mp_frustration	vzteklá kliknutí, mrtvá kliknutí a chyby JavaScriptu seskupené podle stránky
mp_goals	vaše cíle a četnost jejich splnění

2. Připojení

Endpoint přijímá POST na /mcp a používá Streamable HTTP, verzi protokolu 2026-07-28.

Ověření používá běžný klíč MousePlayer API pro čtení - stejný typ, který vytvoříte v Nastavení, Klíče API a který přijímá REST API. Žádný druhý přístupový údaj není potřeba. Odvolání klíče ve stejném okamžiku zruší přístup agenta.

Potom zapněte projekt

Klíč API otevírá celý pracovní prostor. Tento přístup záměrně ne: každý projekt má na stránce integrací vlastní přepínač, standardně vypnutý. Nezapnutý projekt se neobjeví v mp_projects a nelze ho číst, ani když agent uhodne jeho ID.

Nejde o byrokracii. Klíč API v nasazovacím skriptu je na jednom místě pod vaší kontrolou; klíč v konfiguraci agenta vstupuje do kontextu modelu, což je mnohem volnější způsob uchovávání. Uvolňování jednotlivých projektů je odpovídající kontrola.

3. Pouze čtení a proč to tak zůstane

Žádný ze sedmi nástrojů nic nezapisuje. Endpoint neumožňuje mazání, export ani změnu konfigurace - ne proto, že by nám došel čas, ale proto, že nástroj, který agent může zavolat, může zavolat i omylem.

Co nevrací

Žádné samotné záznamy, snímky DOM ani IP adresy. Agent dostane to, co člověk vidí v rozhraní, a odkaz pro sledování zbytku.

Limity požadavků a rozsahu

Šedesát požadavků za minutu na klíč, stejně jako REST API. Časový rozsah je omezen na 365 dní a seznam výsledků na 200 řádků; zkrácená odpověď to výslovně uvede, protože tiše zkrácený seznam vypadá stejně jako úplný.

4. Pro tvůrce klienta

Tři metody: server/discover, tools/list, tools/call. Žádné relace, žádný proud GET ani Last-Event-ID - ty patří do verzí protokolu do 2025-11-25 a nejsou součástí této verze. GET nebo DELETE dostane 405.

Každý POST obsahuje MCP-Protocol-Version, Mcp-Method a pro tools/call, Mcp-Name, přičemž všechny hodnoty musí odpovídat tělu. Neshoda vrací 400 s chybou JSON-RPC -32020; nepodporovaná verze vrací 400 s -32022 a seznamem podporovaných verzí, aby klient mohl jednu vybrat a zkusit to znovu.

Záměrně dva druhy chyb

Nesprávně vytvořený požadavek nebo neznámý nástroj je chyba JSON-RPC. „Projekt není uvolněn“ nebo „relace neexistuje“ se vrací jako běžný výsledek s isError: true - z druhého typu se model může zotavit dotazem na mp_projects a novým pokusem, z prvního nikoli.

Výsledky obsahují jak structuredContent , tak stejná data serializovaná do textového bloku, aby i starší klienti dostali něco užitečného.