MCP-server
Låt en AI-agent läsa din analys: sju verktyg via Model Context Protocol, alla med enbart läsåtkomst och autentisering med en API-nyckel du redan har.
1. Vad en agent kan göra
Anslut en Model Context Protocol-klient till slutpunkten så kan den fråga exempelvis ”vilken sida ger flest raseriklick den här månaden” eller ”visa tre sessioner från Tyskland som är längre än två minuter” och sedan ge dig en länk som spelar upp sessionen.
| Verktyg | Svarar på |
|---|---|
mp_projects | vilka projekt nyckeln får läsa |
mp_overview | sessioner, personer, sidvisningar, varaktighet, frustrationssignaler |
mp_sessions | senaste sessioner med uppspelningslänkar, filtrerade efter land, enhet eller längd |
mp_session | en session: sidor i ordning, händelser, källa, enhet |
mp_pages | sidor efter visningar, med unika besökare |
mp_frustration | raseriklick, döda klick och JavaScript-fel grupperade per sida |
mp_goals | dina mål och hur ofta varje mål nåddes |
Varje session som agenten rapporterar har en länk som en människa kan öppna. En agent som sammanfattar vad den såg är användbar. En agent som också visar de tjugo sekunder den bygger slutsatsen på går att kontrollera.
2. Anslutning
Slutpunkten tar emot POST på /mcp och använder Streamable HTTP, protokollversion 2026-07-28.
Autentiseringen använder en vanlig MousePlayer-API-nyckel med läsåtkomst, samma typ som du skapar under Inställningar, API-nycklar och använder för REST-API:et. Inga ytterligare autentiseringsuppgifter behövs. Återkallar du nyckeln återkallas agentens åtkomst samtidigt.
Aktivera sedan projektet
En API-nyckel öppnar hela arbetsytan. Detta gör avsiktligt inte det: varje projekt har ett eget reglage på integrationssidan, avstängt som standard. Ett projekt som inte är aktiverat visas inte i mp_projects och kan inte läsas även om agenten gissar dess ID.
Det är inte byråkrati. En API-nyckel i ett distributionsskript finns på en plats du styr. En nyckel i en agents konfigurationsfil matas in i en modellkontext och förvaras därmed betydligt mindre avgränsat. Att tillåta ett projekt åt gången ger kontroll som passar detta.
3. Endast läsning och varför det inte ändras
Inget av de sju verktygen skriver något. Slutpunkten erbjuder ingen radering, export eller konfigurationsändring. Det beror inte på tidsbrist utan på att ett verktyg en agent kan anropa också kan anropas av misstag.
Vad som inte returneras
Inga inspelningar i sig, inga DOM-ögonblicksbilder och inga IP-adresser. Agenten får det en person ser i gränssnittet plus länken för att se resten.
Anrops- och intervallgränser
Sextio anrop per minut och nyckel, samma som REST-API:et. Ett tidsintervall begränsas till 365 dagar och en resultatlista till 200 rader. Ett kapat svar anger det, eftersom en tyst kapad lista ser ut precis som en komplett.
4. För dig som bygger klienten
Tre metoder: server/discover, tools/list, tools/call. Inga sessioner, ingen GET-ström och inget Last-Event-ID – de hör till protokollversioner till och med 2025-11-25 och ingår inte här. GET eller DELETE ger 405.
Varje POST innehåller MCP-Protocol-Version, Mcp-Method och för tools/call, Mcp-Name, och vart och ett måste matcha innehållet. En avvikelse ger 400 med JSON-RPC-felet -32020. En version som inte stöds ger 400 med -32022 och listan över versioner vi stöder, så att klienten kan välja en och försöka igen.
Två sorters fel, avsiktligt
En felaktig begäran eller ett okänt verktyg är ett JSON-RPC-fel. ”Projektet är inte tillåtet” eller ”sessionen finns inte” returneras som ett normalt resultat med isError: true – eftersom en modell kan återhämta sig från den andra typen genom att anropa mp_projects och försöka igen, men inte från den första.
Resultat innehåller både structuredContent och samma data serialiserade till ett textblock så att äldre klienter ändå får användbar information.
Alla nämnda varumärken tillhör respektive ägare. MousePlayer har ingen affärsrelation med leverantörerna.