Hoe vraag ik Padlet MCP om beheerderanalyses?

Photo de profil de Carla SeseMis à jour 4 dagen geleden par Carla Sese

Heb je cijfers nodig die het school- of Team-dashboard niet weergeeft op de manier die je wilt? Koppel Padlet MCP aan een AI-assistent en vraag in gewone taal om analyses voor je school, klaslokaal of Team, of roep zelf de API voor organisatieanalyses aan.

Raadpleeg Organisatieanalyses bekijken op docs.padlet.dev voor de volledige REST-referentie (catalogus met statistieken, aanvraagstructuren en foutcodes).

Voor wie is dit bedoeld?

Dit artikel is bedoeld voor:

  • Eigenaren en beheerders van Padlet for Schools- of Team-accounts
  • Eigenaren en docenten van klaslokaalaccounts

Je hoeft geen code te schrijven om de MCP-methode te gebruiken. De API-methode is optioneel voor ervaren gebruikers die al met de Openbare API werken.

Wat je al tot je beschikking hebt

De pagina Analyses van je organisatie in Instellingen toont al samengestelde tabbladen voor de huidige factureringsperiode. Scholen en klaslokalen krijgen Overzicht, Gebruik, Impact, Veiligheid, Topgebruikers en Alle gebruikers. Teams krijgen Algemeen, Padlets en Gebruikers, of Overzicht, Gebruik, Impact, Topgebruikers en Alle gebruikers als je Team de nieuwe analysepagina (bèta) heeft.

Gebruik het dashboard voor een snel visueel overzicht. Gebruik MCP of de API als je een specifieke uitsplitsing nodig hebt die niet goed door de tabbladen wordt beantwoord.

Wat MCP en de API toevoegen

Het dashboard bestaat uit samengestelde tabbladen. Met MCP en de API kun je precies de uitsplitsing opvragen die je nodig hebt:

  • Vragen in gewone taal aan je AI-client ("Welke docenten waren in de vorige factureringsperiode inactief?")
  • Aangepaste combinaties van betrokkenheids-, lidmaatschaps- en inhoudsveiligheidsstatistieken
  • Maandelijkse reeksen over een datumbereik
  • Uitsplitsingen naar rol (docenten versus leerlingen, makers versus bijdragers)
  • Populairste padlets, gebruikers en media, gerangschikt zoals jij vraagt
  • Antwoorden die je in een QBR- of verlengingspresentatie kunt plakken
Statistieken voor inhoudsveiligheid (gescande items, gemarkeerde items, detectiepercentage) zijn alleen beschikbaar voor scholen en klaslokalen. Als je ernaar vraagt voor een Team-organisatie, krijg je een foutmelding en geen nul.

Snel aan de slag met Padlet MCP

  1. Koppel Padlet MCP in je AI-client. Gebruik de server-URL https://mcp.padlet.com. De volledige configuratiestappen vind je in Padlet MCP-server.
  2. Meld je aan en geef toestemming als beheerder van de organisatie die je wilt bevragen. In een klaslokaal kan een docent ook analyses ophalen.
  3. Stel je vraag in gewone taal. Je hoeft geen interne tools te noemen. Vertel de AI-assistent wat je wilt weten over je school, klaslokaal of Team, dan gebruikt die Padlet MCP namens jou.

Hier is een voorbeeld:

Als een bepaalde MCP-client nog geen antwoorden over analyses geeft, probeer dan een andere MCP-compatibele client of gebruik de API voor organisatieanalyses. Ondersteuning door clients kan achterlopen op de server.
Je assistent handelt namens jou. Die kan alleen analyses ophalen die je aangemelde account mag bekijken.

Optioneel: API voor organisatieanalyses

Wil je liever zelf scripts schrijven? Gebruik dan de Openbare API met een API-sleutel van een beheerder (of een docentsleutel voor een klaslokaal).

  1. Maak een API-sleutel aan of kopieer er een vanaf de pagina Ontwikkelaar in Instellingen. Meer informatie vind je in het artikel over de Openbare API.
  2. Zoek de organisatie-ID op met GET /me?include=organizations. Je hebt een ID nodig die begint met wksp_. Organisaties met een org_-ID op padlet.org worden voor dit eindpunt nog niet ondersteund.
  3. Verstuur een POST-aanvraag naar /organizations/{org_id}/analytics met de gewenste statistieken.
  4. Als het antwoord 202 is of meta.pending niet leeg is, wacht je de opgegeven tijd in Retry-After af en verstuur je exact dezelfde aanvraag opnieuw. Analyses worden op de achtergrond berekend, dus een statistiek die nog wordt verwerkt, ontbreekt in het antwoord. Behandel die nooit als nul.
De volledige aanvraagstructuren, de catalogus met statistieken en uitgewerkte voorbeelden vind je in Organisatieanalyses bekijken.

Wie kan dit gebruiken?

Organisatieanalyses via Padlet MCP en de API zijn beschikbaar voor eigenaren en beheerders van Padlet for Schools- en Team-accounts, en voor eigenaren en docenten van klaslokaalaccounts. Je hoeft Padlet niet te vragen om deze functie in te schakelen.

Voorlopig worden alleen organisaties met een ID die begint met wksp_ ondersteund.

Voorbeeldvragen

Je kunt deze voorbeeldvragen rechtstreeks in je MCP-client plakken. Pas de formulering aan je school, klaslokaal of Team aan en vergelijk de cijfers met de pagina Analyses wanneer je een presentatie voor klanten voorbereidt.

  • "Hoeveel actieve docenten hadden we deze factureringsperiode op onze school, vergeleken met het aantal licenties, en in welke maanden daalden de cijfers?"
  • "Welke padlets binnen onze organisatie hebben de meeste weergaven? Geef me de drie populairste borden/sandbox."
  • "Welke leden met de rol docent hebben Padlet de afgelopen 12 maanden niet gebruikt?"
  • "Hoeveel leden hebben geen e-maildomein <ouremaildomain.edu>?"
Vraag om de uitsplitsing die je nodig hebt: een maandelijkse reeks, een filter op rol, de populairste padlets op basis van berichten of bezoekers, of totalen voor inhoudsveiligheid van een school of klaslokaal. De assistent koppelt je vraag aan de beschikbare statistieken.

Waarvoor het dashboard nog steeds beter is

Gebruik de pagina Analyses in Instellingen als je het volgende nodig hebt:

  • De visuele banner Overzicht, uitgelichte kansen en de mogelijkheid om met één klik een PD-aanvraag in te dienen
  • De tabel Alle gebruikers/Gebruikers met zoeken, filters op rol en de mogelijkheid om met één klik een CSV-bestand te downloaden
  • Downloadbare lijsten met actieve en inactieve docenten voor de geselecteerde periode, op het tabblad Overzicht (scholen en klaslokalen)

MCP en de API zijn handig wanneer de samengestelde tabbladen niet precies de vraag beantwoorden die je voor een demo of verlengingsgesprek hebt.

Beperkingen:

  • Verzoeklimiet: 60 aanvragen per uur per API-sleutel en organisatie, inclusief controles na een 202
  • Datumbereik: maximaal 24 maanden per aanvraag
  • Inhoudsveiligheid: alleen voor scholen en klaslokalen. Teams krijgen een 400-fout voor deze statistieken
  • Leden tellen: weerspiegelt de huidige ledenlijst, niet een historische momentopname van wie er op dat moment bij hoorde
  • In behandeling ≠ nul: een statistiek die nog wordt berekend, ontbreekt in het antwoord; behandel die niet als nul
  • Organisatietype: voorlopig alleen wksp_

Veelgestelde vragen

Waarom krijg ik een 404 als ik om analyses vraag?

Alle afwijzingen zien er hetzelfde uit: zowel een onbekende organisatie als ontbrekende toegang geeft een 404. Controleer of je bent aangemeld als beheerder (of als docent in een klaslokaal) van die organisatie en of de organisatie een ID heeft die begint met wksp_. Kom je er nog steeds niet uit? Neem contact op met de supportafdeling.

Moet ik code schrijven?

Nee. Koppel Padlet MCP, meld je aan als beheerder en stel je vraag in gewone taal. De API-methode is optioneel voor ontwikkelaars en ervaren gebruikers die de Openbare API al gebruiken.

Is dit hetzelfde als de Openbare API?

Ze zijn verwant, maar bieden niet dezelfde mogelijkheden. De Openbare API is bedoeld voor ontwikkelaars die een API-sleutel gebruiken. Padlet MCP is bedoeld voor AI-assistenten waarvoor je toestemming geeft door in te loggen. Beide bieden toegang tot organisatieanalyses en je kunt ze allebei of afzonderlijk gebruiken.

Kunnen leerlingen of niet-beheerders op deze manier organisatieanalyses bekijken?

Nee. Voor analyses heb je de rol van beheerder van de organisatie nodig, of de rol van docent in een klaslokaal. De assistent heeft precies dezelfde toegang als het account waarmee je bent aangemeld, niet meer.

Mijn MCP-client lijkt niets te weten over analyses. Wat kan ik proberen?

Sommige clients werken hun lijst met tools met vertraging bij. Probeer Padlet MCP opnieuw te koppelen, over te schakelen naar een andere MCP-compatibele client of rechtstreeks de API voor organisatieanalyses te gebruiken. Kom je er nog steeds niet uit? Neem contact met ons op.

Gerelateerd

Cet article vous a-t-il été utile ?

Articles connexes