MCP-Server

1. Wat en Agent domat maache kann

Verbannt e Model-Context-Protocol-Client mam Endpunkt, an e ka Froe stellen ewéi „Wéi eng Säit produzéiert dëse Mount déi meeschte Roserei-Klicken?“ oder „Weis mir dräi Sessiounen aus Däitschland, déi méi laang ewéi zwou Minutte sinn“ — an Iech duerno e Link ginn, deen d'Sessioun ofspillt.

Instrument	Äntwert
mp_projects	wéi eng Projeten dëse Schlëssel liesen däerf
mp_overview	Sessiounen, Persounen, Säitenusiichten, Dauer, Frustratiounssignaler
mp_sessions	rezent Sessioune mat Ofspill-Linken, no Land, Apparat oder Längt gefiltert
mp_session	eng Sessioun: Säiten an hirer Reiefolleg, Eventer, Quell, Apparat
mp_pages	Säiten no Usiichten, mat eenzegaartege Visiteuren
mp_frustration	Roserei-Klicken, Klicken ouni Reaktioun a JavaScript-Feeler, no Säit gruppéiert
mp_goals	Är Ziler a wéi dacks all eenzelt erreecht gouf

2. Verbannen

Den Endpunkt hëlt POST op /mcp un a benotzt Streamable HTTP, Protokollversioun 2026-07-28.

D'Authentifikatioun ass en normale MousePlayer-Lies-API-Schlëssel — déiselwecht Zort, déi Dir ënner Astellungen, API-Schlësselen erstellt an déi d'REST-API akzeptéiert. Et gëtt keng zweet Zougrëffsdonnéeën. De Schlëssel zréckzezéien, hëlt am selwechte Moment dem Agent säin Zougrëff ewech.

Dann de Projet aschalten

En API-Schlëssel mécht Äre ganzen Aarbechtsberäich op. Dës Verbindung mécht dat bewosst net: All Projet huet säin eegene Schalter op der Integratiounssäit, an e steet standardméisseg op aus. E Projet, deen net ageschalt ass, erschéngt net an mp_projects a kann net gelies ginn, och wann den Agent seng ID réit.

Dat ass keng Bürokratie. En API-Schlëssel an engem Deploy-Skript läit op enger Plaz, déi Dir kontrolléiert; en API-Schlëssel an der Konfiguratiounsdatei vun engem Agent fléisst an e Modellkontext, an dat ass eng vill méi locker Form vu Verwahrung. Eenzel Projeten noeneen ze fräiginn, ass déi passend Kontroll.

3. Nëmme Liesen, a firwat dat esou bleift

Kee vun de siwen Instrumenter schreift eppes. Et gëtt kee Läschen, keen Export a keng Konfiguratiounsännerung hannert dësem Endpunkt — net wéinst Zäitmangel, mee well en Instrument, dat en Agent opruffe kann, och aus Versi opgeruff ka ginn.

Wat net zeréckginn gëtt

Keng Opname selwer, keng DOM-Ofbiller, keng IP-Adressen. Den Agent kritt dat, wat eng Persoun an der Uewerfläch gesäit, plus de Link, fir de Rescht ze kucken.

Ufro- a Beräichsgrenzen

Siechzeg Ufroe pro Minutt a Schlëssel, d'selwecht ewéi bei der REST-API. En Zäitraum ass op 365 Deeg an eng Resultatlëscht op 200 Zeile begrenzt; eng gekierzt Äntwert seet dat, well eng onbemierkt gekierzt Lëscht genee wéi eng komplett ausgesäit.

4. Fir d'Leit, déi de Client bauen

Dräi Methoden: server/discover, tools/list, tools/call. Keng Sessiounen, kee GET-Stroum, keen Last-Event-ID — déi gehéieren zu Protokollversioune bis 2025-11-25 a sinn net Deel vun dëser. E GET oder DELETE kritt 405.

All POST enthält MCP-Protocol-Version, Mcp-Method an, fir tools/call, Mcp-Name, an all eenzelt muss mam Inhalt iwwereneestëmmen. Eng Ofwäichung ass 400 mam JSON-RPC-Feeler -32020; eng net ënnerstëtzt Versioun ass 400 mat -32022 an der Lëscht vun de Versiounen, déi mir ënnerstëtzen, soudatt Äre Client eng wiele kann an et nei probéiert.

Bewosst zwou Zorte Feeler

Eng falsch formatéiert Ufro oder en onbekannt Instrument ass e JSON-RPC-Feeler. „Dëse Projet ass net fräiginn“ oder „Dës Sessioun gëtt et net“ kënnt als normaalt Resultat mat isError: true zeréck — well e Modell sech vum zweete Fall erhuele kann, andeems en mp_projects ofreet an et nach eng Kéier probéiert, vum éischten awer net.

Resultater enthalen esouwuel structuredContent ewéi déiselwecht Donnéeën an engem Textblock serialiséiert, soudatt eeler Clienten ëmmer nach eppes Nëtzleches gesinn.