Gweinydd MCP

1. Beth Gall Asiant Ei Wneud â Hyn

Cyfeiriwch gleient Model Context Protocol at y pwynt terfyn a gall ofyn cwestiynau fel ‘pa dudalen sy’n cynhyrchu’r mwyaf o gliciau dicter y mis hwn’ neu ‘dangoswch dair sesiwn o’r Almaen sy’n hwy na dwy funud’ – ac yna rhoi dolen i chi sy’n ailchwarae’r sesiwn.

Offeryn	Yn ateb
mp_projects	pa brosiectau y caiff yr allwedd hon eu darllen
mp_overview	sesiynau, pobl, golygon tudalen, hyd, signalau rhwystredigaeth
mp_sessions	sesiynau diweddar â dolenni ailchwarae, wedi’u hidlo yn ôl gwlad, dyfais neu hyd
mp_session	un sesiwn: tudalennau mewn trefn, digwyddiadau, ffynhonnell, dyfais
mp_pages	tudalennau yn ôl golygon, gydag ymwelwyr unigryw
mp_frustration	cliciau dicter, cliciau diymateb a gwallau JavaScript wedi’u grwpio fesul tudalen
mp_goals	eich nodau a pha mor aml y cyrhaeddwyd pob un

2. Cysylltu

Mae’r pwynt terfyn yn cymryd POST yn /mcp ac yn siarad Streamable HTTP, fersiwn protocol 2026-07-28.

Allwedd API darllen MousePlayer arferol yw’r dilysu – yr un math rydych yn ei greu o dan Gosodiadau, Allweddi API, a’r un math mae’r REST API yn ei gymryd. Nid oes ail fanylyn mynediad. Mae dirymu’r allwedd yn dirymu mynediad yr asiant yr un foment.

Yna Galluogwch y Prosiect

Mae allwedd API yn agor eich gweithle cyfan. Nid yw hon yn gwneud hynny’n fwriadol: mae gan bob prosiect ei switsh ei hun ar y dudalen integreiddiadau, ac mae wedi’i ddiffodd yn ddiofyn. Nid yw prosiect heb ei alluogi yn ymddangos yn mp_projects ac ni ellir ei ddarllen hyd yn oed os yw’r asiant yn dyfalu ei ID.

Nid biwrocratiaeth yw hynny. Mae allwedd API mewn sgript gosod yn byw mewn un lle rydych yn ei reoli; mae allwedd API mewn ffeil ffurfweddu asiant yn bwydo cyd-destun model, ac mae hynny’n fath llawer mwy llac o warchodaeth. Rhyddhau un prosiect ar y tro yw’r rheolaeth sy’n cyfateb.

3. Darllen yn Unig, a Pham Na Fydd Hynny’n Newid

Nid yw’r un o’r saith offeryn yn ysgrifennu dim. Nid oes dileu, allforio na newid ffurfweddiad y tu ôl i’r pwynt terfyn hwn – nid oherwydd i ni redeg allan o amser, ond oherwydd bod offeryn y gall asiant ei alw yn offeryn y gall asiant ei alw ar gam.

Beth Nad Yw’n Ei Ddychwelyd

Dim recordiadau eu hunain, dim cipluniau DOM, dim cyfeiriadau IP. Mae’r asiant yn cael yr hyn mae person yn ei weld yn y rhyngwyneb, ynghyd â’r ddolen i wylio’r gweddill.

Terfynau Cyfradd ac Ystod

Chwe deg cais y funud fesul allwedd, yr un fath â’r REST API. Mae ystod amser wedi’i chapio ar 365 diwrnod a rhestr canlyniadau ar 200 o resi; mae ateb wedi’i gwtogi yn dweud hynny, gan fod rhestr wedi’i chwtogi’n dawel yn edrych yn union fel un gyflawn.

4. Ar gyfer y Bobl Sy’n Adeiladu’r Cleient

Tri dull: server/discover, tools/list, tools/call. Dim sesiynau, dim ffrwd GET, dim Last-Event-ID – mae’r rheini’n perthyn i fersiynau protocol hyd at 2025-11-25 ac nid ydynt yn rhan o hwn. Mae GET neu DELETE yn cael 405.

Mae pob POST yn cynnwys MCP-Protocol-Version, Mcp-Method ac, ar gyfer tools/call, Mcp-Name, a rhaid i bob un gyfateb i’r corff. Mae anghysondeb yn 400 gyda gwall JSON-RPC -32020; mae fersiwn heb ei chefnogi yn 400 gyda -32022 a’r rhestr o fersiynau rydym yn eu cefnogi, felly gall eich cleient ddewis un ac ailgeisio.

Dau Fath o Wall, yn Fwriadol

Mae cais wedi’i gamffurfio neu offeryn anhysbys yn wall JSON-RPC. Mae ‘nid yw’r prosiect hwn wedi’i ryddhau’ neu ‘dim sesiwn o’r fath’ yn dod yn ôl fel canlyniad arferol gyda isError: true – gan fod model yn gallu adfer o’r ail fath drwy ofyn am mp_projects ac ailgeisio, ac ni all adfer o’r cyntaf.

Mae canlyniadau’n cynnwys structuredContent a’r un data wedi’i gyfresoli mewn bloc testun, felly mae cleientiaid hŷn yn dal i weld rhywbeth defnyddiol.