Hogyan kérhetem le a Padlet MCP-től az Admin Analytics (Beta) funkciót?

Nem úgy bontja le a számokat az iskolai vagy csapat Admin-irányítópult, ahogyan szeretnéd? Csatlakoztasd a Padlet MCP-t egy AI-asszisztenshez, és kérj iskolai, tantermi vagy csapatstatisztikákat közérthető nyelven – vagy hívd meg közvetlenül a szervezeti analitikai API-t.

Kinek szól?

Ez a cikk a következőknek szól:

• Tulajdonosoknak és adminoknak a Padlet for Schools- vagy Team-fiókokban
• Tulajdonosoknak és tanároknak a Classroom-fiókokban

Az MCP használatához nem kell kódot írnod. Az API használata nem kötelező; azoknak a haladó felhasználóknak szól, akik már használják a Public API-t.

Amivel már rendelkezel

A szervezeted Beállítások oldalán található Analitika rész már most is válogatott lapokon jeleníti meg az aktuális számlázási időszak adatait. Az iskolák és a tantermek esetében ezek az Áttekintés, a Használat, a Hatás, a Biztonság, a Legaktívabb felhasználók és az Összes felhasználó. A csapatoknál az Általános, a Padletek és a Felhasználók lap érhető el.

• Iskolai fiók analitikája (Padlet for Schools és Classroom)
• Csapatfiók analitikája

Használd az irányítópultot, ha gyors, vizuális áttekintésre van szükséged. Az MCP-t vagy az API-t akkor használd, ha egyéni bontást szeretnél, amelyre a lapok nem adnak egyértelmű választ.

Mit nyújt az MCP / API?

Az irányítópult válogatott lapokat kínál. Az MCP-vel és az API-val pontosan a szükséges bontásban kérheted le az adatokat:

• Közérthető kérdések az AI-kliensedben („Mely tanárok voltak inaktívak az előző számlázási időszakban?”)
• Az aktivitási, tagsági és tartalombiztonsági mutatók egyéni kombinációi
• Havi adatsorok egy megadott dátumtartományban
• Szerepkör szerinti bontás (tanárok és diákok, tartalomkészítők és közreműködők)
• A legnépszerűbb padletek, felhasználók és médiatartalmak, az általad kért rangsor szerint
• Válaszok, amelyeket beilleszthetsz egy üzleti felülvizsgálati vagy megújítási prezentációba

Gyors kezdés a Padlet MCP-vel

1. Csatlakoztasd a Padlet MCP-t az AI-kliensedhez. Használd ezt a kiszolgáló-URL-t: https://mcp.padlet.com. A teljes beállítási útmutatót a Padlet MCP Server oldalon találod.
2. Jelentkezz be, és engedélyezd a hozzáférést annak a szervezetnek az adminjaként, amelyről adatokat szeretnél lekérni. Classroom-fiók esetén egy tanár is lekérheti az analitikát.
3. Tedd fel a kérdésedet közérthető nyelven. Nem kell megnevezned a belső eszközöket. Mondd el az AI-asszisztensnek, mit szeretnél tudni az iskoládról, tantermedről vagy csapatodról, és az a nevedben használja a Padlet MCP-t.

Például:

Nem kötelező: szervezeti analitikai API

Inkább saját szkriptet írnál? Használd a Public API-t egy admin API-kulccsal (vagy Classroom esetén tanári kulccsal).

1. Hozz létre vagy másolj ki egy API-kulcsot a Beállítások Fejlesztői oldaláról. Részletekért lásd a Public API című cikket.
2. Keresd meg a szervezeted azonosítóját a GET /me?include=organizations lekérdezéssel. wksp_ kezdetű azonosítóra van szükséged – a padlet.org oldalon található org_ szervezeteket ez a végpont egyelőre nem támogatja.
3. Küldj egy POST-kérést a /organizations/{org_id}/analytics végpontra a kívánt mutatókkal.
4. Ha a válasz 202, vagy a meta.pending nem üres, várd meg a Retry-After értékét, majd küldd el újra ugyanazt a kérést. Az analitika aszinkron módon készül el – a függőben lévő mutató hiányzik a válaszból, nem nulla. A függőben lévő értéket soha ne kezeld nullaként.

Kísérleti hozzáférés

Példakérdések

Ezekkel a mintakérdésekkel kezdhetsz az MCP-kliensedben. A szöveget igazítsd az iskoládhoz, tantermedhez vagy csapatodhoz – és az ügyfeleknek szánt prezentáció összeállításakor ellenőrizd a számokat az Analitika oldalon.

• „Ebben a számlázási időszakban hány aktív tanárunk van az elérhető licencek számához képest, és mely hónapokban csökkent az aktivitás?”
• „Melyik szervezeti padleteknek van a legtöbb megtekintése? Add meg a 3 legnépszerűbb táblát/sandboxot.”
• „Mely tanári szerepkörű tagok nem használták a Padletet az elmúlt 12 hónapban?”
• „Hány olyan tagunk van, akinek az e-mail-címe nem a <ouremaildomain.edu> tartományhoz tartozik?”

Amiben továbbra is jobb az irányítópult

Használd a Beállítások Analitika oldalát, ha a következőkre van szükséged:

• Vizuális Áttekintés fejléc, kiemelt fejlődési lehetőségek és egykattintásos szakmai továbbképzési kérelem
• Az Összes felhasználó / Felhasználók táblázat kereséssel, szerepkör szerinti szűrőkkel és egykattintásos CSV-letöltéssel
• Letölthető lista az adott időszak aktív és inaktív tanárairól az Áttekintés lapról (iskolák és tantermek esetében)
• Olyan nézet, amelyhez nem kell részt venni a kísérleti programban – a Beállítások oldal az API külön engedélyezése nélkül is elérhető a megfelelő szerepkörök számára

Az MCP és az API akkor jeleskedik, ha a válogatott lapok nem adnak választ arra a konkrét kérdésre, amely egy bemutatóhoz vagy megújítási egyeztetéshez szükséges.

Korlátozások:

• Sebességkorlátozás: óránként 60 kérés API-kulcsonként és szervezetenként, beleértve a 202 utáni ismételt lekérdezéseket is
• Dátumtartomány: egy kérés legfeljebb 24 hónapra vonatkozhat
• Tartalombiztonság: csak iskolák és tantermek esetében érhető el – a csapatok 400 hibát kapnak ezekre a mutatókra
• Tagsági létszám: az aktuális tagságot tükrözi, nem azt, hogy korábban kik tartoztak a szervezethez
• A függőben lévő nem egyenlő nullával: a még számítás alatt álló mutató hiányzik a válaszból; ne kezeld nullaként
• Szervezettípus: egyelőre csak wksp_

GYIK

Kapcsolódó cikkek

• Padlet MCP Server
• Iskolai fiók analitikája
• Csapatfiók analitikája
• Public API
• Szervezeti analitika lekérése (fejlesztői dokumentáció)