MCP serveri

1. Agent bununla nə edə bilər

Model Context Protocol müştərisini son nöqtəyə yönəldin; o, “bu ay ən çox qəzəbli klik yaradan səhifə hansıdır” və ya “Almaniyadan iki dəqiqədən uzun üç seans göstər” kimi suallar verə, sonra seansı oynadan keçidi sizə təqdim edə bilər.

Alət	Cavab verdiyi
mp_projects	bu açarın hansı layihələri oxuya biləcəyi
mp_overview	seanslar, insanlar, səhifə baxışları, müddət, narazılıq siqnalları
mp_sessions	ölkə, cihaz və ya uzunluğa görə süzülmüş, təkrar oynatma keçidli son seanslar
mp_session	bir seans: ardıcıl səhifələr, hadisələr, mənbə, cihaz
mp_pages	unikal ziyarətçilərlə baxış sayına görə səhifələr
mp_frustration	səhifəyə görə qruplaşdırılmış qəzəbli kliklər, nəticəsiz kliklər və JavaScript xətaları
mp_goals	hədəfləriniz və hər birinə neçə dəfə çatıldığı

2. Qoşulma

Son nöqtə bu ünvanda POST qəbul edir: /mcp və Streamable HTTP ilə işləyir, protokol versiyası: 2026-07-28.

Autentifikasiya adi MousePlayer oxuma API açarıdır — Parametrlər, API açarları altında yaratdığınız və REST API-nin qəbul etdiyi eyni növ. İkinci giriş məlumatı yoxdur. Açarın ləğvi eyni anda agentin girişini ləğv edir.

Sonra layihəni aktivləşdirin

API açarı bütün iş sahənizi açır. Bu inteqrasiya isə qəsdən belə deyil: hər layihənin inteqrasiyalar səhifəsində öz keçidi var və standart olaraq deaktivdir. Aktiv olmayan layihə bu siyahıda görünmür: mp_projects və agent ID-sini təxmin etsə belə oxuna bilməz.

Bu bürokratiya deyil. Yerləşdirmə skriptindəki API açarı nəzarət etdiyiniz bir yerdə qalır; agentin konfiqurasiya faylındakı açar model kontekstinə daxil olur və bu, daha zəif nəzarətdir. Hər dəfə bir layihəyə icazə vermək uyğun nəzarətdir.

3. Yalnız oxuma və bunun niyə dəyişməyəcəyi

Yeddi alətin heç biri heç nə yazmır. Bu son nöqtənin arxasında silmə, ixrac və konfiqurasiya dəyişikliyi yoxdur — vaxtımız çatmadığı üçün deyil, agentin çağıra bildiyi aləti səhvən də çağıra biləcəyi üçün.

Nə qaytarmır

Qeydlərin özü, DOM anlıq görüntüləri və IP ünvanları yoxdur. Agent insanın interfeysdə gördüklərini və qalanına baxmaq üçün keçidi alır.

Tezlik və aralıq limitləri

Hər açara dəqiqədə altmış sorğu, REST API ilə eyni. Zaman aralığı 365 gün, nəticə siyahısı 200 sətirlə məhdudlaşdırılır; kəsilmiş cavab bunu bildirir, çünki səssiz kəsilmiş siyahı tam siyahı ilə eyni görünür.

4. Müştərini hazırlayanlar üçün

Üç metod: server/discover, tools/list, tools/call. Seanslar, GET axını və bu imkan yoxdur: Last-Event-ID — bunlar 2025-11-25 daxil olmaqla əvvəlki protokol versiyalarına aiddir, bu versiyanın hissəsi deyil. GET və ya DELETE 405 alır.

Hər POST bu başlığı daşıyır: MCP-Protocol-Version, Mcp-Method və bu metod üçün: tools/call, Mcp-Namevə hər biri sorğu mətninə uyğun olmalıdır. Uyğunsuzluq bu nəticəni verir: 400 , JSON-RPC xətası: -32020; dəstəklənməyən versiya bu nəticəni verir: 400 və bu məlumatı: -32022 , həmçinin dəstəklədiyimiz versiyaların siyahısını, beləliklə müştəriniz birini seçib yenidən cəhd edə bilər.

Qəsdən iki növ xəta

Yanlış qurulmuş sorğu və ya naməlum alət JSON-RPC xətasıdır. “Bu layihəyə icazə verilməyib” və ya “belə seans yoxdur” isə bu işarəli adi nəticə kimi qayıdır: isError: true — çünki model ikinci növdən sonra bu sorğunu verərək: mp_projects yenidən cəhd edə bilər, birinci növdə isə bunu edə bilməz.

Nəticələr həm bunu: structuredContent həm də mətn blokunda eyni seriallaşdırılmış məlumatı daşıyır ki, köhnə müştərilər də faydalı məlumat görsün.