MCP serveris
Ļaujiet MI aģentam lasīt jūsu analītiku: septiņi rīki ar Model Context Protocol, visi tikai lasīšanai, autentificēti ar API atslēgu, kas jums jau ir.
1. Ko aģents ar to var izdarīt
Norādiet Model Context Protocol klientam galapunktu, un tas var uzdot tādus jautājumus kā „kura lapa šomēnes rada visvairāk dusmu klikšķu“ vai „parādiet trīs sesijas no Vācijas, kas garākas par divām minūtēm“ un pēc tam sniegt saiti sesijas atskaņošanai.
| Rīks | Atbildes |
|---|---|
mp_projects | kurus projektus šī atslēga drīkst lasīt |
mp_overview | sesijas, cilvēki, lapu skatījumi, ilgums, neapmierinātības signāli |
mp_sessions | nesenās sesijas ar atskaņojumu saitēm, atlasītas pēc valsts, ierīces vai ilguma |
mp_session | viena sesija: lapas secībā, notikumi, avots, ierīce |
mp_pages | lapas pēc skatījumiem, ar unikālajiem apmeklētājiem |
mp_frustration | dusmu klikšķi, klikšķi bez reakcijas un JavaScript kļūdas, grupētas pēc lapas |
mp_goals | jūsu mērķi un katra sasniegšanas biežums |
Katrai sesijai, par kuru aģents ziņo, ir saite, ko cilvēks var atvērt. Aģents, kas apkopo redzēto, ir noderīgs; aģents, kas parāda arī divdesmit sekundes, uz kurām balstījies, ir pārbaudāms.
2. Savienošana
Galapunkts pieņem POST adresē /mcp un izmanto Streamable HTTP, protokola versiju 2026-07-28.
Autentifikācijai izmanto parastu MousePlayer lasīšanas API atslēgu — tādu pašu, kādu izveidojat sadaļā Iestatījumi, API atslēgas, un kādu pieņem REST API. Nav otru piekļuves datu. Atslēgas atsaukšana tajā pašā brīdī atsauc aģenta piekļuvi.
Pēc tam ieslēdziet projektu
API atslēga atver visu jūsu darbvietu. Šī apzināti to nedara: katram projektam integrāciju lapā ir savs slēdzis, kas pēc noklusējuma ir izslēgts. Neieslēgts projekts neparādās mp_projects un to nevar nolasīt pat tad, ja aģents uzmin ID.
Tā nav birokrātija. API atslēga izvietošanas skriptā atrodas vienā vietā, ko pārvaldāt; API atslēga aģenta konfigurācijas failā nonāk modeļa kontekstā, un tā ir daudz brīvāka glabāšana. Atbilstošā kontrole ir atļaut pa vienam projektam.
3. Tikai lasīšanai un kāpēc tas nemainīsies
Neviens no septiņiem rīkiem neko neraksta. Aiz šā galapunkta nav dzēšanas, eksporta vai konfigurācijas maiņas — ne tāpēc, ka nepietika laika, bet tāpēc, ka rīks, ko aģents var izsaukt, ir rīks, ko aģents var izsaukt kļūdas pēc.
Ko tas neatgriež
Ne pašus ierakstus, ne DOM momentuzņēmumus, ne IP adreses. Aģents saņem to, ko cilvēks redz saskarnē, un saiti pārējā noskatīšanai.
Biežuma un diapazona ierobežojumi
Sešdesmit pieprasījumi minūtē katrai atslēgai, tāpat kā REST API. Laika diapazons ierobežots līdz 365 dienām un rezultātu saraksts līdz 200 rindām; apgriezta atbilde to norāda, jo klusi apgriezts saraksts izskatās tieši tāpat kā pilnīgs.
4. Tiem, kas veido klientu
Trīs metodes: server/discover, tools/list, tools/call. Nav sesiju, GET plūsmas vai Last-Event-ID — tie pieder protokola versijām līdz 2025-11-25 un nav šīs versijas daļa. GET vai DELETE saņem 405.
Katrs POST ietver MCP-Protocol-Version, Mcp-Method un metodei tools/call arī Mcp-Name, un katram jāatbilst saturam. Neatbilstība ir 400 ar JSON-RPC kļūdu -32020; neatbalstīta versija ir 400 ar -32022 un atbalstīto versiju sarakstu, lai klients varētu izvēlēties vienu un mēģināt vēlreiz.
Apzināti divu veidu kļūdas
Nepareizi veidots pieprasījums vai nezināms rīks ir JSON-RPC kļūda. „Šis projekts nav atļauts“ vai „šādas sesijas nav“ atgriežas kā parasts rezultāts ar isError: true — jo no otrā veida modelis var atgūties, pieprasot mp_projects un mēģinot vēlreiz, bet no pirmā nevar.
Rezultāti ietver gan structuredContent, gan tos pašus datus, kas serializēti teksta blokā, lai arī vecāki klienti redzētu kaut ko noderīgu.
Visas šeit minētās preču zīmes pieder to attiecīgajiem īpašniekiem. MousePlayer nav darījumu attiecību ar šiem nodrošinātājiem.