MCP-bediener

1. Wat 'n agent hiermee kan doen

Rig 'n Model Context Protocol-kliënt na die eindpunt en dit kan vrae vra soos “watter bladsy het hierdie maand die meeste woedeklikke?” of “wys drie sessies uit Duitsland langer as twee minute” — en dan 'n skakel gee wat die sessie herspeel.

Hulpmiddel	Antwoorde
mp_projects	watter projekte hierdie sleutel mag lees
mp_overview	sessies, mense, bladsybesigtigings, duur, frustrasieseine
mp_sessions	onlangse sessies met herspeelskakels, volgens land, toestel of lengte gefiltreer
mp_session	een sessie: bladsye in volgorde, gebeure, bron, toestel
mp_pages	bladsye volgens besigtigings, met unieke besoekers
mp_frustration	woedeklikke, reaksielose klikke en JavaScript-foute volgens bladsy gegroepeer
mp_goals	u doelwitte en hoe dikwels elkeen bereik is

2. Koppel

Die eindpunt ontvang POST by /mcp en gebruik Streamable HTTP, protokolweergawe 2026-07-28.

Stawing gebruik 'n gewone MousePlayer-lees-API-sleutel — dieselfde soort wat u onder Instellings, API-sleutels skep en wat die REST API aanvaar. Daar is geen tweede aanmeldbesonderheid nie. As die sleutel herroep word, word die agent se toegang op dieselfde oomblik herroep.

Skakel dan die projek aan

'n API-sleutel ontsluit u hele werkruimte. Hierdie toegang doen dit doelbewus nie: elke projek het sy eie skakelaar op die integrasiebladsy, by verstek af. 'n Projek wat nie aangeskakel is nie, verskyn nie in mp_projects nie en kan nie gelees word nie, selfs al raai die agent sy ID.

Dit is nie burokrasie nie. 'n API-sleutel in 'n ontplooiingskrip bly op een plek wat u beheer; een in 'n agent se konfigurasielêer voed 'n modelkonteks, met veel losser beheer. Een projek op 'n slag vrystel is die toepaslike beheer.

3. Slegs lees en waarom dit nie gaan verander nie

Geen van die sewe hulpmiddels skryf enigiets nie. Geen uitwissing, uitvoer of konfigurasieverandering agter hierdie eindpunt nie — nie weens tydgebrek nie, maar omdat 'n hulpmiddel wat 'n agent kan aanroep ook per ongeluk aangeroep kan word.

Wat dit nie teruggee nie

Nie die opnames self, DOM-kiekies of IP-adresse nie. Die agent kry wat 'n mens in die koppelvlak sien, plus die skakel om die res te kyk.

Frekwensie- en reekslimiete

Sestig versoeke per minuut per sleutel, dieselfde as die REST API. 'n Tydreeks is tot 365 dae beperk en 'n resultaatlys tot 200 rye; 'n afgekapte antwoord sê dit, want 'n stilweg afgekapte lys lyk presies soos 'n volledige een.

4. Vir kliëntbouers

Drie metodes: server/discover, tools/list, tools/call. Geen sessies, GET-stroom of Last-Event-ID nie — dié behoort aan protokolweergawes tot 2025-11-25 en is nie deel van hierdie een nie. GET of DELETE ontvang 405.

Elke POST bevat MCP-Protocol-Version, Mcp-Method en vir tools/call, Mcp-Nameen elkeen moet by die liggaam pas. 'n Wanpassing is 400 met JSON-RPC-fout -32020; 'n onondersteunde weergawe is 400 met -32022 en die lys ondersteunde weergawes, sodat u kliënt een kan kies en weer probeer.

Doelbewus twee foutsoorte

'n Verkeerd gevormde versoek of onbekende hulpmiddel is 'n JSON-RPC-fout. “Hierdie projek is nie vrygestel nie” of “geen sodanige sessie nie” kom as gewone resultaat terug met isError: true — want 'n model kan van die tweede soort herstel deur mp_projects te vra en weer te probeer, maar nie van die eerste nie.

Resultate bevat sowel structuredContent as dieselfde data in 'n teksblok geserialiseer, sodat ouer kliënte ook iets nuttigs sien.