MCP sunucusu

1. Bir ajan bununla neler yapabilir?

Bir Model Context Protocol istemcisini uç noktaya yönlendirdiğinizde “bu ay en fazla öfke tıklamasına hangi sayfa yol açıyor?” veya “Almanya'dan iki dakikadan uzun üç oturum göster” gibi sorular sorabilir; ardından size oturumu yeniden oynatan bir bağlantı verebilir.

Araç	Verdiği yanıt
mp_projects	bu anahtarın hangi projeleri okuyabileceği
mp_overview	oturumlar, kişiler, sayfa görüntülemeleri, süre, hayal kırıklığı sinyalleri
mp_sessions	ülke, cihaz veya süreye göre filtrelenmiş, yeniden oynatma bağlantılı son oturumlar
mp_session	tek oturum: sıralı sayfalar, olaylar, kaynak, cihaz
mp_pages	görüntülemeye göre sayfalar ve tekil ziyaretçiler
mp_frustration	sayfaya göre gruplandırılmış öfke tıklamaları, tepkisiz tıklamalar ve JavaScript hataları
mp_goals	hedefleriniz ve her birine ne sıklıkla ulaşıldığı

2. Bağlanma

Uç nokta şu adreste POST kabul eder: /mcp ; Streamable HTTP ve şu protokol sürümünü kullanır: 2026-07-28.

Kimlik doğrulama, normal bir MousePlayer okuma API anahtarıyla yapılır. Ayarlar, API anahtarları altında oluşturduğunuz ve REST API'nin kabul ettiği anahtarla aynı türdedir. İkinci bir erişim bilgisi yoktur. Anahtarı iptal etmek, ajanın erişimini de aynı anda iptal eder.

Ardından projeyi açın

Bir API anahtarı tüm çalışma alanınızı açar. Bu uç nokta özellikle bunu yapmaz: her projenin entegrasyonlar sayfasında kendi açma-kapama ayarı vardır ve varsayılan olarak kapalıdır. Açılmamış bir proje şu listede görünmez: mp_projects ; ajan kimliğini tahmin etse bile okunamaz.

Bu bürokrasi değildir. Dağıtım betiğindeki API anahtarı, kontrol ettiğiniz tek bir yerde bulunur. Ajanın yapılandırma dosyasındaki API anahtarı ise bir model bağlamını besler ve bu çok daha gevşek bir muhafaza biçimidir. Projeleri tek tek erişime açmak buna uygun kontroldür.

3. Salt okunur; neden bu değişmeyecek?

Yedi aracın hiçbiri bir şey yazmaz. Bu uç noktada silme, dışa aktarma veya yapılandırma değişikliği yoktur. Zamanımız yetmediği için değil; ajanın çağırabileceği bir araç, yanlışlıkla da çağırabileceği bir araç olduğu için.

Neleri döndürmez?

Kayıtların kendisini, DOM anlık görüntülerini veya IP adreslerini döndürmez. Ajan, kişinin arayüzde gördüklerini ve gerisini izlemek için bağlantıyı alır.

İstek ve aralık sınırları

REST API ile aynı: anahtar başına dakikada altmış istek. Zaman aralığı 365 günle, sonuç listesi 200 satırla sınırlıdır. Kısaltılan yanıt bunu belirtir; çünkü sessizce kısaltılmış bir liste, tam bir listeyle aynı görünür.

4. İstemciyi geliştirenler için

Üç yöntem: server/discover, tools/list, tools/call. Oturum yok, GET akışı yok; şu başlık da yok: Last-Event-ID . Bunlar 2025-11-25'e kadarki protokol sürümlerine aittir; bu sürümün parçası değildir. GET veya DELETE isteği 405 alır.

Her POST şu başlıkları taşır: MCP-Protocol-Version, Mcp-Method ve şu yöntem için: tools/call, Mcp-Name; her biri gövdeyle eşleşmelidir. Uyumsuzluk şu yanıtı verir: 400 ; JSON-RPC hatası: -32020. Desteklenmeyen sürüm şu yanıtı verir: 400 ; JSON-RPC hata kodu: -32022 ve desteklediğimiz sürümlerin listesi gelir. Böylece istemciniz birini seçip yeniden deneyebilir.

Özellikle iki hata türü

Hatalı biçimli bir istek veya bilinmeyen araç, JSON-RPC hatasıdır. “Bu proje erişime açılmamış” veya “böyle bir oturum yok” ise şu alanı içeren normal bir sonuç olarak döner: isError: true . Model ikinci tür hatayı mp_projects sorgusunu yapıp yeniden deneyerek giderebilir; ilkini gideremez.

Sonuçlar hem şu alanı: structuredContent hem de aynı verinin bir metin bloğuna serileştirilmiş halini taşır; böylece eski istemciler de yararlı bir şey görür.