Server MCP

1. Yang Dapat Dilakukan Agen

Arahkan klien Model Context Protocol ke endpoint, lalu klien dapat mengajukan pertanyaan seperti “halaman mana yang menghasilkan klik marah terbanyak bulan ini” atau “tampilkan tiga sesi dari Jerman dengan durasi lebih dari dua menit” — lalu memberikan tautan untuk memutar ulang sesi.

Alat	Jawaban
mp_projects	proyek mana yang boleh dibaca kunci ini
mp_overview	sesi, orang, tampilan halaman, durasi, sinyal frustrasi
mp_sessions	sesi terbaru dengan tautan pemutaran ulang, difilter menurut negara, perangkat, atau durasi
mp_session	satu sesi: halaman berurutan, peristiwa, sumber, perangkat
mp_pages	halaman menurut jumlah tampilan, dengan pengunjung unik
mp_frustration	klik marah, klik tanpa respons, dan kesalahan JavaScript dikelompokkan menurut halaman
mp_goals	sasaran Anda dan frekuensi pencapaian masing-masing

2. Menghubungkan

Endpoint menerima POST pada /mcp dan menggunakan Streamable HTTP, versi protokol 2026-07-28.

Autentikasi menggunakan kunci API baca MousePlayer biasa — jenis yang sama dengan yang Anda buat pada Pengaturan, Kunci API, dan yang diterima REST API. Tidak Ada Kredensial Kedua. Mencabut kunci juga mencabut akses agen pada saat yang sama.

Lalu Aktifkan Proyek

Kunci API membuka seluruh ruang kerja Anda. Akses ini sengaja tidak demikian: setiap proyek memiliki sakelar sendiri pada halaman integrasi, yang secara bawaan nonaktif. Proyek yang belum diaktifkan tidak muncul dalam mp_projects dan tidak dapat dibaca meskipun agen menebak ID-nya.

Ini bukan birokrasi. Kunci API dalam skrip deploy berada di satu tempat yang Anda kendalikan; kunci API dalam file konfigurasi agen masuk ke konteks model, dengan kendali penyimpanan yang jauh lebih longgar. Mengizinkan satu proyek pada satu waktu merupakan kendali yang sesuai.

3. Hanya Baca, dan Mengapa Tidak Akan Berubah

Tidak satu pun dari tujuh alat menulis apa pun. Tidak ada penghapusan, ekspor, atau perubahan konfigurasi melalui endpoint ini — bukan karena kami kehabisan waktu, tetapi karena alat yang dapat dipanggil agen juga dapat dipanggil secara keliru.

Yang Tidak Dikembalikan

Tanpa rekaman itu sendiri, snapshot DOM, atau alamat IP. Agen mendapatkan apa yang dilihat seseorang di antarmuka, ditambah tautan untuk menonton sisanya.

Batas Permintaan dan Rentang

Enam puluh permintaan per menit per kunci, sama seperti REST API. Rentang waktu dibatasi hingga 365 hari dan daftar hasil hingga 200 baris; jawaban yang terpotong menyatakannya, karena daftar yang dipotong diam-diam tampak persis seperti daftar lengkap.

4. Untuk Pengembang Klien

Tiga metode: server/discover, tools/list, tools/call. Tanpa sesi, aliran GET, atau Last-Event-ID — semuanya termasuk versi protokol hingga 2025-11-25 dan bukan bagian versi ini. GET atau DELETE menerima 405.

Setiap POST membawa MCP-Protocol-Version, Mcp-Method dan, untuk tools/call, Mcp-Name, dan masing-masing harus cocok dengan isi permintaan. Ketidakcocokan menghasilkan 400 dengan kesalahan JSON-RPC -32020; versi yang tidak didukung menghasilkan 400 dengan -32022 dan daftar versi yang kami dukung, sehingga klien dapat memilih salah satu dan mencoba ulang.

Dua Jenis Kesalahan, Sengaja Dibedakan

Permintaan salah format atau alat yang tidak dikenal merupakan kesalahan JSON-RPC. “Proyek ini tidak diizinkan” atau “sesi tidak ada” dikembalikan sebagai hasil biasa dengan isError: true — karena model dapat mengatasi jenis kedua dengan meminta mp_projects dan mencoba lagi, tetapi tidak dapat mengatasi jenis pertama.

Hasil membawa structuredContent sekaligus data yang sama yang diserialisasikan ke blok teks, sehingga klien lama tetap melihat sesuatu yang berguna.