Serveri MCP

1. Çfarë mund të bëjë një agjent me këtë

Drejtojeni një klient Model Context Protocol te pika fundore dhe mund të pyesë „cila faqe prodhon më shumë klikime zemërimi këtë muaj“ ose „më trego tri seanca nga Gjermania më të gjata se dy minuta“ - dhe pastaj t'ju japë një lidhje që riprodhon seancën.

Mjeti	Përgjigjet
mp_projects	cilat projekte mund të lexojë ky çelës
mp_overview	seanca, njerëz, shikime faqesh, kohëzgjatje, sinjale frustrimi
mp_sessions	seanca të fundit me lidhje riprodhimi, të filtruara sipas shtetit, pajisjes ose gjatësisë
mp_session	një seancë: faqet me radhë, ngjarjet, burimi, pajisja
mp_pages	faqet sipas shikimeve, me vizitorë unikë
mp_frustration	klikime zemërimi, klikime pa reagim dhe gabime JavaScript të grupuara sipas faqes
mp_goals	objektivat tuaja dhe sa shpesh u arrit secili

2. Lidhja

Pika fundore pranon POST në /mcp dhe përdor Streamable HTTP, versioni i protokollit 2026-07-28.

Autentikimi është një çelës normal MousePlayer API për lexim - i njëjti lloj që krijoni te Cilësimet, Çelësat API dhe i njëjti që pranon REST API. Nuk ka kredencial të dytë. Revokimi i çelësit revokon hyrjen e agjentit në të njëjtin çast.

Pastaj aktivizoni projektin

Një çelës API hap gjithë hapësirën tuaj të punës. Ky qëllimisht jo: çdo projekt ka çelësin e vet të aktivizimit në faqen e integrimeve dhe është joaktiv si parazgjedhje. Një projekt që nuk është aktivizuar nuk shfaqet në mp_projects dhe nuk mund të lexohet edhe nëse agjenti e gjen ID-në e tij me hamendësim.

Kjo nuk është burokraci. Një çelës API në një skript vendosjeje ndodhet në një vend që kontrolloni; një çelës API në skedarin e konfigurimit të agjentit ushqen kontekstin e modelit dhe kjo është mbajtje nën kontroll shumë më e lirshme. Lejimi i një projekti çdo herë është kontrolli i përshtatshëm.

3. Vetëm lexim dhe pse kjo nuk do të ndryshojë

Asnjë nga shtatë mjetet nuk shkruan gjë. Pas kësaj pike fundore nuk ka fshirje, eksport ose ndryshim konfigurimi - jo sepse na mbaroi koha, por sepse një mjet që agjenti mund ta thërrasë është mjet që mund ta thërrasë gabimisht.

Çfarë nuk kthen

As vetë regjistrimet, as pamje DOM të ruajtura, as adresa IP. Agjenti merr atë që sheh personi në ndërfaqe, plus lidhjen për të parë pjesën tjetër.

Kufijtë e ritmit dhe intervalit

Gjashtëdhjetë kërkesa në minutë për çelës, njësoj si REST API. Intervali kohor kufizohet në 365 ditë dhe lista e rezultateve në 200 rreshta; përgjigjja e shkurtuar e thotë këtë, sepse një listë e shkurtuar në heshtje duket pikërisht si e plotë.

4. Për ata që ndërtojnë klientin

Tri metoda: server/discover, tools/list, tools/call. Pa seanca, pa rrjedhë GET, pa Last-Event-ID - ato u përkasin versioneve të protokollit deri në 2025-11-25 dhe nuk janë pjesë e këtij. Një GET ose DELETE merr 405.

Çdo POST mbart MCP-Protocol-Version, Mcp-Method dhe, për tools/call, Mcp-Name, dhe secila duhet të përputhet me trupin. Një mospërputhje është 400 me gabim JSON-RPC -32020; një version i pambështetur është 400 me -32022 dhe listën e versioneve që mbështesim, që klienti juaj të zgjedhë një dhe të riprovojë.

Dy lloje gabimesh, qëllimisht

Një kërkesë e keqformuar ose mjet i panjohur është gabim JSON-RPC. „Ky projekt nuk është lejuar“ ose „nuk ka seancë të tillë“ kthehet si rezultat normal me isError: true - sepse një model mund ta zgjidhë llojin e dytë duke pyetur mp_projects dhe riprovuar, ndërsa nuk mund ta zgjidhë të parin.

Rezultatet mbartin edhe structuredContent dhe të njëjtat të dhëna të serializuara në bllok teksti, që klientët më të vjetër të shohin ende diçka të dobishme.