Ẹ̀rọ ìpèsè MCP

1. Ohun tí aṣojú lè ṣe pẹ̀lú èyí

Ẹ tọ́ka client Model Context Protocol sí endpoint, ó sì lè béèrè ìbéèrè bí “ojú ìwé wo ló ń fa ìtẹ̀ ìbínú jù ní oṣù yìí” tàbí “fi ìgbà ìlò mẹ́ta láti Germany tó gùn ju ìṣẹ́jú méjì hàn mi” — kí ó sì fún yín ní ìjápọ̀ tó ń tún ìgbà ìlò ṣeré.

Irinṣẹ́	Ìdáhùn
mp_projects	iṣẹ́ akanṣe tí key yìí lè kà
mp_overview	ìgbà ìlò, ènìyàn, ìwò ojú ìwé, àkókò, àmì ìbànújẹ́
mp_sessions	ìgbà ìlò láìpẹ́ pẹ̀lú ìjápọ̀ ìtúnṣeré, tí a ṣe àlẹ̀mọ́ nípa orílẹ̀-èdè, ẹ̀rọ tàbí gígùn
mp_session	ìgbà ìlò kan: ojú ìwé ní ìtòlẹ́sẹẹsẹ, ìṣẹ̀lẹ̀, orísun, ẹ̀rọ
mp_pages	ojú ìwé nípa ìwò, pẹ̀lú àlejò aláìlẹ́ẹ̀kejì
mp_frustration	ìtẹ̀ ìbínú, ìtẹ̀ aláìlesì àti àṣìṣe JavaScript tí a pín nípa ojú ìwé
mp_goals	àfojúsùn yín àti iye ìgbà tí a dé ọ̀kọ̀ọ̀kan

2. Sísopọ̀

Endpoint ń gba POST ní /mcp ó sì ń lo Streamable HTTP, ẹ̀dà protocol 2026-07-28.

Ìjẹ́rìí jẹ́ API key kíka MousePlayer déédéé — irú kan náà tí ẹ ṣẹ̀dá lábẹ́ Ètò, API Keys, àti irú kan náà tí REST API ń gbà. Kò sí ìwé àṣẹ kejì. Fífagilé key ń fagilé ààyè aṣojú ní àkókò kan náà.

Lẹ́yìn náà ẹ mú iṣẹ́ akanṣe ṣiṣẹ́

API key ń ṣí gbogbo àgbègbè iṣẹ́ yín. Èyí mọ̀ọ́mọ̀ kò ṣe bẹ́ẹ̀: iṣẹ́ akanṣe kọ̀ọ̀kan ní ṣọ́ọ̀ṣì tirẹ̀ lórí ojú ìwé ìsopọ̀, kò sì ṣiṣẹ́ láti ìbẹ̀rẹ̀. Iṣẹ́ akanṣe tí a kò mú ṣiṣẹ́ kò hàn nínú mp_projects a kò sì lè kà á, kódà bí aṣojú bá fojú díwọ̀n ID rẹ̀.

Kì í ṣe ìṣòro ìlànà lásán. API key nínú síkírípù fífisílẹ̀ wà ní ibi kan tí ẹ ṣàkóso; API key nínú fáìlì ìṣètò aṣojú ń bọ́ àyíká àwòṣe, ìtọ́jú irú èyí sì tú sí i púpọ̀. Fífi iṣẹ́ akanṣe kan sílẹ̀ lẹ́ẹ̀kan ni ìṣàkóso tó bá a mu.

3. Kíka nìkan àti ìdí tí èyí kò fi ní yípadà

Kò sí ọ̀kan nínú irinṣẹ́ méje tó ń kọ ohunkóhun. Kò sí píparẹ́, kò sí gbigbe jáde, kò sí àyípadà ìṣètò lẹ́yìn endpoint yìí — kì í ṣe nítorí àkókò wa parí, ṣùgbọ́n nítorí irinṣẹ́ tí aṣojú lè pè jẹ́ irinṣẹ́ tí aṣojú lè pè ní àṣìṣe.

Ohun tí kò dá padà

Kò sí ìgbàsílẹ̀ fúnra rẹ̀, kò sí àwòrán DOM, kò sí àdírẹ́sì IP. Aṣojú gba ohun tí ènìyàn rí nínú ojú ìṣàkóso, pẹ̀lú ìjápọ̀ láti wo ìyókù.

Ààlà ìwọ̀n àti àkókò

Ìbéèrè ọgọ́ta fún ìṣẹ́jú kan fún key kan, kan náà bí REST API. Àkókò ní ààlà ọjọ́ 365, àtòjọ àbájáde sì ní ààlà ìlà 200; ìdáhùn tí a gé kúrú sọ bẹ́ẹ̀, nítorí àtòjọ tí a gé láìpariwo dà bí èyí tó pé gẹ́lẹ́.

4. Fún àwọn tó ń kọ client

Ọ̀nà mẹ́ta: server/discover, tools/list, tools/call. Kò sí ìgbà ìlò, kò sí ìṣàn GET, kò sí Last-Event-ID — wọ̀nyẹn jẹ́ ti ẹ̀dà protocol títí dé 2025-11-25, wọn kì í sì ṣe apá èyí. GET tàbí DELETE ń gba 405.

Gbogbo POST ní MCP-Protocol-Version, Mcp-Method àti, fún tools/call, Mcp-Name, ọ̀kọ̀ọ̀kan sì gbọ́dọ̀ bá ara ìbéèrè mu. Àìbámu jẹ́ 400 pẹ̀lú àṣìṣe JSON-RPC -32020; ẹ̀dà tí a kò ṣe ìrànlọ́wọ́ fún jẹ́ 400 pẹ̀lú -32022 àti àtòjọ ẹ̀dà tí a ṣe ìrànlọ́wọ́ fún, kí client yín lè yan ọ̀kan, kí ó sì tún gbìyànjú.

Irú àṣìṣe méjì, pẹ̀lú ète

Ìbéèrè tí ìrísí rẹ̀ kò tọ́ tàbí irinṣẹ́ àìmọ̀ jẹ́ àṣìṣe JSON-RPC. “A kò fi iṣẹ́ akanṣe yìí sílẹ̀” tàbí “kò sí irú ìgbà ìlò” ń padà gẹ́gẹ́ bí àbájáde déédéé pẹ̀lú isError: true — nítorí àwòṣe lè bọ́ lọ́wọ́ irú kejì nípa bíbèèrè mp_projects àti àtúngbìyànjú, kò sì lè bọ́ lọ́wọ́ àkọ́kọ́.

Àbájáde ní structuredContent àti dátà kan náà tí a serialise sínú block ọ̀rọ̀, kí client àtijọ́ ṣì rí ohun tó wúlò.