MCP-сервер

1. Што може да направи агент со ова

Насочете клиент за Model Context Protocol кон крајната точка и ќе може да поставува прашања како „која страница создава најмногу кликови од фрустрација овој месец“ или „покажи ми три сесии од Германија подолги од две минути“ - а потоа да ви даде врска што ја репродуцира сесијата.

Алатка	Одговара
mp_projects	кои проекти смее да ги чита овој клуч
mp_overview	сесии, лица, прегледи на страници, времетраење, сигнали за фрустрација
mp_sessions	неодамнешни сесии со врски до репродукции, филтрирани по земја, уред или должина
mp_session	една сесија: страници по ред, настани, извор, уред
mp_pages	страници според прегледи, со единствени посетители
mp_frustration	кликови од фрустрација, кликови без реакција и грешки во JavaScript групирани по страница
mp_goals	вашите цели и колку често е постигната секоја

2. Поврзување

Крајната точка прима POST на /mcp и користи Streamable HTTP, верзија на протокол 2026-07-28.

Автентикацијата е со обичен API-клуч на MousePlayer за читање - истиот вид што го создавате во Поставки, API-клучеви и истиот што го прифаќа REST API. Нема втор акредитив. Отповикувањето на клучот во истиот момент го одзема пристапот на агентот.

Потоа вклучете го проектот

API-клуч отвора цел работен простор. Овој намерно не го прави тоа: секој проект има сопствен прекинувач на страницата со интеграции и е стандардно исклучен. Проект што не е вклучен не се појавува во mp_projects и не може да се чита дури и ако агентот го погоди неговиот ID.

Тоа не е бирократија. API-клуч во скрипта за поставување е на едно место што го контролирате; API-клуч во конфигурациска датотека на агент влегува во контекст на модел, а тоа е многу полабав вид чување. Одобрување еден проект во даден момент е соодветната контрола.

3. Само за читање и зошто тоа нема да се промени

Ниту една од седумте алатки не запишува ништо. Зад оваа крајна точка нема бришење, извоз или промена на конфигурација - не затоа што немавме време, туку бидејќи алатка што агент може да ја повика е алатка што може да ја повика по грешка.

Што не враќа

Нема самите снимки, моментални DOM-снимки или IP-адреси. Агентот го добива она што човек го гледа во интерфејсот, плус врската за гледање на останатото.

Ограничувања на стапката и опсегот

Шеесет барања во минута по клуч, исто како REST API. Временскиот опсег е ограничен на 365 дена, а списокот со резултати на 200 редови; скратениот одговор го наведува тоа бидејќи незабележливо скратен список изгледа исто како целосен.

4. За оние што го градат клиентот

Три методи: server/discover, tools/list, tools/call. Нема сесии, GET-тек или Last-Event-ID - тие припаѓаат на верзиите на протоколот до 2025-11-25 и не се дел од оваа. GET или DELETE добива 405.

Секој POST содржи MCP-Protocol-Version, Mcp-Method и за tools/call, Mcp-Nameи секое мора да се совпаѓа со телото. Несовпаѓање е 400 со JSON-RPC-грешка -32020; неподдржана верзија е 400 со -32022 и списокот на верзии што ги поддржуваме, за клиентот да може да избере една и да се обиде повторно.

Два вида грешки, намерно

Неправилно составено барање или непозната алатка е JSON-RPC-грешка. „Овој проект не е одобрен“ или „нема таква сесија“ се враќа како нормален резултат со isError: true - бидејќи моделот може да се опорави од вториот вид со прашување на mp_projects и повторен обид, но не може од првиот.

Резултатите содржат и structuredContent и истите податоци серијализирани во текстуален блок, за и постарите клиенти да гледаат нешто корисно.