MCP Server

1. Ano ang Magagawa ng Agent Dito

Ituro ang client ng Model Context Protocol sa endpoint at makapagtatanong ito ng “aling pahina ang may pinakamaraming rage click ngayong buwan” o “ipakita ang tatlong session mula sa Germany na mahigit dalawang minuto” - at makapagbibigay ng link para panoorin ang session.

Tool	Sinasagot
mp_projects	aling mga project ang mababasa ng key na ito
mp_overview	mga session, tao, page view, tagal, senyas ng frustration
mp_sessions	mga kamakailang session na may link ng replay, na-filter ayon sa bansa, device o tagal
mp_session	isang session: sunod-sunod na pahina, mga event, pinagmulan, device
mp_pages	mga pahina ayon sa view, kasama ang mga natatanging bisita
mp_frustration	mga rage click, dead click at error sa JavaScript na pinangkat ayon sa pahina
mp_goals	inyong mga goal at gaano kadalas naabot ang bawat isa

2. Pagkonekta

Tumatanggap ang endpoint ng POST sa /mcp at gumagamit ng Streamable HTTP, bersiyon ng protocol na 2026-07-28.

Karaniwang read API key ng MousePlayer ang pagpapatunay - kapareho ng ginagawa sa Mga Setting, Mga API key, at kapareho ng tinatanggap ng REST API. Walang ikalawang credential. Agad ding mababawi ang access ng agent sa pagbawi ng key.

Pagkatapos, Paganahin ang Project

Binubuksan ng API key ang buong workspace. Sadyang hindi ito: may sariling switch ang bawat project sa pahina ng mga integration, at naka-off bilang default. Hindi lumilitaw sa mp_projects ang project na hindi pinagana at hindi ito mababasa kahit mahulaan ng agent ang ID.

May dahilan ito. Nasa lugar na kontrolado ninyo ang API key sa deploy script; pumapasok sa konteksto ng modelo ang API key sa configuration file ng agent, na mas maluwag ang pangangalaga. Ang pagpapahintulot sa bawat project ang angkop na kontrol.

3. Read-only at Bakit Hindi Iyon Magbabago

Walang isinusulat ang pitong tool. Walang pagbura, export o pagbabago ng configuration sa endpoint na ito - dahil ang tool na matatawag ng agent ay maaari ring matawag nang mali.

Ano ang Hindi Nito Ibinabalik

Walang recording mismo, DOM snapshot o IP address. Nakukuha ng agent ang nakikita ng tao sa interface, kasama ang link para panoorin ang iba.

Mga Limitasyon sa Rate at Saklaw

Animnapung request bawat minuto sa bawat key, gaya ng REST API. Hanggang 365 araw ang panahon at 200 row ang listahan; sinasabi kung pinutol ang sagot, dahil mukhang kumpleto ang listahang tahimik na pinutol.

4. Para sa mga Gumagawa ng Client

Tatlong paraan: server/discover, tools/list, tools/call. Walang session, GET stream o Last-Event-ID - para iyon sa mga bersiyon ng protocol hanggang 2025-11-25 at hindi bahagi nito. 405 ang sagot sa GET o DELETE.

Bawat POST ay may MCP-Protocol-Version, Mcp-Method at, para sa tools/call, Mcp-Name, at dapat tumugma ang bawat isa sa body. Ang hindi pagtugma ay 400 na may JSON-RPC error na -32020; ang hindi suportadong bersiyon ay 400 na may -32022 at listahan ng mga suportadong bersiyon, upang makapili ang client at subukang muli.

Dalawang Uri ng Error, Sinadya

JSON-RPC error ang maling request o hindi kilalang tool. Karaniwang resulta naman na may isError: true ang “Hindi pinahintulutan ang project” o “walang ganoong session” - dahil makababawi ang modelo sa ikalawa sa pagtatanong ng mp_projects at pagsubok muli, ngunit hindi sa una.

Kasama sa resulta ang structuredContent at ang parehong datos na serialized sa text block, upang may kapaki-pakinabang pa ring makita ang mas lumang client.