Jak poprosić Padlet MCP o analitykę administratora?
Carla Sese tarafından 4 dni temu güncellendiPotrzebujesz liczb, których nie da się uzyskać w odpowiednim przekroju w panelu administratora szkoły lub zespołu? Połącz Padlet MCP z asystentem AI i zadawaj prostym językiem pytania o analitykę szkoły, klasy lub zespołu albo samodzielnie wywołuj API analityki organizacji.
Dla kogo jest ten artykuł
Ten artykuł jest przeznaczony dla:
- właścicieli i administratorów kont Padlet for Schools lub Team
- właścicieli i nauczycieli kont Classroom
Do korzystania z MCP nie musisz pisać kodu. Korzystanie z API jest opcjonalne i przeznaczone dla zaawansowanych użytkowników, którzy już korzystają z Public API.
Co już masz
Na stronie Analityka organizacji w Ustawieniach znajdziesz gotowe karty z danymi za bieżący okres rozliczeniowy. W szkołach i klasach dostępne są karty Przegląd, Użycie, Wpływ, Bezpieczeństwo, Najaktywniejsi użytkownicy i Wszyscy użytkownicy. Zespoły mają karty Ogólne, Padlety i Użytkownicy albo Przegląd, Użycie, Wpływ, Najaktywniejsi użytkownicy i Wszyscy użytkownicy, jeśli Twój zespół korzysta z nowej strony Analityka (beta).
- Analityka konta szkolnego (Padlet for Schools i Classroom)
- Analityka konta zespołu
Skorzystaj z panelu, jeśli chcesz szybko uzyskać wizualny podgląd danych. Użyj MCP lub API, jeśli potrzebujesz przekroju, którego nie da się łatwo uzyskać na kartach.
Co oferują MCP i API
Panel zawiera gotowe karty. MCP i API pozwalają uzyskać dokładnie taki przekrój, jakiego potrzebujesz:
- Pytania zadawane prostym językiem w kliencie AI („którzy nauczyciele byli nieaktywni w poprzednim okresie rozliczeniowym?”)
- Niestandardowe zestawienia wskaźników zaangażowania, członkostwa i bezpieczeństwa treści
- Miesięczne zestawienia z wybranego zakresu dat
- Zestawienia według ról (nauczyciele i uczniowie, twórcy i współtwórcy)
- Najpopularniejsze padlety, użytkownicy i materiały uporządkowane według wskazanych kryteriów
- Odpowiedzi, które możesz wkleić do prezentacji na QBR lub dotyczącej odnowienia umowy
Szybki start z Padlet MCP
- Połącz Padlet MCP ze swoim klientem AI. Użyj adresu URL serwera
https://mcp.padlet.com. Pełną instrukcję konfiguracji znajdziesz w artykule Serwer Padlet MCP. - Zaloguj się i autoryzuj jako administrator organizacji, której dane chcesz sprawdzić. W Classroom analitykę może też pobierać nauczyciel.
- Zadawaj pytania prostym językiem. Nie musisz podawać nazw narzędzi wewnętrznych. 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: API analityki organizacji
Wolisz samodzielnie napisać skrypt? Skorzystaj z Public API, używając klucza API administratora (lub klucza nauczyciela w Classroom).
- Utwórz lub skopiuj klucz API ze strony Developer w Ustawieniach. Szczegóły znajdziesz w artykule Public API.
- Znajdź identyfikator organizacji za pomocą
GET /me?include=organizations. Szukaj identyfikatorawksp_. Organizacjeorg_w domenie padlet.org nie są jeszcze obsługiwane w przypadku tego punktu końcowego. - Wyślij żądanie
POSTdo/organizations/{org_id}/analytics, podając interesujące Cię wskaźniki. - Jeśli odpowiedź ma kod
202lub polemeta.pendingnie jest puste, poczekaj przez czas określony w nagłówkuRetry-Afteri ponownie wyślij identyczne żądanie. Dane analityczne są obliczane w tle, więc oczekującego wskaźnika nie będzie w odpowiedzi. Nigdy nie traktuj go jako zera.
Kto może korzystać z tej funkcji
Na razie obsługiwane są tylko organizacje z identyfikatorem
wksp_.Przykładowe polecenia
Możesz skopiować te przykładowe polecenia do klienta MCP. Dostosuj ich treść do swojej szkoły, klasy lub zespołu, a przygotowując prezentację dla klienta, porównaj liczby ze stroną 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 nastąpił spadek?”
- „Które padlety w naszej organizacji mają najwięcej wyświetleń? Podaj 3 najpopularniejsze tablice/sandboxy.”
- „Którzy członkowie z rolą nauczyciela nie korzystali z Padlet 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
Korzystaj ze strony Analityka w Ustawieniach, jeśli potrzebujesz:
- Wizualnego banera Przegląd, informacji o największych szansach i możliwości wysłania prośby o PD jednym kliknięciem
- Tabeli Wszyscy użytkownicy / Użytkownicy z wyszukiwaniem, filtrami ról i możliwością pobrania pliku CSV jednym kliknięciem
- List aktywnych i nieaktywnych nauczycieli za wybrany okres do pobrania z karty Przegląd (szkoły i klasy)
MCP i API sprawdzają się najlepiej, gdy gotowe karty nie odpowiadają dokładnie na pytanie potrzebne do prezentacji lub rozmowy o odnowieniu umowy.
Ograniczenia:
- Limit liczby żądań: 60 żądań na godzinę dla jednego klucza API i organizacji, wliczając ponowne sprawdzenia po odpowiedzi
202 - Zakres dat: maksymalnie 24 miesiące w jednym żądaniu
- Bezpieczeństwo treści: tylko szkoły i klasy. W przypadku zespołów te wskaźniki zwrócą błąd
400 - Liczba członków: odzwierciedla aktualny skład, a nie historyczny stan członkostwa w danym okresie
- Oczekujące ≠ zero: wskaźnik, którego obliczanie wciąż trwa, nie pojawi się w odpowiedzi; nie traktuj go jako zera
- Typ organizacji: na razie tylko
wksp_
Najczęściej zadawane pytania
Dlaczego podczas próby pobrania danych analitycznych pojawia się błąd 404?
Wszystkie odmowy wyglądają tak samo: nieznana organizacja i brak dostępu zwracają kod 404. Sprawdź, czy logujesz się jako administrator tej organizacji (lub nauczyciel w Classroom) oraz czy jej identyfikator zaczyna się od wksp_. Nadal masz problem? Skontaktuj się z pomocą techniczną.
Czy muszę pisać kod?
Nie. Połącz Padlet MCP, zaloguj się jako administrator i zadawaj pytania prostym językiem. Korzystanie z API jest opcjonalne i przeznaczone dla programistów oraz zaawansowanych użytkowników, którzy już korzystają z Public API.
Czy to to samo co Public API?
Te rozwiązania są powiązane, ale nie są tym samym. Public API jest przeznaczone dla programistów korzystających z klucza API. Padlet MCP jest przeznaczone dla asystentów AI, którym udzielasz dostępu po zalogowaniu. Oba rozwiązania umożliwiają pobieranie danych analitycznych organizacji, więc możesz korzystać z jednego lub obu.
Czy uczniowie lub osoby niebędące administratorami mogą w ten sposób zobaczyć dane analityczne organizacji?
Nie. Do uzyskania dostępu do danych analitycznych wymagane są uprawnienia administratora organizacji lub nauczyciela w Classroom. Asystent ma dokładnie taki sam dostęp jak konto, na które się logujesz — nic więcej.
Klient MCP nie rozpoznaje analityki. Co mogę zrobić?
Niektóre klienty aktualizują listę narzędzi z opóźnieniem. Spróbuj ponownie połączyć Padlet MCP, przełączyć się na innego klienta zgodnego z MCP lub bezpośrednio skorzystać z API analityki organizacji. Jeśli problem nadal występuje, skontaktuj się z nami.
Powiązane artykuły
- Serwer Padlet MCP
- Analityka konta szkolnego
- Analityka konta zespołu
- Public API
- Odczytywanie danych analitycznych organizacji (dokumentacja dla programistów)
