Server MCP

1. Ingkang saged dipuntindakaken agen

Arahaken klien Model Context Protocol dhateng endpoint lan saged nyuwun kados “kaca pundi paling kathah klik nesu ing wulan punika” utawi “tedahaken tigang sesi saking Jerman langkung dangu saking kalih menit” — lajeng maringi pranala kanggé mirsani sesi.

Piranti	Wangsulan
mp_projects	proyek ingkang pareng dipunwaos kunci punika
mp_overview	sesi, tiyang, tampilan kaca, durasi, sinyal frustrasi
mp_sessions	sesi énggal kanthi pranala rekaman, dipunsaring miturut nagara, piranti utawi durasi
mp_session	satunggal sesi: kaca manut urutan, prastawa, sumber, piranti
mp_pages	kaca miturut tampilan, kanthi pengunjung unik
mp_frustration	klik nesu, klik tanpa tanggapan lan kesalahan JavaScript dipungolongaken miturut kaca
mp_goals	tujuan panjenengan lan kaping pinten dipungayuh

2. Nyambungaken

Endpoint nampi POST ing /mcp lan migunakaken Streamable HTTP, versi protokol 2026-07-28.

Otentikasi migunakaken kunci API maos MousePlayer biasa — jinis ingkang sami kaliyan ingkang dipundamel ing Setelan, Kunci API, lan ingkang dipuntampi REST API. Boten wonten kredensial kaping kalih. Nyabut kunci ugi nyabut akses agen ing wekdal ingkang sami.

Lajeng aktifaken proyek

Kunci API mbikak sedaya ruang kerja. Punika sengaja boten: saben proyek nggadhahi saklar piyambak ing kaca integrasi, lan gawanipun mati. Proyek ingkang boten aktif boten medal ing mp_projects lan boten saged dipunwaos sanajan agen saged ngira ID.

Punika sanès birokrasi. Kunci API ing skrip deploy wonten ing satunggal papan ingkang panjenengan kendhaleni; kunci API ing berkas konfigurasi agen mlebet konteks model, lan pangreksanipun langkung longgar. Ngidinaken satunggal proyek saben wekdal punika kontrol ingkang cocog.

3. Namung maos, lan sebab boten badhé owah

Boten wonten saking pitu piranti ingkang nyerat. Tanpa pambusakan, ekspor utawi owah-owahan konfigurasi ing endpoint punika — sanès amargi kekirangan wekdal, nanging amargi piranti ingkang saged dipunseluk agen ugi saged dipunseluk kanthi klentu.

Ingkang boten dipunasilaken

Tanpa rekaman piyambak, gambar DOM utawi alamat IP. Agen pikantuk ingkang dipunpirsani tiyang ing antarmuka, kaliyan pranala kanggé mirsani sanèsipun.

Wates laju lan rentang

Sewidak panyuwunan saben menit saben kunci, sami kaliyan REST API. Rentang wekdal dipunwatesi 365 dinten lan dhaptar asil 200 larik; wangsulan ingkang dipunpotong nerangaken, amargi dhaptar ingkang dipunpotong tanpa kabar katon persis kados dhaptar pepak.

4. Kanggé pangembang klien

Tigang metode: server/discover, tools/list, tools/call. Tanpa sesi, tanpa aliran GET, tanpa Last-Event-ID — punika kagungan versi protokol ngantos 2025-11-25 lan sanès pérangan versi punika. GET utawi DELETE nampi 405.

Saben POST nggawa MCP-Protocol-Version, Mcp-Method lan, kanggé tools/call, Mcp-Name, lan saben kedah cocog kaliyan isi. Menawi boten cocog punika 400 kanthi kesalahan JSON-RPC -32020; versi ingkang boten dipundhukung punika 400 kanthi -32022 lan dhaptar versi ingkang dipundhukung, supados klien saged milih lan nyobi malih.

Kalih jinis kesalahan, kanthi sengaja

Panyuwunan kanthi wujud salah utawi piranti ingkang boten dipunmangertosi punika kesalahan JSON-RPC. “Proyek punika dereng dipunidinaken” utawi “sesi boten wonten” wangsul minangka asil biasa kanthi isError: true — amargi model saged pulih saking jinis kaping kalih kanthi nyuwun mp_projects lan nyobi malih, nanging boten saged pulih saking ingkang kapisan.

Asil nggawa kekalih structuredContent lan data ingkang sami dipunserialisasi ing blok teks, supados klien lawas tetep pikantuk katrangan migunani.