Freastalaí MCP

1. Cad is féidir le gníomhaire a dhéanamh leis seo

Dírigh cliant Model Context Protocol ar an gcríochphointe agus is féidir leis ceisteanna a chur amhail “cén leathanach is cúis leis an líon is mó cliceálacha feirge an mhí seo” nó “taispeáin trí sheisiún ón nGearmáin atá níos faide ná dhá nóiméad dom” — agus ansin nasc a thabhairt duit a athsheinneann an seisiún.

Uirlis	Freagraí
mp_projects	na tionscadail is féidir leis an eochair seo a léamh
mp_overview	seisiúin, daoine, amhairc leathanaigh, fad, comharthaí frustrachais
mp_sessions	seisiúin le déanaí le naisc athsheinnte, scagtha de réir tíre, gléis nó faid
mp_session	seisiún amháin: leathanaigh in ord, imeachtaí, foinse, gléas
mp_pages	leathanaigh de réir amharc, le cuairteoirí uathúla
mp_frustration	cliceálacha feirge, cliceálacha gan freagra agus earráidí JavaScript grúpáilte de réir leathanaigh
mp_goals	do spriocanna agus cé chomh minic a baineadh gach ceann amach

2. Ceangal

Glacann an críochphointe le POST ag /mcp agus úsáideann sé Streamable HTTP, leagan prótacail 2026-07-28.

Is gnátheochair API léitheoireachta MousePlayer í an fhíordheimhniú — an cineál céanna a chruthaíonn tú faoi Shocruithe, Eochracha API, agus a ghlacann an API REST leis. Níl dintiúr eile ann. Cuirtear rochtain an ghníomhaire ar ceal an nóiméad céanna a chúlghairtear an eochair.

Ansin cumasaigh an tionscadal

Osclaíonn eochair API do spás oibre iomlán. D’aon ghnó, ní dhéanann an ceann seo amhlaidh: tá lasc dá chuid féin ag gach tionscadal ar an leathanach comhtháthaithe, agus tá sé múchta de réir réamhshocraithe. Ní bhíonn tionscadal nach bhfuil cumasaithe le feiceáil in mp_projects agus ní féidir é a léamh fiú má thugann an gníomhaire buille faoi thuairim faoina aitheantas.

Ní maorlathas é sin. Bíonn eochair API i script imscartha in aon áit amháin atá faoi do smacht; beathaíonn eochair API i gcomhad cumraíochta gníomhaire comhthéacs samhla, agus bíonn an coimeád sin i bhfad níos scaoilte. Is é ceadú tionscadail amháin ag an am an rialú a oireann dó.

3. Inléite amháin, agus cén fáth nach n-athróidh sé sin

Ní scríobhann aon cheann de na seacht n-uirlis aon rud. Níl scriosadh, easpórtáil ná athrú cumraíochta taobh thiar den chríochphointe seo — ní de bharr easpa ama, ach toisc gur féidir le gníomhaire uirlis atá ar fáil dó a ghlaoch trí dhearmad freisin.

An méid nach dtugann sé ar ais

Ní thugann sé na taifeadtaí féin, léargais DOM ná seoltaí IP ar ais. Faigheann an gníomhaire an méid a fheiceann duine sa chomhéadan, mar aon leis an nasc chun an chuid eile a fheiceáil.

Teorainneacha ráta agus raoin

Seasca iarratas sa nóiméad in aghaidh na heochrach, mar atá leis an API REST. Tá an raon ama teoranta do 365 lá agus liosta torthaí do 200 ró; deir freagra teasctha é sin, toisc go mbreathnaíonn liosta a theasctar gan fógra díreach cosúil le liosta iomlán.

4. Dóibh siúd a thógann an cliant

Trí mhodh: server/discover, tools/list, tools/call. Gan seisiúin, gan sruth GET, gan Last-Event-ID — baineann siad sin le leaganacha prótacail suas go 2025-11-25 agus ní cuid den cheann seo iad. Faigheann GET nó DELETE 405.

Bíonn ag gach POST MCP-Protocol-Version, Mcp-Method agus, i gcás tools/call, Mcp-Name, agus caithfidh gach ceann a bheith ag teacht leis an gcorp. Is éard atá i neamhréir ná 400 le hearráid JSON-RPC -32020; is éard atá i leagan nach dtacaítear leis ná 400 le -32022 agus liosta na leaganacha a dtacaímid leo, ionas gur féidir le do chliant ceann a roghnú agus triail eile a bhaint as.

Dhá chineál earráide, d’aon ghnó

Is earráid JSON-RPC é iarratas míchumtha nó uirlis anaithnid. Tagann “Níl an tionscadal seo ceadaithe” nó “níl a leithéid de sheisiún ann” ar ais mar ghnáththoradh le isError: true — toisc gur féidir le samhail téarnamh ón dara cineál trí iarraidh ar mp_projects agus triail eile a bhaint as, ach ní féidir léi téarnamh ón gcéad chineál.

Bíonn sna torthaí araon structuredContent agus na sonraí céanna srathaithe i mbloc téacs, ionas go bhfeiceann cliaint níos sine rud éigin úsáideach fós.