MCP zerbitzaria

1. Zer egin dezakeen agente batek honekin

Bideratu Model Context Protocol bezeroa muturrera eta honelako galderak egin ditzake: «zein orrik sortzen ditu amorru-klika gehien hilabete honetan?» edo «erakutsi Alemaniako bi minutu baino luzeagoko hiru saio»; eta ondoren saioa erreproduzitzen duen esteka eman diezazuke.

Tresna	Zer erantzuten duen
mp_projects	gako honek zein proiektu irakur ditzakeen
mp_overview	saioak, pertsonak, orri-ikustaldiak, iraupena, frustrazio-seinaleak
mp_sessions	azken saioak erreprodukzio-estekekin, herrialdearen, gailuaren edo luzeraren arabera iragazita
mp_session	saio bat: orriak ordenan, gertaerak, iturria, gailua
mp_pages	orriak ikustaldien arabera, bisitari bakarrekin
mp_frustration	amorru-klikak, erantzunik gabeko klikak eta JavaScript erroreak, orrika taldekatuta
mp_goals	zure helburuak eta bakoitza zenbat aldiz lortu den

2. Konektatzea

Muturrak POST onartzen du hemen: /mcp eta Streamable HTTP erabiltzen du, protokolo-bertsio honekin: 2026-07-28.

Autentifikazioa MousePlayer irakurtzeko API gako arrunta da: Ezarpenak, API gakoak atalean sortzen duzun mota bera, eta REST APIak onartzen duen bera. Ez dago bigarren kredentzialik. Gakoa baliogabetzeak agentearen sarbidea une berean baliogabetzen du.

Ondoren aktibatu proiektua

API gakoak zure lan-eremu osoa irekitzen du. Honek nahita ez: proiektu bakoitzak bere etengailua du integrazioen orrian, eta lehenespenez desaktibatuta dago. Aktibatu gabeko proiektua ez da hemen agertzen: mp_projects eta ezin da irakurri, baita agenteak IDa asmatzen badu ere.

Hori ez da burokrazia. Ezarpen-script batean dagoen API gakoa zuk kontrolatzen duzun toki batean dago; agentearen konfigurazio-fitxategiko API gakoak ereduaren testuingurua elikatzen du, eta zaintza askoz lasaiagoa da hori. Proiektuak banan-banan baimentzea da dagokion kontrola.

3. Irakurtzeko soilik, eta zergatik ez den hori aldatuko

Zazpi tresnetako batek ere ez du ezer idazten. Ez dago ezabatzerik, esportaziorik edo konfigurazio-aldaketarik mutur honen atzean; ez denborarik gabe geratu garelako, baizik eta agente batek dei dezakeen tresna akatsez ere dei dezakeelako.

Zer ez duen itzultzen

Grabaziorik ez bere horretan, DOM kapturarik ez, IP helbiderik ez. Agenteak pertsona batek interfazean ikusten duena jasotzen du, gainerakoa ikusteko estekarekin batera.

Eskaera- eta tarte-mugak

Hirurogei eskaera minutuko eta gako bakoitzeko, REST APIan bezala. Denbora-tartea 365 egunera mugatuta dago eta emaitza-zerrenda 200 errenkadara; moztutako erantzunak hala dio, isilean moztutako zerrendak osoaren itxura bera duelako.

4. Bezeroa eraikitzen dutenentzat

Hiru metodo: server/discover, tools/list, tools/call. Saiorik ez, GET jariorik ez, honako hau ere ez: Last-Event-ID — horiek 2025-11-25 arteko protokolo-bertsioei dagozkie eta ez dira honen parte. GET edo DELETE eskaerak 405 jasotzen du.

POST bakoitzak honako hauek daramatza: MCP-Protocol-Version, Mcp-Method eta, honetarako: tools/call, Mcp-Name, eta bakoitzak gorputzarekin bat etorri behar du. Bat ez etortzeak honako hau dakar: 400 JSON-RPC errore honekin: -32020; onartzen ez den bertsioak honako hau dakar: 400 honako honekin: -32022 eta onartzen ditugun bertsioen zerrendarekin, zure bezeroak bat hautatu eta berriro saia dadin.

Bi errore mota, nahita

Gaizki osatutako eskaera edo tresna ezezaguna JSON-RPC errorea da. «Proiektu hau ez dago baimenduta» edo «ez dago saio hori» emaitza arrunt gisa itzultzen da, honako honekin: isError: true — ereduak bigarren motatik berreskura dezakeelako, honako hau galdetuz: mp_projects eta berriro saiatuz; lehenengotik ezin da berreskuratu.

Emaitzek honako hau daramate: structuredContent eta datu berak testu-bloke batean serializatuta, bezero zaharragoek ere zerbait erabilgarria ikus dezaten.