Microsoft Clarity przez MCP: limity eksportu, wersje narzędzi i rzetelne porównania

Microsoft Clarity udostępnia dane analityczne przez API eksportu oraz narzędzia MCP dla asystentów AI. Te drogi dostępu wymagają osobnego traktowania. Znane limity dziesięciu zapytań, trzech wymiarów i trzech dni są wyraźnie udokumentowane dla Data Export API. Przeniesienie wszystkich ograniczeń na każde aktualne narzędzie MCP wykraczałoby poza dostępne dowody.

Znaczenie ma punkt końcowy

Punkt końcowy eksportu project-live-insights zwraca wskaźniki panelu. Microsoft dokumentuje maksymalnie dziesięć zapytań na projekt dziennie, do trzech wymiarów grupowania oraz odpowiedź ograniczoną do 1000 wierszy bez stronicowania. Wartości 1, 2 i 3 parametru numOfDays oznaczają ostatnie 24, 48 i 72 godziny liczone od zapytania. Nie chodzi o nieokreślony wybór dni kalendarzowych. Wyniki używają UTC.

Aktualne oficjalne repozytorium MCP udostępnia trzy narzędzia: query-analytics-dashboard, list-session-recordings oraz query-documentation-resources. Sprawdzona implementacja wysyła żądania do osobnych punktów końcowych pod /mcp/. Wyszukiwanie nagrań i pytanie o dokumentację nie są więc identycznymi eksportami pod inną nazwą.

Czego dokumentacja nie rozstrzyga

Strona MCP w Microsoft Learn powtarza limity dziesięciu zapytań, trzech dni i trzech wymiarów. Oficjalny wpis blogowy z 18 sierpnia 2026 pokazuje jednak pytania obejmujące siedem i trzydzieści dni, a odpowiedzi wyraźnie oznacza jako dane przykładowe. Ani takie przykłady, ani kod klienta nie potwierdzają aktualnych uprawnień backendu, sposobu rozliczania limitu lub maksymalnej historii konkretnej instalacji.

Rzetelna konfiguracja zapisuje wersję zainstalowanego pakietu MCP, nazwę narzędzia, rzeczywiście żądany okres i odpowiedź serwera. Integracje oparte na eksporcie mogą korzystać z opublikowanego kontraktu eksportu. Nowsze narzędzia MCP wymagają potwierdzenia własnego działania; przykładowy prompt nie dowodzi pomyślnego zapytania o trzydzieści dni. Brak ograniczenia w kodzie klienta nie oznacza też nieograniczonego dostępu do serwera.

Grupowanie nie jest dowolnym filtrem

Grupowanie dzieli wynik na kategorie, na przykład według typu urządzenia. Filtr ogranicza analizowaną populację, na przykład do ruchu z jednego kraju. Lista parametrów eksportu zawiera numOfDays oraz dimension1 do dimension3. Nie dokumentuje dowolnego filtra kraju zastępującego czwarty wymiar grupowania.

Przekrój URL × Device × Source wykorzystuje już trzy wymiary eksportu. Dodanie Country wymaga innego przekroju, innego obsługiwanego interfejsu albo węższego pytania analitycznego. Filtrowanie gotowego wyniku trójwymiarowego nie tworzy brakującego wymiaru kraju. Łączenie osobnych agregatów również nie odtwarza wiarygodnie brakujących kombinacji czterech wymiarów.

Filtry nagrań w MCP stanowią osobną funkcję. Aktualne narzędzie nagrań definiuje pola takie jak kraj, urządzenie i przedział dat. Ten schemat nie tworzy odpowiedniego parametru w punkcie końcowym eksportu. Filtrowanie ograniczonej odpowiedzi nie odzyska również wierszy pominiętych wcześniej przez serwer.

Mały budżet nadal może obsługiwać raport

Codzienna migawka jest rozsądnym zastosowaniem limitu eksportu. Przykładowy podział to jedno zapytanie na stały widok monitoringu, do pięciu na konkretne analizy, dwa na kontrole i dwa w rezerwie. Te liczby są lokalnym przykładem planowania, a nie zaleceniem Microsoftu. Jedna odpowiedź może zawierać kilka wskaźników, więc osobne wywołanie dla każdego wskaźnika może marnować limit.

Budżet dotyczy projektu, także innych klientów eksportu. Jedno pytanie w czacie może wywołać kilka zapytań; plan powinien uwzględniać również ponowienia. Wspólny rejestr wywołań i stała granica w aplikacji są pewniejsze niż założenie, że jedno zdanie zużywa dokładnie jedno zapytanie. Wyczerpany limit powoduje HTTP 429; natychmiastowe ponawianie nie tworzy dodatkowego przydziału. Błąd HTTP lub brak odpowiedzi powinien pozostać nieudaną obserwacją, a nie zerem w raporcie.

Migawki wymagają jednoznacznego czasu

Eksport z numOfDays=1 dostarcza ruchomą migawkę ostatnich 24 godzin. Kolejne migawki mogą tworzyć serię monitoringu, pod warunkiem widocznych godzin pobrania i luk. Nie pozwalają wstecznie odzyskać brakującego tygodnia. Trzydniowa migawka wykonywana raz w tygodniu obejmuje tylko trzy dni, a nie cały tydzień. Nakładających się eksportów trzydniowych nie należy po prostu sumować.

Każda zapisana obserwacja potrzebuje projektu, punktu końcowego lub narzędzia MCP, wersji pakietu, rzeczywistych parametrów, czasu zapytania w UTC, planowanego przedziału, statusu odpowiedzi i surowych wyników. Ostrzeżenia o limicie wierszy oraz znane luki powinny towarzyszyć wartościom. Odpowiedzi zagregowanych nie da się później rozdzielić według niezamówionych wymiarów.

Ten sam dzień tygodnia może ograniczać jedno źródło zmienności, ale nie usuwa świąt, zmian kampanii, zmian pomiaru ani losowych wahań. Stała godzina UTC zachowuje odstęp w godzinach; stała godzina lokalna może przesunąć się względem UTC przy zmianie czasu. Spójne mianowniki, definicje wskaźników i porównywalny ruch są ważniejsze niż pewne siebie podsumowanie modelu.

Interpretacja wyników

Drugi przekrój może pomóc znaleźć problem. Zgodność dwóch widoków tych samych danych nie stanowi jednak niezależnego potwierdzenia przyczyny. Małe grupy, brakujące wiersze i zmiany pomiaru mogą tworzyć mylące wzorce. Użyteczny raport rozdziela zaobserwowaną liczbę lub odsetek, proponowane wyjaśnienie oraz następną kontrolę.

Interfejs Clarity nadal przydaje się do nagrań, map cieplnych i analiz historycznych, z uwzględnieniem retencji każdej funkcji. MCP nie jest z definicji nieprzydatne do raportów cyklicznych: decydują obsługiwane narzędzia, odtwarzalne parametry, limity i kompletność. Tokeny API należą do chronionej konfiguracji, a nie do promptów, zrzutów ekranu czy wspólnych logów.