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 и не може да бъде прочетен, дори агентът да познае идентификатора му.

Това не е бюрокрация. Ключ за 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, така и същите данни, сериализирани в текстов блок, за да виждат и по-старите клиенти нещо полезно.