Pelayan MCP

1. Perkara yang boleh dilakukan ejen

Halakan klien Model Context Protocol ke titik akhir dan ia boleh bertanya seperti “halaman manakah menghasilkan klik akibat geram terbanyak bulan ini” atau “tunjukkan tiga sesi dari Jerman yang lebih lama daripada dua minit” - kemudian memberikan pautan yang memainkan semula sesi.

Alat	Menjawab
mp_projects	projek yang boleh dibaca kunci ini
mp_overview	sesi, orang, paparan halaman, tempoh, isyarat kekecewaan
mp_sessions	sesi terkini dengan pautan main semula, ditapis mengikut negara, peranti atau panjang
mp_session	satu sesi: halaman mengikut susunan, peristiwa, sumber, peranti
mp_pages	halaman mengikut paparan, dengan pelawat unik
mp_frustration	klik akibat geram, klik tanpa respons dan ralat JavaScript dikumpulkan mengikut halaman
mp_goals	matlamat anda dan kekerapan setiap satu tercapai

2. Menyambung

Titik akhir menerima POST di /mcp dan menggunakan Streamable HTTP, versi protokol 2026-07-28.

Pengesahan menggunakan kunci API baca MousePlayer biasa - jenis sama yang anda cipta di Tetapan, Kunci API, dan jenis sama yang diterima REST API. Tiada kelayakan kedua. Membatalkan kunci membatalkan akses ejen pada saat yang sama.

Kemudian aktifkan projek

Kunci API membuka seluruh ruang kerja anda. Laluan ini sengaja tidak: setiap projek mempunyai suis sendiri pada halaman integrasi, dan dinyahaktifkan secara lalai. Projek yang tidak diaktifkan tidak muncul dalam mp_projects dan tidak boleh dibaca walaupun ejen meneka IDnya.

Itu bukan birokrasi. Kunci API dalam skrip pemasangan berada di satu tempat yang anda kawal; kunci API dalam fail konfigurasi ejen memasuki konteks model, dan itu bentuk penjagaan yang jauh lebih longgar. Membenarkan satu projek pada satu-satu masa ialah kawalan yang sepadan.

3. Baca sahaja, dan sebabnya tidak akan berubah

Tiada satu pun daripada tujuh alat menulis apa-apa. Tiada pemadaman, eksport atau perubahan konfigurasi di sebalik titik akhir ini - bukan kerana kami kesuntukan masa, tetapi kerana alat yang boleh dipanggil ejen juga boleh dipanggilnya secara tersilap.

Perkara yang tidak dikembalikan

Tiada rakaman itu sendiri, petikan DOM atau alamat IP. Ejen mendapat perkara yang dilihat seseorang dalam antara muka, serta pautan untuk menonton selebihnya.

Had kadar dan julat

Enam puluh permintaan seminit bagi setiap kunci, sama seperti REST API. Julat masa dihadkan kepada 365 hari dan senarai hasil kepada 200 baris; jawapan yang dipendekkan menyatakannya, kerana senarai yang dipendekkan secara senyap kelihatan tepat seperti senarai lengkap.

4. Untuk pembina klien

Tiga kaedah: server/discover, tools/list, tools/call. Tiada sesi, aliran GET atau Last-Event-ID - semua itu milik versi protokol hingga 2025-11-25 dan bukan sebahagian versi ini. GET atau DELETE menerima 405.

Setiap POST membawa MCP-Protocol-Version, Mcp-Method dan, untuk tools/call, Mcp-Name, dan setiap satu mesti sepadan dengan badan. Ketidakpadanan ialah 400 dengan ralat JSON-RPC -32020; versi tidak disokong ialah 400 dengan -32022 dan senarai versi yang kami sokong, supaya klien anda boleh memilih satu dan mencuba semula.

Dua jenis ralat, disengajakan

Permintaan salah bentuk atau alat tidak diketahui ialah ralat JSON-RPC. “Projek ini tidak dibenarkan” atau “tiada sesi sedemikian” kembali sebagai hasil biasa dengan isError: true - kerana model boleh pulih daripada jenis kedua dengan meminta mp_projects dan mencuba semula, tetapi tidak boleh pulih daripada yang pertama.

Hasil membawa kedua-dua structuredContent dan data sama yang disirikan ke dalam blok teks, supaya klien lama masih melihat sesuatu yang berguna.