Hogyan kérhetem le a Padlet MCP-től az Admin Analytics adatokat?
由 Carla Sese 於 4 nappal ezelőtt 更新Szükséged van olyan adatokra, amelyeket az iskola vagy a csapat adminisztrációs irányítópultja nem bont le a kívánt módon? Csatlakoztasd a Padlet MCP-t egy mesterséges intelligencia-asszisztenshez, és egyszerű nyelven kérj iskolai, osztálytermi vagy csapatelemzéseket, vagy hívd meg magad a szervezeti elemzési API-t.
Kiknek szól ez a cikk
Ez a cikk a következő felhasználóknak szól:
- A Padlet for Schools vagy Team fiókok tulajdonosai és rendszergazdái
- A Classroom-fiókok tulajdonosai és tanárai
Az MCP-útvonal használatához nem szükséges kódot írni. Az API-útvonal opcionális azoknak a haladó felhasználóknak, akik már dolgoznak a nyilvános API-val.
Ami már rendelkezésre áll
A szervezet Beállítások menüpontjában található Elemzések oldalon már megjelennek a jelenlegi számlázási időszakra vonatkozó, válogatott lapok. Az iskolák és osztálytermek esetében az Áttekintés, Használat, Hatás, Biztonság, Legaktívabb felhasználók és Minden felhasználó lapok jelennek meg. A csapatok esetében az Általános, Padletek és Felhasználók lapok jelennek meg, vagy az Áttekintés, Használat, Hatás, Legaktívabb felhasználók és Minden felhasználó lapok, ha a csapat rendelkezik az új Elemzések oldallal (béta).
- Iskolai fiók elemzése (Padlet for Schools és Classroom)
- Csapatfiók-elemzés
Használja a műszerfalat, ha gyors vizuális áttekintésre van szüksége. Használja az MCP-t vagy az API-t, ha olyan egyedi adatokra van szüksége, amelyekre a fülek nem adnak egyértelmű választ.
Mit nyújt az MCP / API
A műszerfal válogatott lapokból áll. Az MCP és az API segítségével pontosan azt a szeletet kérheted, amire szükséged van:
- Egyszerű nyelvű kérdések az AI-kliensben („melyik tanárok voltak inaktívak az elmúlt számlázási időszakban?”)
- Az elkötelezettség, a tagság és a tartalombiztonsági mutatók egyedi kombinációi
- Havi sorozatok egy adott dátumtartományon belül
- Szerepkörök szerinti szeletek (tanárok vs. diákok, alkotók vs. közreműködők)
- A legnépszerűbb padletek, felhasználók és médiaelemek az Ön által megadott rangsor szerint
- Válaszok, amelyeket beilleszthet egy negyedéves eredménybeszámolóba (QBR) vagy megújítási prezentációba
Gyors kezdés a Padlet MCP-vel
- Csatlakoztassa a Padlet MCP-t az AI-klienséhez. Használja a szerver URL-jét
https://mcp.padlet.com. A teljes beállítási útmutató a Padlet MCP Server oldalon található. - Jelentkezzen be, és engedélyezze a lekérdezni kívánt szervezet rendszergazdájaként. Osztálytermi környezetben a tanár is lekérheti az elemzéseket.
- Kérdezzen egyszerű nyelven. Nem kell megneveznie a belső eszközöket. Mondja el az AI-asszisztensnek, mit szeretne tudni az iskolájáról, osztályáról vagy csapatáról, és az Ön nevében a Padlet MCP-t fogja használni.
Íme egy példa:

Opcionális: szervezeti elemzési API
Inkább saját magad írnál szkriptet? Használd a nyilvános API-t egy rendszergazdai API-kulccsal (vagy a Classroom esetében egy tanári kulccsal).
- Hozzon létre vagy másoljon egy API-kulcsot a Beállítások fejlesztői oldaláról. A részleteket a nyilvános API-ról szóló cikk tartalmazza.
- A szervezet azonosítóját a
GET /me?include=organizations. Szüksége lesz egywksp_azonosítóra van szüksége.org_A padlet.org oldalon található szervezeteket ez a végpont egyelőre nem támogatja. - Küldjön egy
POSTa/organizations/{org_id}/analyticsa kívánt mutatókkal. - Ha a válasz
202vagymeta.pendingnem üres, várjonRetry-Afterés küldje el újra ugyanazt a kérést. Az elemzések a háttérben kerülnek kiszámításra, ezért a függőben lévő mutatók nem szerepelnek a válaszban. Soha ne tekintse azokat nullának.
Ki használhatja
Jelenleg csak
wksp_ szervezeteket támogatja.Példák a parancsokra
Ezek olyan kiindulási pontok, amelyeket beilleszthet az MCP-kliensébe. Igazítsa a szöveget az iskolájához, osztályához vagy csapatához, és ellenőrizze a számokat az Analytics oldalon, amikor ügyfeleknek szánt prezentációt készít.
- „Iskolánkban ebben a számlázási időszakban hány aktív tanár volt a licencszámhoz képest, és mely hónapokban csökkent a szám?”
- „Mely szervezeti Padlet-oldalaknak van a legtöbb megtekintése? Mutassa meg a legnépszerűbb 3 táblát/sandboxot!”
- „Melyik tanári szerepkörrel rendelkező tagok nem használták a Padletet az elmúlt 12 hónapban?”
- „Hány tag e-mail-címének domainje nem <ouremaildomain.edu>?”
Miben jobb még mindig a műszerfal?
Maradjon a Beállítások menü Analytics oldalán, ha szeretné:
- A vizuális Áttekintés sáv, a Legfontosabb lehetőségek kiemelések és az egy kattintással elindítható PD-kérés
- Az „Összes felhasználó” / „Felhasználók” táblázat keresési és szerepkör-szűrőkkel, valamint egy kattintással letölthető CSV-fájllal
- A kiválasztott időszakra vonatkozó aktív és inaktív tanárok letölthető listái az Áttekintés fülről (iskolák és osztálytermek)
Az MCP és az API akkor jönnek igazán jól, ha a szerkesztett lapok nem adnak pontos választ arra a kérdésre, amire egy bemutató vagy megújítási tárgyalás során szükséged van.
Korlátozások:
- Kéréskorlát: óránként 60 kérés API-kulcs és szervezetenként, beleértve a
202 - Időtartomány: legfeljebb 24 hónap egy kérésben
- Tartalombiztonság: csak iskolák és tantermek. A Teams
400az említett mutatókhoz - Tagsági számok: a jelenlegi névjegyzéket tükrözik, nem pedig egy korábbi pillanatfelvételt arról, hogy ki tartozott hozzá abban az időpontban
- Függőben ≠ nulla: a válaszból hiányzik egy még feldolgozás alatt álló mutató; ne tekintsük nullának
- Szervezet típusa:
wksp_jelenleg csak
GYIK
Miért kapok 404-es hibát, amikor elemzéseket kérek?
Minden elutasítás ugyanúgy néz ki: ismeretlen szervezet vagy nincs hozzáférés – mindkettő ezt a hibát eredményezi 404. Ellenőrizze, hogy bejelentkezett-e az adott szervezet rendszergazdájaként (vagy tanárként a Classroom szolgáltatásban), és hogy az egy wksp_ szervezetről van szó. Még mindig nem sikerült? Fordulj az ügyfélszolgálathoz.
Kell kódot írnom?
Nem. Csatlakozz a Padlet MCP-hez, jelentkezz be rendszergazdaként, és egyszerű nyelven fogalmazd meg a kérésedet. Az API-útvonal opcionális azoknak a fejlesztőknek és haladó felhasználóknak, akik már használják a nyilvános API-t.
Ez ugyanaz, mint a nyilvános API?
Kapcsolódik hozzá, de nem ugyanaz a termékfelület. A nyilvános API az API-kulcsot használó fejlesztőknek szól. A Padlet MCP azoknak az AI-asszisztenseknek szól, akiket bejelentkezéssel engedélyez. Mindkettő hozzáfér a szervezeti elemzésekhez, és használhatja bármelyiket vagy mindkettőt.
A diákok vagy a nem rendszergazdák is láthatják így a szervezeti elemzéseket?
Nem. Az elemzésekhez a szervezet rendszergazdájára vagy egy Classroom-tanárra van szükség. Az asszisztens pontosan ugyanolyan hozzáféréssel rendelkezik, mint az a fiók, amellyel bejelentkezett, semmi többel.
Úgy tűnik, az MCP-kliensem nem ismeri az elemzéseket. Mit tegyek?
Egyes kliensek késleltetve frissítik az eszközlistájukat. Próbáld meg újra csatlakoztatni a Padlet MCP-t, válts át egy másik MCP-kompatibilis kliensre, vagy használd közvetlenül a szervezeti elemzési API-t. Ha továbbra is problémád van, lépj kapcsolatba velünk.
Kapcsolódó
- Padlet MCP-kiszolgáló
- Iskolai fiók elemzései
- Csapatfiók-elemzés
- Nyilvános API
- Szervezeti elemzések olvasása (fejlesztői dokumentáció)
