Server MCP

1. Ce poate face un agent cu acestea

Configurați un client Model Context Protocol să folosească endpointul și va putea pune întrebări precum „ce pagină produce cele mai multe clicuri furioase luna aceasta” sau „arată-mi trei sesiuni din Germania mai lungi de două minute” — apoi să vă ofere un link care redă sesiunea.

Instrument	Răspunde cu
mp_projects	proiectele pe care această cheie le poate citi
mp_overview	sesiuni, persoane, vizualizări de pagină, durată, semnale de frustrare
mp_sessions	sesiuni recente cu linkuri de redare, filtrate după țară, dispozitiv sau durată
mp_session	o sesiune: pagini în ordine, evenimente, sursă, dispozitiv
mp_pages	pagini după numărul de vizualizări, cu vizitatori unici
mp_frustration	clicuri furioase, clicuri fără răspuns și erori JavaScript grupate după pagină
mp_goals	obiectivele dvs. și frecvența atingerii fiecăruia

2. Conectare

Endpointul acceptă POST la /mcp și folosește Streamable HTTP, versiunea de protocol 2026-07-28.

Autentificarea folosește o cheie API MousePlayer obișnuită, de citire — de același tip cu cele create în Setări, Chei API și cu cele acceptate de API-ul REST. Nu există un al doilea set de date de autentificare. Revocarea cheii revocă accesul agentului în același moment.

Apoi activați proiectul

O cheie API oferă acces la întregul spațiu de lucru. Acest endpoint, intenționat, nu: fiecare proiect are propriul comutator pe pagina de integrări, dezactivat implicit. Un proiect neactivat nu apare în mp_projects și nu poate fi citit nici dacă agentul îi ghicește ID-ul.

Nu este birocrație. O cheie API într-un script de implementare se află într-un singur loc pe care îl controlați; o cheie API în fișierul de configurare al unui agent alimentează contextul unui model, unde controlul este mult mai redus. Autorizarea accesului separat pentru fiecare proiect este măsura potrivită.

3. Doar citire și de ce așa va rămâne

Niciunul dintre cele șapte instrumente nu scrie nimic. În spatele acestui endpoint nu există ștergere, export sau modificare de configurare — nu pentru că nu am avut timp, ci pentru că un instrument pe care un agent îl poate apela este unul pe care îl poate apela și din greșeală.

Ce nu returnează

Nu returnează înregistrările propriu-zise, capturi DOM sau adrese IP. Agentul primește ce vede o persoană în interfață, plus linkul pentru a viziona restul.

Limite de cereri și intervale

Șaizeci de cereri pe minut pe cheie, la fel ca API-ul REST. Intervalul de timp este limitat la 365 de zile, iar lista de rezultate la 200 de rânduri; un răspuns trunchiat precizează acest lucru, deoarece o listă trunchiată fără avertizare arată exact ca una completă.

4. Pentru cei care construiesc clientul

Trei metode: server/discover, tools/list, tools/call. Fără sesiuni, flux GET sau Last-Event-ID — acestea aparțin versiunilor de protocol până la 2025-11-25 și nu fac parte din aceasta. Un GET sau DELETE primește 405.

Fiecare POST include MCP-Protocol-Version, Mcp-Method și, pentru tools/call, Mcp-Name, iar fiecare trebuie să corespundă corpului. O nepotrivire produce 400 cu eroarea JSON-RPC -32020; o versiune neacceptată produce 400 cu -32022 și lista versiunilor acceptate, astfel încât clientul să poată alege una și reîncerca.

Două tipuri de erori, intenționat

O cerere cu format incorect sau un instrument necunoscut reprezintă o eroare JSON-RPC. „Acest proiect nu este autorizat pentru acces” sau „nu există o astfel de sesiune” revine ca rezultat normal cu isError: true — deoarece un model se poate redresa după al doilea tip întrebând mp_projects și încercând din nou, dar nu se poate redresa după primul.

Rezultatele includ atât structuredContent cât și aceleași date serializate într-un bloc de text, astfel încât și clienții mai vechi primesc ceva util.