Wie frage ich Padlet MCP nach Admin-Analysen?

Carla Sese의 프로필 사진Carla Sese님이 vor 4 Tagen에 업데이트함

Zeigen die Zahlen im Admin-Dashboard der Schule oder des Teams nicht den gewünschten Ausschnitt? Verbinde Padlet MCP mit einem KI-Assistenten und frage in natürlicher Sprache nach Analysen zu deiner Schule, deinem Klassenraum oder deinem Team. Oder rufe die Organisationsanalyse-API selbst auf.

Die vollständige REST-Referenz (Metrikkatalog, Anfrageformate und Fehlercodes) findest du unter Organisationsanalysen abrufen auf docs.padlet.dev.

Für wen ist das gedacht?

Dieser Artikel richtet sich an:

  • Eigentümer und Admins von Padlet for Schools- oder Team-Konten
  • Eigentümer und Lehrkräfte von Klassenraum-Konten

Für die MCP-Methode musst du keinen Code schreiben. Die API-Methode ist optional und richtet sich an erfahrene Nutzer, die bereits mit der öffentlichen API arbeiten.

Was du bereits hast

Auf der Seite Analysen deiner Organisation unter „Einstellungen“ werden bereits kuratierte Tabs für den aktuellen Abrechnungszeitraum angezeigt. Schulen und Klassenräume erhalten die Tabs „Übersicht“, „Nutzung“, „Auswirkungen“, „Sicherheit“, „Top-Nutzer“ und „Alle Nutzer“. Teams erhalten die Tabs „Allgemein“, „Padlets“ und „Nutzer“ oder – wenn dein Team die neue Analyseseite (Beta) nutzt – „Übersicht“, „Nutzung“, „Auswirkungen“, „Top-Nutzer“ und „Alle Nutzer“.

Nutze das Dashboard, wenn du dir schnell einen visuellen Überblick verschaffen möchtest. Nutze MCP oder die API, wenn du einen benutzerdefinierten Ausschnitt brauchst, den die Tabs nicht so gut abdecken.

Was MCP / die API zusätzlich bietet

Das Dashboard umfasst kuratierte Tabs. Mit MCP und der API kannst du genau den gewünschten Ausschnitt abfragen:

  • Fragen in natürlicher Sprache in deinem KI-Client („Welche Lehrkräfte waren im letzten Abrechnungszeitraum inaktiv?“)
  • Benutzerdefinierte Kombinationen aus Engagement-, Mitgliedschafts- und Inhaltssicherheitsmetriken
  • Monatliche Zeitreihen über einen Datumsbereich
  • Aufschlüsselungen nach Rolle (Lehrkräfte vs. Schüler, Ersteller vs. Mitwirkende)
  • Top-Padlets, Top-Nutzer und Top-Medien, sortiert nach deinen Vorgaben
  • Antworten, die du in eine QBR-Präsentation oder ein Verlängerungsdeck übernehmen kannst
Metriken zur Inhaltssicherheit (gescannte Elemente, markierte Elemente, Erkennungsrate) sind nur für Schulen und Klassenräume verfügbar. Wenn du sie für eine Team-Organisation abfragst, erhältst du einen Fehler und nicht den Wert null.

Schnelleinstieg mit Padlet MCP

  1. Verbinde Padlet MCP in deinem KI-Client. Verwende die Server-URL https://mcp.padlet.com. Die vollständige Einrichtung findest du unter Padlet MCP Server.
  2. Melde dich an und autorisiere dich als Admin der Organisation, die du abfragen möchtest. In einem Klassenraum kann auch eine Lehrkraft Analysen abrufen.
  3. Stelle deine Frage in natürlicher Sprache. Du musst keine internen Tools nennen. Teile dem KI-Assistenten mit, was du über deine Schule, deinen Klassenraum oder dein Team wissen möchtest. Er verwendet dann Padlet MCP für dich.

Hier ist ein Beispiel:

Falls ein bestimmter MCP-Client noch keine Antworten zu Analysen anzeigt, probiere einen anderen MCP-kompatiblen Client aus oder verwende stattdessen die Organisationsanalyse-API. Die Unterstützung durch Clients kann hinter der des Servers zurückliegen.
Dein Assistent handelt in deinem Namen. Er kann nur Analysen abrufen, die dein angemeldetes Konto sehen darf.

Optional: Organisationsanalyse-API

Du möchtest lieber selbst ein Skript erstellen? Verwende die öffentliche API mit einem Admin-API-Schlüssel (oder einem Lehrkraft-Schlüssel für einen Klassenraum).

  1. Erstelle oder kopiere auf der Entwicklerseite in den Einstellungen einen API-Schlüssel. Einzelheiten findest du im Artikel zur öffentlichen API.
  2. Finde deine Organisations-ID mit GET /me?include=organizations. Gesucht ist eine ID mit dem Präfix wksp_. Organisationen auf padlet.org mit dem Präfix org_ werden von diesem Endpunkt noch nicht unterstützt.
  3. Sende eine POST-Anfrage an /organizations/{org_id}/analytics mit den gewünschten Metriken.
  4. Wenn die Antwort 202 lautet oder meta.pending nicht leer ist, warte die in Retry-After angegebene Zeit ab und sende dieselbe Anfrage erneut. Analysen werden im Hintergrund berechnet. Ausstehende Metriken fehlen daher in der Antwort. Werte sie niemals als null.
Die vollständigen Anfrageformate, den Metrikkatalog und Beispiele findest du unter Organisationsanalysen abrufen.

Wer kann die Funktion nutzen?

Organisationsanalysen über Padlet MCP und die API sind für Eigentümer und Admins von Padlet for Schools- und Team-Konten sowie für Eigentümer und Lehrkräfte von Klassenraum-Konten verfügbar. Du musst Padlet nicht um die Freischaltung bitten.

Derzeit werden nur Organisationen mit dem Präfix wksp_ unterstützt.

Beispielfragen

Diese Fragen kannst du als Ausgangspunkt in deinen MCP-Client kopieren. Passe die Formulierungen an deine Schule, deinen Klassenraum oder dein Team an und gleiche die Zahlen mit der Analyseseite ab, wenn du eine Präsentation für Kunden vorbereitest.

  • „Wie viele Lehrkräfte waren an unserer Schule in diesem Abrechnungszeitraum aktiv, im Vergleich zur Zahl der Lizenzen, und in welchen Monaten gab es einen Rückgang?“
  • „Welche Organisations-Padlets haben die meisten Aufrufe? Nenne mir die Top 3 Boards/sandbox.“
  • „Welche Mitglieder mit der Rolle ‚Lehrkraft‘ haben Padlet in den letzten 12 Monaten nicht genutzt?“
  • „Wie viele Mitglieder haben keine E-Mail-Domain <ouremaildomain.edu>?“
Frage den gewünschten Ausschnitt ab: eine monatliche Zeitreihe, einen Rollenfilter, die Top-Padlets nach Beiträgen oder Besuchern oder die Gesamtwerte zur Inhaltssicherheit für eine Schule oder einen Klassenraum. Der Assistent ordnet deine Frage den verfügbaren Metriken zu.

Was das Dashboard weiterhin besser kann

Nutze die Analyseseite unter „Einstellungen“, wenn du Folgendes brauchst:

  • Das visuelle Banner „Übersicht“, die Hinweise zu den wichtigsten Chancen und die Möglichkeit, mit einem Klick eine PD-Anfrage zu stellen
  • Die Tabelle „Alle Nutzer“ / „Nutzer“ mit Suche, Rollenfiltern und CSV-Download mit einem Klick
  • Herunterladbare Listen aktiver und inaktiver Lehrkräfte für den ausgewählten Zeitraum im Tab „Übersicht“ (Schulen und Klassenräume)

MCP und die API spielen ihre Stärken aus, wenn die kuratierten Tabs nicht genau die Frage beantworten, die du für eine Demo oder ein Verlängerungsgespräch hast.

Einschränkungen:

  • Ratenbegrenzung: 60 Anfragen pro Stunde und API-Schlüssel und Organisation, einschließlich Abrufversuchen nach einer 202-Antwort
  • Datumsbereich: höchstens 24 Monate pro Anfrage
  • Inhaltssicherheit: nur für Schulen und Klassenräume. Teams erhalten für diese Metriken eine 400-Fehlermeldung
  • Mitgliederzahlen: beziehen sich auf die aktuelle Mitgliederliste, nicht auf einen historischen Stand der damaligen Mitglieder
  • Ausstehend bedeutet nicht null: Eine noch berechnete Metrik fehlt in der Antwort. Werte sie nicht als null.
  • Organisationstyp: derzeit nur wksp_

Häufig gestellte Fragen

Warum erhalte ich bei einer Analyseanfrage einen 404-Fehler?

Alle Ablehnungen sehen gleich aus: Sowohl für eine unbekannte Organisation als auch bei fehlendem Zugriff wird 404 zurückgegeben. Prüfe, ob du als Admin (oder als Lehrkraft in einem Klassenraum) der betreffenden Organisation angemeldet bist und ob sie das Präfix wksp_ hat. Kommst du nicht weiter? Wende dich an den Support.

Muss ich Code schreiben?

Nein. Verbinde Padlet MCP, melde dich als Admin an und stelle deine Frage in natürlicher Sprache. Die API-Methode ist optional und richtet sich an Entwickler und erfahrene Nutzer, die die öffentliche API bereits verwenden.

Ist das dasselbe wie die öffentliche API?

Die Funktionen hängen zusammen, sind aber nicht dasselbe Produkt. Die öffentliche API ist für Entwickler gedacht, die einen API-Schlüssel verwenden. Padlet MCP ist für KI-Assistenten gedacht, denen du durch Anmelden Zugriff gewährst. Beide können auf Organisationsanalysen zugreifen. Du kannst eine der beiden oder beide verwenden.

Können Schüler oder Nicht-Admins auf diesem Weg Organisationsanalysen sehen?

Nein. Für Analysen sind die Rechte eines Admins der Organisation oder einer Lehrkraft in einem Klassenraum erforderlich. Der Assistent hat genau dieselben Zugriffsrechte wie das Konto, mit dem du dich angemeldet hast, und keine weiteren.

Mein MCP-Client scheint nichts von Analysen zu wissen. Was kann ich versuchen?

Bei manchen Clients wird die Tool-Liste verzögert aktualisiert. Versuche, Padlet MCP erneut zu verbinden, zu einem anderen MCP-kompatiblen Client zu wechseln oder die Organisationsanalyse-API direkt zu verwenden. Wenn du weiterhin nicht weiterkommst, melde dich bei uns.

Verwandte Artikel

이 문서가 도움이 되었나요?

관련 문서