Jak poprosić Padlet MCP o dostęp do analityki administratora (beta)?

Potrzebujesz liczb, których nie da się uzyskać w odpowiednim układzie w panelu administratora szkoły lub zespołu? Połącz Padlet MCP z asystentem AI i poproś o analizy szkoły, klasy lub zespołu, używając zwykłego języka — albo samodzielnie wywołaj interfejs API do analizy organizacji.

Dla kogo jest ten artykuł

Ten artykuł jest przeznaczony dla:

• Właścicieli i administratorów kont Padlet dla szkół lub zespołów
• Właścicieli i nauczycieli kont klasowych

Nie musisz umieć programować, aby korzystać z MCP. Ścieżka API jest opcjonalna dla zaawansowanych użytkowników, którzy już korzystają z Publicznego API.

Co już masz

Strona Analityka organizacji w Ustawieniach zawiera gotowe karty z danymi za bieżący okres rozliczeniowy. Szkoły i klasy mają karty Przegląd, Wykorzystanie, Wpływ, Bezpieczeństwo, Najaktywniejsi użytkownicy i Wszyscy użytkownicy. Zespoły mają karty Ogólne, Padlety i Użytkownicy albo Przegląd, Wykorzystanie, Wpływ, Najaktywniejsi użytkownicy i Wszyscy użytkownicy, jeśli Twój zespół ma nową stronę Analityki (beta).

• Analityka konta szkoły (Padlet dla szkół i klasy)
• Analityka konta zespołu

Skorzystaj z panelu, jeśli chcesz szybko uzyskać wizualny przegląd danych. Użyj MCP lub API, gdy potrzebujesz własnego zestawienia, którego nie da się łatwo uzyskać za pomocą kart.

Co oferuje MCP / API

Panel zawiera gotowe karty. MCP i API pozwalają uzyskać dokładnie takie zestawienie, jakiego potrzebujesz:

• Pytania zadawane zwykłym językiem w kliencie AI („Którzy nauczyciele byli nieaktywni w poprzednim okresie rozliczeniowym?”)
• Własne zestawienia wskaźników zaangażowania, członkostwa i bezpieczeństwa treści
• Miesięczne dane za wybrany zakres dat
• Zestawienia według ról (nauczyciele i uczniowie, twórcy i współtwórcy)
• Najpopularniejsze padlety, użytkownicy i multimedia — z rankingiem według wskazanych kryteriów
• Odpowiedzi, które możesz wkleić do prezentacji na przegląd kwartalny lub spotkanie dotyczące odnowienia umowy

Szybki start z Padlet MCP

1. Połącz Padlet MCP w swoim kliencie AI. Użyj adresu URL serwera https://mcp.padlet.com. Pełną instrukcję konfiguracji znajdziesz w artykule Serwer Padlet MCP.
2. Zaloguj się i autoryzuj dostęp jako administrator organizacji, której dane chcesz sprawdzić. W klasie dane analityczne może również pobierać nauczyciel.
3. Zadawaj pytania zwykłym językiem. Nie musisz podawać nazw wewnętrznych narzędzi. Powiedz asystentowi AI, czego chcesz się dowiedzieć o swojej szkole, klasie lub zespole, a on użyje Padlet MCP w Twoim imieniu.

Oto przykład:

Opcjonalnie: interfejs API do analizy organizacji

Wolisz napisać własny skrypt? Użyj Publicznego API i klucza API administratora (lub klucza nauczyciela w klasie).

1. Utwórz lub skopiuj klucz API na stronie Deweloper w Ustawieniach. Szczegóły znajdziesz w artykule Publiczne API.
2. Odszukaj identyfikator organizacji za pomocą GET /me?include=organizations. Potrzebujesz identyfikatora wksp_ — organizacje org_ w domenie padlet.org nie są jeszcze obsługiwane przez ten punkt końcowy.
3. Wyślij żądanie POST na adres /organizations/{org_id}/analytics, podając wymagane wskaźniki.
4. Jeśli odpowiedź ma kod 202 lub pole meta.pending nie jest puste, poczekaj przez czas określony w Retry-After i ponownie wyślij identyczne żądanie. Dane analityczne są obliczane asynchronicznie — brak oczekującego wskaźnika w odpowiedzi nie oznacza zera. Nigdy nie traktuj oczekujących danych jak zera.

Dostęp pilotażowy

Przykładowe polecenia

Możesz skopiować poniższe przykłady do klienta MCP. Dostosuj sformułowania do swojej szkoły, klasy lub zespołu — a przed przygotowaniem prezentacji dla klienta sprawdź liczby na stronie Analityka.

• „Ilu nauczycieli w naszej szkole było aktywnych w tym okresie rozliczeniowym w porównaniu z liczbą licencji i w których miesiącach odnotowano spadek?”
• „Które padlety w naszej organizacji mają najwięcej wyświetleń? Podaj 3 najpopularniejsze tablice/sandbox.”
• „Którzy członkowie z rolą nauczyciela nie korzystali z Padletu w ciągu ostatnich 12 miesięcy?”
• „Ilu członków nie ma adresu e-mail w domenie <ouremaildomain.edu>?”

Co nadal lepiej sprawdza się w panelu

Skorzystaj ze strony Analityka w Ustawieniach, jeśli potrzebujesz:

• Wizualnego banera Przegląd, podpowiedzi dotyczących najważniejszych możliwości i prośby o szkolenie PD dostępnej jednym kliknięciem
• Tabeli Wszyscy użytkownicy / Użytkownicy z wyszukiwaniem, filtrami ról i pobieraniem pliku CSV jednym kliknięciem
• List aktywnych i nieaktywnych nauczycieli za wybrany okres, które można pobrać z karty Przegląd (szkoły i klasy)
• Widoku, który nie wymaga zapisu do programu pilotażowego — strona Ustawienia jest dostępna dla uprawnionych ról bez włączania dostępu do API

MCP i API najlepiej sprawdzają się wtedy, gdy gotowe karty nie odpowiadają dokładnie na pytanie potrzebne do prezentacji lub rozmowy o odnowieniu umowy.

Ograniczenia:

• Limit żądań: 60 żądań na godzinę na klucz API i organizację, w tym ponowne żądania po odpowiedzi 202
• Zakres dat: maksymalnie 24 miesiące w jednym żądaniu
• Bezpieczeństwo treści: tylko szkoły i klasy — żądanie tych wskaźników dla zespołów zwróci błąd 400
• Liczba członków: odzwierciedla aktualny skład, a nie historyczny stan członkostwa
• Dane oczekujące ≠ zero: wskaźnik, którego obliczanie nadal trwa, nie pojawi się w odpowiedzi; nie traktuj go jak zera
• Typ organizacji: na razie tylko wksp_

FAQ

Powiązane artykuły

• Serwer Padlet MCP
• Analityka konta szkoły
• Analityka konta zespołu
• Publiczne API
• Odczyt danych analitycznych organizacji (dokumentacja dla deweloperów)