Seva ya MCP

1. Wakala anaweza kufanya nini kwa hili

Elekeza mteja wa Model Context Protocol kwenye endpoint naye anaweza kuuliza maswali kama “ukurasa upi unazalisha mibofyo mingi zaidi ya hasira mwezi huu” au “nionyeshe vipindi vitatu kutoka Ujerumani virefu zaidi ya dakika mbili”, kisha akupe kiungo kinachocheza kipindi tena.

Zana	Majibu
mp_projects	miradi ipi ambayo ufunguo huu unaruhusiwa kusoma
mp_overview	vipindi, watu, utazamaji wa kurasa, muda, ishara za kukerwa
mp_sessions	vipindi vya hivi karibuni vyenye viungo vya uchezaji tena, vimechujwa kwa nchi, kifaa au urefu
mp_session	kipindi kimoja: kurasa kwa mpangilio, matukio, chanzo, kifaa
mp_pages	kurasa kwa utazamaji, pamoja na watembeleaji wa kipekee
mp_frustration	mibofyo ya hasira, mibofyo isiyo na athari na hitilafu za JavaScript zilizopangwa kwa ukurasa
mp_goals	malengo yako na kila moja lilifikiwa mara ngapi

2. Kuunganisha

Endpoint hupokea POST kwenye /mcp na hutumia Streamable HTTP, toleo la itifaki 2026-07-28 linalohusika.

Uthibitishaji ni ufunguo wa kawaida wa API ya kusoma wa MousePlayer, aina ileile unayounda chini ya Mipangilio, Funguo za API, na aina ileile inayotumiwa na REST API. Hakuna kitambulisho cha pili cha ufikiaji. Kubatilisha ufunguo hubatilisha ufikiaji wa wakala wakati uleule.

Kisha washa mradi

Ufunguo wa API hufungua nafasi yako nzima ya kazi. Huu kwa makusudi haufanyi hivyo: kila mradi una swichi yake katika ukurasa wa miunganisho, nayo imezimwa kwa chaguo-msingi. Mradi ambao haujawashwa hauonekani katika mp_projects na hauwezi kusomwa hata wakala akikisia ID yake.

Huo si urasimu. Ufunguo wa API katika hati ya programu ya usakinishaji hukaa mahali pamoja unapotawala; ufunguo wa API katika faili la usanidi wa wakala huingia katika muktadha wa modeli, aina ya uhifadhi yenye uhuru mkubwa zaidi. Kuruhusu mradi mmoja kwa wakati ndiyo udhibiti unaolingana nayo.

3. Kusoma tu, na kwa nini hilo halitabadilika

Hakuna kati ya zana saba inayoandika chochote. Hakuna kufuta, kuhamisha nje wala kubadilisha usanidi nyuma ya endpoint hii, si kwa sababu muda ulituishia, bali kwa sababu zana ambayo wakala anaweza kuita ni zana ambayo wakala anaweza kuita kwa makosa.

Isichorudisha

Hakuna rekodi zenyewe, picha za DOM wala anwani za IP. Wakala hupata anachoona mtu katika kiolesura, pamoja na kiungo cha kutazama mengine.

Vikomo vya kiwango na muda

Maombi sitini kwa dakika kwa kila ufunguo, sawa na REST API. Muda umewekewa kikomo cha siku 365 na orodha ya matokeo mistari 200; jibu lililokatwa husema hivyo, kwa sababu orodha iliyokatwa kimyakimya huonekana kama iliyokamilika.

4. Kwa watu wanaojenga mteja

Njia tatu: server/discover, tools/list, tools/call kama njia. Hakuna vikao, hakuna mtiririko wa GET, hakuna Last-Event-ID — hivyo ni vya matoleo ya itifaki hadi 2025-11-25 na si sehemu ya hili. GET au DELETE hupata 405.

Kila POST hubeba MCP-Protocol-Version, Mcp-Method na, kwa tools/call, Mcp-Name, na kila moja lazima ilingane na mwili. Kutolingana ni 400 yenye hitilafu ya JSON-RPC -32020; toleo lisiloungwa mkono ni 400 lenye -32022 na orodha ya matoleo tunayounga mkono, ili mteja wako aweze kuchagua moja na kujaribu tena.

Aina mbili za hitilafu kwa makusudi

Ombi lenye umbo lisilo sahihi au zana isiyojulikana ni hitilafu ya JSON-RPC. “Mradi huu haujaruhusiwa” au “hakuna kipindi kama hicho” hurudi kama matokeo ya kawaida yenye isError: true — kwa sababu modeli inaweza kurejea kutoka aina ya pili kwa kuomba mp_projects na kujaribu tena, lakini haiwezi kurejea kutoka ya kwanza.

Matokeo hubeba structuredContent na data zilezile zilizowekwa katika kizuizi cha maandishi, ili wateja wa zamani bado waone kitu chenye manufaa.