MCP-szerver

1. Mire képes ezzel egy ügynök

Irányítson egy Model Context Protocol-klienst a végpontra, és olyan kérdéseket tehet fel, mint „melyik oldal okozza ebben a hónapban a legtöbb dühös kattintást” vagy „mutasson három németországi, két percnél hosszabb munkamenetet” — majd a munkamenetet visszajátszó linket adhat Önnek.

Eszköz	Mire válaszol
mp_projects	mely projekteket olvashatja ez a kulcs
mp_overview	munkamenetek, emberek, oldalmegtekintések, időtartam, frusztrációs jelzések
mp_sessions	friss munkamenetek visszajátszási linkekkel, ország, eszköz vagy hossz szerint szűrve
mp_session	egy munkamenet: oldalak sorrendben, események, forrás, eszköz
mp_pages	oldalak megtekintésszám szerint, egyedi látogatókkal
mp_frustration	dühös kattintások, hatástalan kattintások és JavaScript-hibák oldalanként csoportosítva
mp_goals	céljai és az egyes célok elérési gyakorisága

2. Csatlakozás

A végpont POST-kéréseket fogad itt: /mcp, és Streamable HTTP-t használ ezzel a protokollverzióval: 2026-07-28.

A hitelesítés szokásos MousePlayer olvasási API-kulccsal történik — ugyanolyannal, amelyet a Beállítások, API-kulcsok alatt hoz létre, és amelyet a REST API is fogad. Nincs második hitelesítési adat. A kulcs visszavonása ugyanabban a pillanatban az ügynök hozzáférését is megszünteti.

Utána kapcsolja be a projektet

Egy API-kulcs az egész munkaterületét megnyitja. Ez szándékosan nem: minden projektnek saját kapcsolója van az integrációs oldalon, alapértelmezetten kikapcsolva. A be nem kapcsolt projekt nem jelenik meg a mp_projects eredményében, és akkor sem olvasható, ha az ügynök kitalálja az azonosítóját.

Ez nem bürokrácia. Egy telepítési szkript API-kulcsa egyetlen, Ön által ellenőrzött helyen van; az ügynök konfigurációs fájljának API-kulcsa modellkontextusba kerül, ami sokkal lazább felügyelet. Az egyenkénti projektengedélyezés az ehhez illő kontroll.

3. Csak olvasás, és miért nem fog változni

A hét eszköz egyike sem ír semmit. A végpont mögött nincs törlés, export vagy konfigurációmódosítás — nem időhiányból, hanem mert az ügynök által hívható eszközt az ügynök véletlenül is hívhatja.

Mit nem ad vissza

Magukat a felvételeket, DOM-pillanatképeket és IP-címeket nem. Az ügynök azt kapja, amit egy ember a felületen lát, valamint a többi megtekintéséhez szükséges linket.

Kérés- és tartománykorlátok

Kulcsonként percenként hatvan kérés, mint a REST API-nál. Az időtartomány legfeljebb 365 nap, az eredménylista legfeljebb 200 sor; a csonkolt válasz ezt jelzi, mert az észrevétlenül csonkolt lista teljesnek látszik.

4. A klienst fejlesztőknek

Három metódus: server/discover, tools/list, tools/call. Nincsenek munkamenetek, GET-adatfolyam vagy Last-Event-ID — ezek a 2025-11-25-ig terjedő protokollverziókhoz tartoznak, ennek nem részei. GET vagy DELETE esetén 405 a válasz.

Minden POST tartalmazza a MCP-Protocol-Version, Mcp-Method és tools/call esetén a Mcp-Name fejlécet; mindegyiknek egyeznie kell a törzzsel. Eltéréskor 400 a válasz, ezzel a JSON-RPC-hibával: -32020; nem támogatott verziónál pedig 400, ezzel: -32022 és a támogatott verziók listájával, hogy kliense választhasson és újrapróbálkozhasson.

Kétféle hiba, szándékosan

A hibás formátumú kérés vagy ismeretlen eszköz JSON-RPC-hiba. A „projekt nincs engedélyezve” vagy „nincs ilyen munkamenet” normál eredményként érkezik, ezzel: isError: true — mert a modell a második fajta hibából helyreállhat a mp_projects lekérdezésével és újrapróbálással, az elsőből nem.

Az eredmények tartalmazzák a structuredContent értéket és ugyanazokat az adatokat szövegblokkba szerializálva is, hogy a régebbi kliensek is hasznos tartalmat lássanak.