MCP-сервер

1. Возможности агента

Подключите клиент MCP к эндпоинту; он ответит, какая страница даёт больше яростных кликов за месяц или покажет три сеанса из Германии дольше двух минут, затем даст ссылку воспроизведения.

Инструмент	Ответ
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.

Это не бюрократия. Ключ скрипта развёртывания в одном контролируемом месте; ключ настройки агента попадает в контекст модели с более свободным хранением. Разрешение по проектам соответствует этому риску.

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 и те же данные текстовым блоком для старых клиентов.