Microsoft Clarity über MCP: Exportgrenzen, Werkzeugversionen und belastbare Vergleiche

Microsoft Clarity stellt Analysedaten über eine Export-API und über MCP-Werkzeuge für KI-Assistenten bereit. Diese Zugriffswege benötigen eine getrennte Betrachtung. Die bekannten Grenzen von zehn Anfragen, drei Dimensionen und drei Tagen sind ausdrücklich für die Data Export API dokumentiert. Eine Übertragung sämtlicher Grenzen auf jedes aktuelle MCP-Werkzeug wäre durch die verfügbaren Belege nicht gedeckt.

Entscheidend ist der Endpunkt

Der Export-Endpunkt project-live-insights liefert Dashboardkennzahlen. Microsoft dokumentiert höchstens zehn Anfragen je Projekt und Tag, bis zu drei Gruppierungsdimensionen und maximal 1.000 Antwortzeilen ohne Paginierung. Die Werte 1, 2 und 3 für numOfDays bezeichnen die letzten 24, 48 beziehungsweise 72 Stunden ab dem Abruf. Es geht also nicht um eine ungeklärte Auswahl von Kalendertagen. Ergebnisse verwenden UTC.

Das aktuelle offizielle MCP-Repository stellt drei Werkzeuge bereit: query-analytics-dashboard, list-session-recordings und query-documentation-resources. Die geprüfte Implementierung sendet Anfragen an getrennte Endpunkte unter /mcp/. Eine Aufzeichnungssuche und eine Dokumentationsfrage sind deshalb nicht bloß identische Exporte unter anderem Namen.

Was die Dokumentation offenlässt

Die MCP-Seite bei Microsoft Learn wiederholt die Grenzen von zehn Anfragen, drei Tagen und drei Dimensionen. Der offizielle Blogbeitrag vom 18. August 2026 zeigt dagegen Fragen zu sieben und dreißig Tagen; die Antworten sind ausdrücklich als Beispieldaten gekennzeichnet. Weder solche Beispiele noch der Clientquelltext belegen die aktuellen Backendberechtigungen, die Kontingentabrechnung oder den maximalen Rückblick einer konkreten Installation.

Eine belastbare Einrichtung protokolliert installierte MCP-Paketversion, Werkzeugname, tatsächlich angeforderten Zeitraum und Serverantwort. Exportbasierte Integrationen können mit dem veröffentlichten Exportvertrag planen. Bei neueren MCP-Werkzeugen benötigt das jeweilige Verhalten eine Bestätigung; ein Beispielprompt belegt keine erfolgreich ausgeführte Dreißigtageabfrage. Ein fehlendes Limit im Clientcode bedeutet außerdem keinen unbegrenzten Serverzugriff.

Gruppierung ist kein beliebiger Filter

Eine Gruppierung teilt Ergebnisse in Kategorien auf, beispielsweise nach Gerätetyp. Ein Filter beschränkt die Grundgesamtheit, beispielsweise auf Verkehr aus einem Land. Die Exportparameterliste enthält numOfDays und dimension1 bis dimension3. Ein frei formulierbarer Länderfilter als Ersatz für eine vierte Gruppierung ist dort nicht dokumentiert.

URL × Device × Source belegt beispielsweise bereits drei Exportdimensionen. Für Country braucht es eine andere Aufschlüsselung, eine andere unterstützte Schnittstelle oder eine enger gefasste Analysefrage. Nachträgliches Filtern eines dreidimensionalen Ergebnisses erzeugt keine zuvor fehlende Länderdimension. Auch das Zusammenführen getrennter Aggregate rekonstruiert die fehlenden vierdimensionalen Kombinationen nicht zuverlässig.

Aufzeichnungsfilter im MCP sind eine eigene Funktion. Das aktuelle Aufzeichnungswerkzeug definiert Felder wie Land, Gerät und Datumsintervall. Daraus entsteht kein entsprechender Filterparameter am Export-Endpunkt. Filtern nach einer begrenzten Antwort kann außerdem keine bereits vom Server ausgelassenen Zeilen zurückholen.

Auch ein kleines Budget kann einen Bericht tragen

Eine tägliche Momentaufnahme ist eine sinnvolle Nutzung des Exportkontingents. Eine mögliche Aufteilung lautet: ein Abruf für einen gleichbleibenden Beobachtungsbericht, bis zu fünf für gezielte Untersuchungen, zwei für Kontrollen und zwei als Reserve. Diese Zahlen sind ein Planungsbeispiel und keine Microsoft-Empfehlung. Eine Antwort kann mehrere Kennzahlen enthalten; getrennte Abrufe für jede Kennzahl verschwenden möglicherweise Kontingent.

Das Budget gilt für das Projekt einschließlich anderer Exportclients. Eine Chatfrage kann mehrere Aufrufe auslösen; Wiederholungen gehören ebenfalls in die Planung. Ein gemeinsames Aufrufprotokoll und eine feste Obergrenze in der Anwendung sind verlässlicher als die Annahme, jeder Satz verbrauche genau eine Anfrage. Ein erschöpftes Kontingent führt zu HTTP 429; sofortige Wiederholungen schaffen keine zusätzliche Freigabe. HTTP-Fehler oder fehlende Antworten bleiben fehlgeschlagene Beobachtungen und dürfen im Bericht nicht zu null werden.

Momentaufnahmen brauchen einen klaren Zeitbezug

Ein Export mit numOfDays=1 liefert eine rollierende 24-Stunden-Aufnahme. Eine Folge solcher Aufnahmen kann eine Beobachtungsreihe bilden, solange Abrufzeiten und Lücken sichtbar bleiben. Eine fehlende Woche lässt sich dadurch nicht nachträglich abrufen. Eine wöchentliche Dreitageaufnahme umfasst nur diese drei Tage und keine vollständige Woche. Überlappende Dreitageexporte dürfen nicht einfach addiert werden.

Zu jeder gespeicherten Beobachtung gehören Projekt, Endpunkt oder MCP-Werkzeug, Paketversion, tatsächliche Parameter, UTC-Abrufzeit, beabsichtigtes Intervall, Antwortstatus und unveränderte Ergebnisdaten. Hinweise auf Zeilengrenzen und bekannte Lücken gehören unmittelbar zu den Werten. Aggregierte Antworten lassen sich nachträglich nicht in unangeforderte Dimensionen aufteilen.

Derselbe Wochentag kann eine Schwankungsquelle verringern, beseitigt aber weder Feiertage noch Kampagnenwechsel, Messänderungen oder Zufallsschwankungen. Eine feste UTC-Uhrzeit erhält den zeitlichen Stundenabstand; eine feste lokale Uhrzeit kann sich bei der Sommerzeitumstellung gegenüber UTC verschieben. Einheitliche Bezugsgrößen, Kennzahlendefinitionen und vergleichbarer Verkehr sind wichtiger als eine selbstsichere Modellzusammenfassung.

Ergebnisse richtig einordnen

Eine zweite Aufschlüsselung kann bei der Fehlersuche helfen. Übereinstimmende Ansichten derselben Daten sind jedoch keine unabhängige Bestätigung einer Ursache. Kleine Gruppen, fehlende Zeilen und Messänderungen können irreführende Muster erzeugen. Ein brauchbarer Bericht trennt beobachtete Anzahl oder Quote, vermutete Erklärung und nächste Gegenprüfung.

Die Clarity-Oberfläche bleibt für Aufzeichnungen, Heatmaps und historische Untersuchungen nützlich, jeweils innerhalb der Aufbewahrungsregeln der Funktion. MCP ist nicht grundsätzlich ungeeignet für geplante Berichte: Entscheidend sind unterstützte Werkzeuge, reproduzierbare Parameter, Kontingente und Vollständigkeit. API-Token gehören in geschützte Konfigurationen und nicht in Prompts, Bildschirmfotos oder gemeinsame Protokolle.