Rajekara MCP
Bihêlin ajanekî AI analîtîka we bixwîne: heft amûr bi rêya Model Context Protocol, hemû tenê ji bo xwendinê, bi mifteya API ya ku hûn jixwe xwedî ne têne piştrastkirin.
1. Ajanek dikare bi vê çi bike
Klîentekî Model Context Protocol ber bi xala dawî ve rê bikin; ew dikare pirsên wek “kîjan rûpel vê mehê herî zêde klîkên hêrsê çêdike” an “sê danişînên ji Almanyayê yên ji du deqeyan dirêjtir nîşanî min bide” bike - û paşê girêdanekê bide we ku danişînê ji nû ve dilîze.
| Amûr | Bersiv |
|---|---|
mp_projects | kîjan projeyan ev mifte dikare bixwîne |
mp_overview | danişîn, kes, dîtinên rûpelê, dem, nîşanên dilşikestiyê |
mp_sessions | danişînên dawî bi girêdanên ji nû ve lîstinê, li gorî welat, amûr an dirêjahiyê hatine parzûnkirin |
mp_session | danişîneke tenê: rûpel bi rêzê, bûyer, çavkanî, amûr |
mp_pages | rûpel li gorî dîtinan, bi serdankerên yekane |
mp_frustration | klîkên hêrsê, klîkên bêbersiv û çewtiyên JavaScript li gorî rûpelê hatine komkirin |
mp_goals | armancên we û çend caran her yek hatiye gihîştin |
Her danişîna ku ajan rapor dike bi girêdanekê tê ku mirov dikare veke. Ajanekî ku dîtina xwe kurt dike bi kêr tê; ajanekî ku wan bîst çirkeyên ku ew li ser wan ava kiriye jî nîşanî we dide, dikare were kontrolkirin.
2. Girêdan
Xala dawî li vir POST qebûl dike: /mcp û Streamable HTTP bi guhertoya protokolê ya 2026-07-28 diaxive.
Piştrastkirin bi mifteyeke asayî ya API ya xwendinê ya MousePlayer e - heman cureya ku hûn di Settings, API keys de çêdikin û heman cureya ku REST API qebûl dike. Agahiyeke têketinê ya duyem tune ye. Rakirina mifteyê di heman demê de gihîştina ajanê radike.
Paşê projeyê çalak bikin
Mifteyeke API tevahiya qada xebata we vedike. Ev bi qestî wisa nake: her proje li rûpela girêdanan guherîna xwe heye û ew di destpêkê de girtî ye. Projeyeke ku nehatibe çalakkirin di mp_projects de xuya nabe û heta ger ajan ID ya wê texmîn bike jî nayê xwendin.
Ev burokratî nîne. Mifteyeke API di skrîpta belavkirinê de li cihekî ku hûn kontrol dikin dimîne; mifteyeke API di pela veavakirina ajanê de dikeve çarçoveya modelê, û ev awayekî pir vekirîtir ê parastinê ye. Vekirina her projeyekê bi serê xwe kontrola guncaw e.
3. Tenê xwendin, û çima ev nayê guhertin
Tu yek ji heft amûran tiştekî nanivîse. Li pişt vê xala dawî rakirin, derxistin an guhertina veavakirinê tune ye - ne ji ber ku dema me nema, lê ji ber ku amûreke ku ajan dikare bang bike, amûrek e ku ew dikare bi xeletî jî bang bike.
Ew çi venagerîne
Ne tomar bixwe, ne wêneyên DOM, ne navnîşanên IP. Ajan tiştê ku kesek di navrûyê de dibîne werdigire, bi girêdana temaşekirina yê mayî re.
Sînorên rêje û navberê
Şêst daxwaz di deqeyekê de ji bo her mifteyê, wek REST API. Navbereke demê bi 365 rojan û lîsteya encaman bi 200 rêzan tê sînorkirin; bersiveke kurtkirî vê dibêje, ji ber ku lîsteyeke bê deng kurtkirî tam wek lîsteyeke tevahî xuya dike.
4. Ji bo kesên ku klîentê ava dikin
Sê rêbaz: server/discover, tools/list, tools/call. Ne danişîn, ne herikîna GET, ne Last-Event-ID - ew yên guhertoyên protokolê heta 2025-11-25 ne û ne beşek ji vê ne. GET an DELETE bersiva 405 werdigire.
Her POST van digire: MCP-Protocol-Version, Mcp-Method û, ji bo tools/call, Mcp-Name, û divê her yek bi laşê daxwazê re li hev bike. Nelihevhatin 400 bi çewtiya JSON-RPC ya -32020 vedigerîne; guhertoyeke bê piştgirî 400 bi -32022 û lîsteya guhertoyên ku em piştgirî dikin vedigerîne, da klîenta we yekê hilbijêre û ji nû ve hewl bide.
Du cure çewtî, bi qestî
Daxwazeke bi teşeya xelet an amûreke nenas çewtiyeke JSON-RPC ye. “Ev proje nehatibe vekirin” an “danişîneke wisa tune ye” wek encameke asayî bi isError: true vedigere - ji ber ku model dikare ji cureya duyem bi pirsîna mp_projects û hewldana ji nû ve derkeve, lê ji ya yekem nikare.
Encaman hem structuredContent hem jî heman daneyên di blokeke nivîsê de rêzkirî digirin, da klîentên kevintir jî tiştekî bi kêr bibînin.
Hemû nîşanên bazirganî yên li vir hatine navkirin yên xwediyên xwe ne. MousePlayer bi van peydakaran re têkiliya bazirganî tune ye.