Ako požiadam Padlet MCP o analytiku správcu?
由 Carla Sese 於 pred 4 dňami 更新Chýbajú vám v Admin Dashboarde školy alebo tímu čísla rozčlenené tak, ako potrebujete? Prepojte Padlet MCP s asistentom AI a požiadajte ho bežným jazykom o analytické údaje školy, triedy alebo tímu, prípadne sami zavolajte rozhranie API na analytické údaje organizácie.
Pre koho je tento článok určený
Tento článok je určený pre:
- Vlastníkov a správcov účtov Padlet for Schools alebo tímových účtov
- Vlastníkov a učiteľov účtov Triedy
Na používanie MCP nemusíte písať kód. Rozhranie API je voliteľné pre pokročilých používateľov, ktorí už pracujú s verejným rozhraním API.
Čo už máte k dispozícii
Stránka Analytika vašej organizácie v Nastaveniach už zobrazuje pripravené karty za aktuálne fakturačné obdobie. Školy a triedy majú karty Prehľad, Používanie, Vplyv, Bezpečnosť, Najaktívnejší používatelia a Všetci používatelia. Tímy majú karty Všeobecné, Padlety a Používatelia alebo Prehľad, Používanie, Vplyv, Najaktívnejší používatelia a Všetci používatelia, ak má váš tím novú stránku Analytika (beta).
- Analytika školského účtu (Padlet for Schools a Trieda)
- Analytika tímového účtu
Ak chcete rýchly vizuálny prehľad, použite tabuľu. Ak potrebujete vlastné rozčlenenie, na ktoré karty neodpovedajú dostatočne presne, použite MCP alebo rozhranie API.
Čo prináša MCP / rozhranie API
Tabuľa obsahuje pripravené karty. MCP a rozhranie API vám umožňujú vyžiadať si presne také rozčlenenie, aké potrebujete:
- Otázky v bežnom jazyku v klientovi AI („Ktorí učitelia boli v minulom fakturačnom období neaktívni?“)
- Vlastné kombinácie metrík zapojenia, členstva a bezpečnosti obsahu
- Mesačné časové rady za zvolené obdobie
- Rozdelenie podľa roly (učitelia a študenti, tvorcovia a prispievatelia)
- Najobľúbenejšie padlety, používatelia a médiá zoradené podľa vašich požiadaviek
- Odpovede, ktoré môžete vložiť do prezentácie na štvrťročné hodnotenie podnikania (QBR) alebo obnovenie
Rýchly začiatok s Padlet MCP
- Pripojte Padlet MCP vo svojom klientovi AI. Použite URL servera
https://mcp.padlet.com. Úplný postup nastavenia nájdete v článku Server Padlet MCP. - Prihláste sa a udeľte oprávnenie ako správca organizácie, ktorej údaje chcete vyhľadávať. V Triede môže analytické údaje získavať aj učiteľ.
- Pýtajte sa bežným jazykom. Nemusíte uvádzať názvy interných nástrojov. Povedzte asistentovi AI, čo chcete vedieť o svojej škole, triede alebo tíme, a on vo vašom mene použije Padlet MCP.
Tu je príklad:

Voliteľné: rozhranie API na analytické údaje organizácie
Chcete si vytvoriť vlastný skript? Použite verejné rozhranie API s kľúčom API správcu (alebo kľúčom učiteľa v Triede).
- Vytvorte alebo skopírujte kľúč API na stránke Developer v Nastaveniach. Podrobnosti nájdete v článku Verejné rozhranie API.
- Zistite ID organizácie pomocou
GET /me?include=organizations. Potrebujete IDwksp_. Organizácieorg_na padlet.org zatiaľ toto rozhranie nepodporuje. - Odošlite požiadavku
POSTna adresu/organizations/{org_id}/analyticss požadovanými metrikami. - Ak je odpoveď
202alebo polemeta.pendingnie je prázdne, počkajte na hodnotuRetry-Aftera odošlite totožnú požiadavku znova. Analytické údaje sa vypočítavajú na pozadí, takže čakajúca metrika v odpovedi chýba. Nikdy ju nepovažujte za nulu.
Kto to môže používať
Zatiaľ sú podporované iba organizácie s ID
wksp_.Príklady výziev
Tieto príklady môžete skopírovať do klienta MCP. Upravte znenie podľa svojej školy, triedy alebo tímu a pred prípravou prezentácie pre zákazníkov porovnajte čísla so stránkou Analytika.
- „Koľko aktívnych učiteľov máme v škole v tomto fakturačnom období v porovnaní s počtom licencií a v ktorých mesiacoch došlo k poklesu?“
- „Ktoré padlety v organizácii majú najviac zobrazení? Uveď tri najlepšie nástenky/sandbox.“
- „Ktorí členovia s rolou učiteľa nepoužili Padlet za posledných 12 mesiacov?“
- „Koľko členov nemá e-mailovú doménu <ouremaildomain.edu>?“
V čom je tabuľa stále lepšia
Ak potrebujete, použite stránku Analytika v Nastaveniach:
- Vizuálny banner Prehľad, upozornenia na najlepšie príležitosti a možnosť požiadať o profesionálny rozvoj jedným kliknutím
- Tabuľku Všetci používatelia / Používatelia s vyhľadávaním, filtrami podľa roly a stiahnutím súboru CSV jedným kliknutím
- Zoznamy aktívnych a neaktívnych učiteľov za vybrané obdobie na stiahnutie, dostupné na karte Prehľad (školy a triedy)
MCP a rozhranie API sa hodia vtedy, keď pripravené karty neposkytujú presnú odpoveď, ktorú potrebujete na ukážku alebo rokovanie o obnovení.
Obmedzenia:
- Limit požiadaviek: 60 požiadaviek za hodinu na jeden kľúč API a organizáciu vrátane opakovaných kontrol po odpovedi
202 - Dátumové obdobie: najviac 24 mesiacov v jednej požiadavke
- Bezpečnosť obsahu: iba pre školy a triedy. Pre tieto metriky sa tímom vráti chyba
400 - Počty členov: odrážajú aktuálny zoznam členov, nie historický prehľad členstva v danom čase
- Čakajúca metrika ≠ nula: metrika, ktorá sa ešte počíta, v odpovedi chýba; nepovažujte ju za nulu
- Typ organizácie: zatiaľ iba
wksp_
Časté otázky
Prečo sa mi pri žiadosti o analytické údaje zobrazuje chyba 404?
Všetky odmietnutia vyzerajú rovnako: pri neznámej organizácii aj pri chýbajúcom prístupe sa vracia chyba 404. Skontrolujte, či ste sa prihlásili ako správca (alebo učiteľ v Triede) danej organizácie a či má ID wksp_. Stále si neviete rady? Kontaktujte podporu.
Musím písať kód?
Nie. Pripojte Padlet MCP, prihláste sa ako správca a pýtajte sa bežným jazykom. Rozhranie API je voliteľné pre vývojárov a pokročilých používateľov, ktorí už používajú verejné rozhranie API.
Je to to isté ako verejné rozhranie API?
Súvisí s ním, ale nejde o to isté rozhranie produktu. Verejné rozhranie API je určené vývojárom, ktorí používajú kľúč API. Padlet MCP je určený asistentom AI, ktorým udelíte oprávnenie po prihlásení. Obe umožňujú prístup k analytickým údajom organizácie a môžete používať jedno z nich alebo obe.
Môžu si takto zobraziť analytické údaje organizácie študenti alebo používatelia bez práv správcu?
Nie. Na prístup k analytickým údajom je potrebné byť správcom organizácie alebo učiteľom v Triede. Asistent má presne rovnaké oprávnenia ako konto, ktorým ste sa prihlásili, a nič navyše.
Zdá sa, že môj klient MCP o analytike nevie. Čo mám skúsiť?
Niektorí klienti aktualizujú zoznam nástrojov s oneskorením. Skúste znova pripojiť Padlet MCP, prejsť na iného klienta kompatibilného s MCP alebo použiť priamo rozhranie API na analytické údaje organizácie. Ak si stále neviete rady, ozvite sa nám.
