MCP-server
Lad en AI-agent læse dine analysedata: syv værktøjer via Model Context Protocol, alle med kun læseadgang, godkendt med en API-nøgle, du allerede har.
1. Hvad en agent kan gøre
Forbind en Model Context Protocol-klient til endepunktet, så kan den spørge »hvilken side giver flest raseriklik denne måned« eller »vis tre sessioner fra Tyskland på over to minutter« - og give dig et link, der afspiller sessionen.
| Værktøj | Besvarer |
|---|---|
mp_projects | hvilke projekter denne nøgle må læse |
mp_overview | sessioner, personer, sidevisninger, varighed og frustrationssignaler |
mp_sessions | seneste sessioner med afspilningslinks, filtreret efter land, enhed eller længde |
mp_session | én session: sider i rækkefølge, hændelser, kilde, enhed |
mp_pages | sider efter visninger med unikke besøgende |
mp_frustration | raseriklik, døde klik og JavaScript-fejl grupperet efter side |
mp_goals | dine mål, og hvor ofte hvert blev nået |
Hver session, agenten rapporterer, har et link, et menneske kan åbne. En agent, der opsummerer sine fund, er nyttig; en agent, der også viser de tyve sekunder, den bygger på, kan kontrolleres.
2. Tilslutning
Endepunktet modtager POST på /mcp og bruger Streamable HTTP, protokolversion 2026-07-28.
Godkendelse sker med en almindelig MousePlayer-API-læsenøgle - samme type, du opretter under Indstillinger, API-nøgler, og som REST-API'et bruger. Der er ingen ekstra adgangsoplysninger. Tilbagekaldes nøglen, ophører agentens adgang samtidig.
Aktivér derefter projektet
En API-nøgle åbner hele dit arbejdsområde. Det gør denne bevidst ikke: hvert projekt har sin egen kontakt på integrationssiden, og den er som standard deaktiveret. Et projekt, der ikke er aktiveret, vises ikke i mp_projects og kan ikke læses, selv hvis agenten gætter dets ID.
Det er ikke bureaukrati. En API-nøgle i et installationsscript ligger ét sted, du styrer; en API-nøgle i en agents konfigurationsfil indgår i en modelkontekst, og det er en langt løsere form for opbevaring. Godkendelse af ét projekt ad gangen er den passende kontrol.
3. Kun læseadgang, og hvorfor det ikke ændres
Ingen af de syv værktøjer skriver noget. Ingen sletning, eksport eller konfigurationsændring findes bag dette endepunkt - ikke fordi tiden slap op, men fordi et værktøj, en agent kan kalde, også kan kaldes ved en fejl.
Hvad returneres ikke
Ingen optagelser, ingen DOM-øjebliksbilleder, ingen IP-adresser. Agenten får det, en person ser i grænsefladen, samt linket til at se resten.
Forespørgsels- og intervalgrænser
Tres forespørgsler pr. minut pr. nøgle, som REST-API'et. Et tidsinterval er begrænset til 365 dage og en resultatliste til 200 rækker; et afkortet svar oplyser det, fordi en stiltiende afkortet liste ligner en komplet liste.
4. Til dem, der bygger klienten
Tre metoder: server/discover, tools/list, tools/call. Ingen sessioner, ingen GET-strøm, intet Last-Event-ID - disse hører til protokolversioner til og med 2025-11-25 og er ikke del af denne. GET eller DELETE giver 405.
Hver POST indeholder MCP-Protocol-Version, Mcp-Method og for tools/call, Mcp-Name, og hver skal matche indholdet. Uoverensstemmelse giver 400 med JSON-RPC-fejlen -32020; en ikke-understøttet version giver 400 med -32022 og listen over understøttede versioner, så klienten kan vælge en og prøve igen.
To fejltyper, med vilje
En forkert formateret forespørgsel eller et ukendt værktøj er en JSON-RPC-fejl. »Dette projekt er ikke frigivet« eller »sessionen findes ikke« returneres som et almindeligt resultat med isError: true - fordi en model kan komme videre fra den anden type ved at spørge mp_projects og prøve igen, men ikke fra den første.
Resultater indeholder både structuredContent og de samme data serialiseret i en tekstblok, så ældre klienter stadig får noget nyttigt.
Alle nævnte varemærker tilhører deres respektive ejere. MousePlayer har ingen forretningsforbindelse med disse udbydere.