Сервер 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 у скрипті розгортання перебуває в одному контрольованому вами місці; ключ 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, і ті самі дані, серіалізовані в текстовий блок, щоб старі клієнти теж бачили щось корисне.