MCP serweri

1. Agent munuň bilen näme edip biler

Model Context Protocol kliýentini ahyrky nokada birikdiriň, ol “şu aý haýsy sahypa iň köp gaharly basyş döredýär” ýa-da “Germaniýadan iki minutdan uzyn üç sessiýany görkeziň” ýaly soraglary berip, soň sessiýany görkezýän baglanyşyk berip biler.

Gural	Jogap berýär
mp_projects	bu açaryň haýsy taslamalary okap biljekdigine
mp_overview	sessiýalar, adamlar, sahypa görnüşleri, dowamlylyk, päsgelçilik alamatlary
mp_sessions	ýurt, enjam ýa-da uzynlyk boýunça süzülen ýazgy baglanyşykly soňky sessiýalar
mp_session	bir sessiýa: tertipli sahypalar, wakalar, çeşme, enjam
mp_pages	görnüş sany boýunça sahypalar, özboluşly myhmanlar bilen
mp_frustration	sahypa boýunça toparlanan gaharly basyşlar, jogapsyz basyşlar we JavaScript ýalňyşlyklary
mp_goals	maksatlaryňyz we hersine näçe gezek ýetilendigi

2. Birikdirmek

Ahyrky nokat POST-y şu salgyda kabul edýär: /mcp we Streamable HTTP ulanýar, protokol wersiýasy 2026-07-28.

Tassyklama adaty MousePlayer okaýyş API açarydyr - Sazlamalar, API açarlary bölüminde döredýän we REST API-niň hem kabul edýän şol bir görnüşi. Ikinji giriş maglumaty ýok. Açary ýatyrmak şol pursatda agentiň girişini hem ýatyrýar.

Soň taslamany açyň

API açary tutuş iş meýdançaňyzy açýar. Bu bolsa bilkastlaýyn beýle däl: her taslamanyň birikdirmeler sahypasynda öz açary bar we adaty ýagdaýda ýapyk. Açylmadyk taslama şu netijede görünmeýär: mp_projects we agent ID-sini çaklasa-da okalyp bilinmeýär.

Bu býurokratiýa däl. Ýerleşdirme skriptindäki API açary öz dolandyrýan bir ýeriňizde ýaşaýar; agentiň sazlama faýlyndaky API açary model kontekstine girýär we bu has gowşak gözegçilikdir. Her gezek bir taslama rugsat bermek oňa laýyk dolandyryşdyr.

3. Diňe okamak we näme üçin bu üýtgemez

Ýedi guralyň hiç biri hiç zat ýazmaýar. Bu ahyrky nokadyň aňyrsynda pozmak, eksport ýa-da sazlama üýtgetmek ýok - wagtymyz ýetmändigi üçin däl, agentiň çagyryp bilýän guralyny ýalňyşlyk bilen hem çagyryp bilýändigi üçin.

Näme gaýtarmaýar

Ýazgylaryň özüni, DOM suratlaryny, IP salgylaryny bermeýär. Agent adamyň interfeýsde görýän zadyny we galanlaryny görmek üçin baglanyşygy alýar.

Tizlik we aralyk çäkleri

Her açar üçin minutda altmyş haýyş, REST API bilen birmeňzeş. Wagt aralygy 365 gün we netije sanawy 200 setir bilen çäklendirilýär; gysgaldylan jogap muny aýdýar, sebäbi sessiz gysgaldylan sanaw doly sanaw ýaly görünýär.

4. Kliýenti gurýanlar üçin

Üç usul: server/discover, tools/list, tools/call. Sessiýa, GET akymy ýa-da Last-Event-ID ýok - bular 2025-11-25 çenli protokol wersiýalaryna degişli we bu wersiýanyň bölegi däl. GET ýa-da DELETE 405 alýar.

Her POST şu sözbaşylary göterýär: MCP-Protocol-Version, Mcp-Method we tools/call üçin Mcp-Name, hersi göwrä gabat gelmeli. Gabat gelmezlik 400 we JSON-RPC ýalňyşlygy -32020 bolýar; goldanylmaýan wersiýa bolsa 400 bilen -32022 we goldaýan wersiýalarymyzyň sanawyny alýar, şeýdip kliýentiňiz birini saýlap täzeden synanyşyp biler.

Bilkastlaýyn iki ýalňyşlyk görnüşi

Nädogry haýyş ýa-da näbelli gural JSON-RPC ýalňyşlygydyr. “Bu taslama rugsat berilmedik” ýa-da “şeýle sessiýa ýok” adaty netije hökmünde şu baha bilen gaýdýar: isError: true - sebäbi model ikinji görnüşden şu soragy berip: mp_projects täzeden synanyşyp dikeldip biler, birinjisinden bolsa bilmez.

Netijeler şu maglumaty: structuredContent we şol bir maglumatlaryň tekst blogyna geçirilen görnüşini göterýär, şeýdip köne kliýentler hem peýdaly zat görýär.