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.

Аутентификация — кәдімгі MousePlayer оқу API кілті. «Баптаулар», «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 және сол деректердің мәтін блогына серияланған нұсқасы да бар, сондықтан ескі клиенттер де пайдалы нәрсе көреді.