MCP-Server

1. Was ein Agent damit anfangen kann

Richten Sie einen Client für das Model Context Protocol auf den Endpunkt, und er kann Fragen beantworten wie "welche Seite erzeugt diesen Monat die meisten Wutklicks" oder "zeig mir drei Sitzungen aus Deutschland, die länger als zwei Minuten sind" - und Ihnen anschließend einen Link geben, der die Sitzung abspielt.

Werkzeug	Beantwortet
mp_projects	welche Projekte dieser Schlüssel lesen darf
mp_overview	Sitzungen, Personen, Seitenaufrufe, Dauer, Frustrationssignale
mp_sessions	jüngste Sitzungen mit Wiedergabelink, gefiltert nach Land, Gerät oder Länge
mp_session	eine Sitzung: Seiten der Reihe nach, Ereignisse, Herkunft, Gerät
mp_pages	Seiten nach Aufrufen, mit Zahl der Personen
mp_frustration	Wutklicks, tote Klicks und JavaScript-Fehler, nach Seite gruppiert
mp_goals	Ihre Ziele und wie oft jedes erreicht wurde

2. Anschließen

Der Endpunkt nimmt POST unter /mcp entgegen und spricht Streamable HTTP, Protokollfassung 2026-07-28.

Angemeldet wird sich mit einem gewöhnlichen MousePlayer-Lese-Schlüssel - derselbe, den Sie unter Einstellungen, API-Schlüssel anlegen, und derselbe, den die REST-API nimmt. Eine zweite Zugangskennung gibt es nicht. Den Schlüssel zurückzunehmen nimmt dem Agenten im selben Augenblick den Zugang.

Danach das Projekt einschalten

Ein API-Schlüssel macht Ihren ganzen Workspace auf. Dieser Endpunkt bewusst nicht: jedes Projekt hat auf der Integrationsseite seinen eigenen Schalter, und der steht auf aus. Ein Projekt, das nicht eingeschaltet ist, taucht in mp_projects nicht auf und lässt sich auch dann nicht lesen, wenn der Agent seine Kennung errät.

Das ist keine Bürokratie. Ein API-Schlüssel in einem Deploy-Skript liegt an einer Stelle, die Sie kontrollieren; ein API-Schlüssel in der Konfigurationsdatei eines Agenten speist einen Modellkontext, und das ist eine viel lockerere Verwahrung. Projekt für Projekt freizugeben ist die passende Einschränkung.

3. Nur lesend, und das bleibt so

Keines der sieben Werkzeuge schreibt etwas. Es gibt hinter diesem Endpunkt kein Löschen, keinen Export, keine Änderung an Einstellungen - nicht weil die Zeit fehlte, sondern weil ein Werkzeug, das ein Agent aufrufen kann, auch eines ist, das ein Agent versehentlich aufruft.

Was nicht zurückkommt

Keine Aufzeichnungen selbst, keine DOM-Abbilder, keine IP-Adressen. Der Agent bekommt, was ein Mensch in der Oberfläche sieht, plus den Link, um den Rest anzusehen.

Grenzen für Takt und Zeitraum

Sechzig Anfragen je Minute und Schlüssel, wie bei der REST-API. Ein Zeitraum ist auf 365 Tage gedeckelt, eine Ergebnisliste auf 200 Zeilen; eine gekappte Antwort sagt das, denn eine stillschweigend gekappte Liste sieht genauso aus wie eine vollständige.

4. Für die, die den Client bauen

Drei Methoden: server/discover, tools/list, tools/call. Keine Sitzungen, kein GET-Strom, kein Last-Event-ID - das gehört zu Protokollfassungen bis 2025-11-25 und ist in dieser nicht mehr enthalten. Ein GET oder DELETE bekommt 405.

Jedes POST trägt MCP-Protocol-Version, Mcp-Method und bei tools/call zusätzlich Mcp-Name, und jede dieser Angaben muss zum Rumpf passen. Eine Abweichung ist 400 mit dem JSON-RPC-Fehler -32020; eine nicht unterstützte Fassung ist 400 mit -32022 samt der Liste der Fassungen, die wir sprechen - Ihr Client kann sich also eine aussuchen und es erneut versuchen.

Zwei Arten von Fehler, mit Absicht

Eine kaputte Anfrage oder ein unbekanntes Werkzeug ist ein JSON-RPC-Fehler. "Dieses Projekt ist nicht freigegeben" oder "keine solche Sitzung" kommt als gewöhnliches Ergebnis mit isError: true zurück - denn von der zweiten Art kann sich ein Modell erholen, indem es mp_projects fragt und es erneut versucht, von der ersten nicht.

Ergebnisse tragen sowohl structuredContent als auch dieselben Daten als Textblock, damit auch ältere Clients etwas Brauchbares sehen.