Сервер 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.

Гэта не бюракратыя. Ключ у скрыпце разгортвання жыве ў кантраляваным месцы; ключ у канфігурацыі агента сілкуе кантэкст мадэлі і кантралюецца слабей. Асобны дазвол праекта адпавядае гэтай рызыцы.

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 , і тыя ж даныя ў тэкставым блоку, каб старыя кліенты таксама бачылі карыснае.