MCP-palvelin

1. Mitä agentti voi tehdä

Ohjaa Model Context Protocol -asiakas päätepisteeseen. Se voi kysyä esimerkiksi ”mikä sivu tuottaa eniten raivoklikkauksia tässä kuussa” tai ”näytä kolme yli kahden minuutin istuntoa Saksasta” — ja antaa sitten istunnon toistavan linkin.

Työkalu	Vastaa kysymykseen
mp_projects	mitä projekteja tämä avain saa lukea
mp_overview	istunnot, henkilöt, sivun katselut, kesto, turhautumissignaalit
mp_sessions	viimeisimmät istunnot toistolinkkeineen, suodatus maan, laitteen tai keston mukaan
mp_session	yksi istunto: sivut järjestyksessä, tapahtumat, lähde, laite
mp_pages	sivut katselujen mukaan ja yksilöivät kävijät
mp_frustration	raivoklikkaukset, toimimattomat klikkaukset ja JavaScript-virheet sivuittain
mp_goals	tavoitteet ja kunkin saavuttamiskerrat

2. Yhdistäminen

Päätepiste vastaanottaa POST-pyynnöt osoitteessa /mcp ja käyttää Streamable HTTP:tä, protokollaversio 2026-07-28.

Todennus käyttää tavallista MousePlayerin luku-API-avainta — samaa, joka luodaan kohdassa Asetukset, API-avaimet ja jonka REST API hyväksyy. Toista tunnistetietoa ei ole. Avaimen peruminen peruu samalla hetkellä agentin pääsyn.

Ota sitten projekti käyttöön

API-avain avaa koko työtilan. Tämä yhteys ei tarkoituksella tee niin: jokaisella projektilla on integraatiosivulla oma kytkin, joka on oletuksena pois päältä. Käytöstä poissa oleva projekti ei näy tuloksessa mp_projects eikä sitä voi lukea, vaikka agentti arvaisi tunnuksen.

Tämä ei ole byrokratiaa. Käyttöönottoskriptin API-avain on yhdessä hallitussa paikassa; agentin määritystiedoston API-avain syöttää mallin kontekstia, jossa säilytys on paljon väljemmin hallittua. Yhden projektin vapauttaminen kerrallaan on tähän sopiva hallintakeino.

3. Vain lukuun — eikä tämä muutu

Mikään seitsemästä työkalusta ei kirjoita mitään. Päätepisteen takana ei ole poistoa, vientiä tai määritysmuutosta — ei ajanpuutteen vuoksi, vaan koska agentin kutsuttavissa oleva työkalu on kutsuttavissa myös vahingossa.

Mitä ei palauteta

Ei itse tallenteita, DOM-tilannekuvia tai IP-osoitteita. Agentti saa samat tiedot kuin ihminen käyttöliittymässä ja linkin lopun katsomiseen.

Pyyntö- ja aikavälirajat

Kuusikymmentä pyyntöä minuutissa avainta kohti, kuten REST API -rajapinnassa. Aikavälin raja on 365 päivää ja tulosluettelon 200 riviä. Katkaistu vastaus kertoo katkaisusta, koska hiljaa katkaistu luettelo näyttää täydelliseltä.

4. Asiakasohjelman rakentajille

Kolme menetelmää: server/discover, tools/list, tools/call. Ei istuntoja, GET-virtaa tai otsaketta Last-Event-ID — ne kuuluvat enintään protokollaversioon 2025-11-25 eivätkä tähän versioon. GET tai DELETE saa 405:n.

Jokaisessa POST-pyynnössä ovat MCP-Protocol-Version, Mcp-Method ja menetelmälle tools/call otsake Mcp-Name, ja kunkin on vastattava sisältöä. Ristiriita palauttaa 400 ja JSON-RPC-virheen -32020; tukematon versio palauttaa 400 ja -32022 sekä tuettujen versioiden luettelon, josta asiakas voi valita ja yrittää uudelleen.

Kaksi virhetyyppiä tarkoituksella

Virheellinen pyyntö tai tuntematon työkalu on JSON-RPC-virhe. ”Projektia ei ole vapautettu” tai ”istuntoa ei ole” palautuu normaalina tuloksena, jossa on isError: true — koska malli voi toipua jälkimmäisestä kysymällä mp_projects ja yrittämällä uudelleen, mutta ei ensimmäisestä.

Tuloksissa ovat sekä structuredContent että samat tiedot tekstilohkoon sarjoitettuina, jotta vanhatkin asiakkaat näkevät jotain hyödyllistä.