Wie frage ich Padlet MCP nach Admin-Analysen (Beta)?

Profilbild von Carla SeseVor vor 16 Stunden von Carla Sese aktualisiert

Brauchen Sie Zahlen, die das Admin-Dashboard Ihrer Schule oder Ihres Teams nicht so aufschlüsselt, wie Sie es möchten? Verbinden Sie Padlet MCP mit einem KI-Assistenten und fragen Sie in Alltagssprache nach Analysen zu Ihrer Schule, Ihrem klassenraum oder Ihrem Team – oder rufen Sie selbst die API für Organisationsanalysen auf.

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

Für wen ist dieser Artikel gedacht?

Dieser Artikel richtet sich an:

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

Für die Nutzung von MCP müssen Sie keinen Code schreiben. Die API ist eine optionale Möglichkeit für erfahrene Nutzer, die bereits mit der Public API arbeiten.

Was Sie bereits haben

Auf der Seite Analysen Ihrer Organisation in den Einstellungen werden bereits kuratierte Tabs für den aktuellen Abrechnungszeitraum angezeigt. Bei Schulen und Klassenräumen sind das Übersicht, Nutzung, Wirkung, Sicherheit, Top-Nutzer und Alle Nutzer. Bei Teams sind es Allgemein, Padlets und Nutzer – oder Übersicht, Nutzung, Wirkung, Top-Nutzer und Alle Nutzer, falls Ihr Team die neue Analytics-Seite (Beta) hat.

Nutzen Sie das Dashboard, wenn Sie sich einen schnellen visuellen Überblick verschaffen möchten. Verwenden Sie MCP oder die API, wenn Sie eine individuelle Aufschlüsselung benötigen, die sich mit den Tabs nicht ohne Weiteres beantworten lässt.

Was MCP und die API zusätzlich bieten

Das Dashboard bietet kuratierte Tabs. Mit MCP und der API können Sie genau die gewünschte Aufschlüsselung abrufen:

  • Fragen in Alltagssprache in Ihrem KI-Client („Welche Lehrkräfte waren im letzten Abrechnungszeitraum inaktiv?“)
  • Individuelle Kombinationen von Metriken zu Engagement, Mitgliedschaft und Inhaltssicherheit
  • Monatliche Reihen über einen Datumsbereich hinweg
  • Aufschlüsselungen nach Rolle (Lehrkräfte vs. Schüler, Ersteller vs. Mitwirkende)
  • Die Top-Padlets, Top-Nutzer und Top-Medien, sortiert nach Ihren Vorgaben
  • Antworten, die Sie in eine QBR- oder Verlängerungspräsentation übernehmen können
Metriken zur Inhaltssicherheit (gescannte Elemente, markierte Elemente, Erkennungsrate) sind nur für Schulen und Klassenräume verfügbar. Wenn Sie diese für eine Team-Organisation abfragen, wird ein Fehler zurückgegeben, nicht der Wert null.

Schnellstart mit Padlet MCP

  1. Verbinden Sie Padlet MCP in Ihrem KI-Client. Verwenden Sie die Server-URL https://mcp.padlet.com. Die vollständige Anleitung zur Einrichtung finden Sie unter Padlet MCP Server.
  2. Melden Sie sich an und autorisieren Sie den Zugriff als Admin der Organisation, die Sie abfragen möchten. Bei einem Classroom kann auch eine Lehrkraft Analysen abrufen.
  3. Stellen Sie Ihre Frage in Alltagssprache. Sie müssen keine internen Tools benennen. Sagen Sie dem KI-Assistenten, was Sie über Ihre Schule, Ihren klassenraum oder Ihr Team wissen möchten. Der Assistent verwendet dann Padlet MCP für Sie.

Hier ein Beispiel:

Falls ein bestimmter MCP-Client noch keine Analyseantworten anzeigt, versuchen Sie es mit einem anderen MCP-kompatiblen Client oder verwenden Sie stattdessen die API für Organisationsanalysen. Die Unterstützung durch Clients kann hinter der des Servers zurückliegen.
Der Assistent handelt in Ihrem Namen. Er kann nur Analysen abrufen, die Ihr angemeldetes Konto anzeigen darf.

Optional: API für Organisationsanalysen

Möchten Sie lieber selbst Skripte erstellen? Verwenden Sie die Public API mit einem Admin-API-Schlüssel (oder einem Lehrkraft-Schlüssel bei einem Classroom).

  1. Erstellen Sie auf der Entwicklerseite in Ihren Einstellungen einen API-Schlüssel oder kopieren Sie einen vorhandenen. Weitere Informationen finden Sie im Artikel zur Public API.
  2. Ermitteln Sie die ID Ihrer Organisation mit GET /me?include=organizations. Gesucht ist eine ID mit dem Präfix wksp_ – Organisationen mit dem Präfix org_ auf padlet.org werden von diesem Endpunkt noch nicht unterstützt.
  3. Senden Sie eine POST-Anfrage an /organizations/{org_id}/analytics und geben Sie die gewünschten Metriken an.
  4. Wenn die Antwort 202 lautet oder meta.pending nicht leer ist, warten Sie die in Retry-After angegebene Zeit ab und senden Sie dieselbe Anfrage erneut. Analysen werden asynchron berechnet – eine noch ausstehende Metrik fehlt in der Antwort und ist nicht null. Behandeln Sie ausstehende Werte niemals als null.
Die vollständigen Anfrageformate, den Metrikkatalog und Beispiele finden Sie unter Organisationsanalysen abrufen.

Pilotzugang

Organisationsanalysen über MCP und die API müssen während der Pilotphase ausdrücklich aktiviert werden. Padlet nimmt den Eigentümer der Organisation in das Pilotprogramm auf – Admin-Rechte allein reichen nicht aus. Bis Ihre Organisation aufgenommen wurde, wird bei jedem Aufruf 404 zurückgegeben (dieselbe Antwort wie bei einer unbekannten Organisation).

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

Kontaktieren Sie den Support und bitten Sie darum, den Eigentümer Ihrer Organisation für Admin-Analysen aufzunehmen.

Beispielfragen

Diese Formulierungen können Sie in Ihren MCP-Client kopieren. Passen Sie sie an Ihre Schule, Ihren klassenraum oder Ihr Team an – und überprüfen Sie die Zahlen auf der Seite „Analysen“, bevor Sie eine Präsentation für Kunden erstellen.

  • „Wie viele Lehrkräfte waren an unserer Schule in diesem Abrechnungszeitraum aktiv, verglichen mit der Anzahl der Lizenzen, und in welchen Monaten gab es einen Rückgang?“
  • „Welche Padlets unserer Organisation haben die meisten Aufrufe? Nenne mir die drei besten Boards/Sandboxen.“
  • „Welche Mitglieder mit der Rolle Lehrkraft haben Padlet in den letzten zwölf Monaten nicht verwendet?“
  • „Wie viele Mitglieder haben keine E-Mail-Adresse mit der Domain <ouremaildomain.edu>?“
Fragen Sie nach der gewünschten Aufschlüsselung: einer monatlichen Reihe, einem Rollenfilter, den Top-Padlets nach Posts oder Besuchern oder den Gesamtwerten zur Inhaltssicherheit für eine Schule oder einen klassenraum. Der Assistent ordnet Ihre Frage den verfügbaren Metriken zu.

Was das Dashboard weiterhin besser kann

Verwenden Sie die Seite „Analysen“ in den Einstellungen, wenn Sie Folgendes benötigen:

  • Das visuelle Übersichtsbanner, Hinweise zu den besten Entwicklungsmöglichkeiten und eine Anfrage für eine Fortbildung mit nur einem Klick
  • Die Tabelle „Alle Nutzer“/„Nutzer“ mit Suche, Rollenfiltern und CSV-Download mit nur einem Klick
  • Herunterladbare Listen aktiver und inaktiver Lehrkräfte für den ausgewählten Zeitraum im Tab „Übersicht“ (Schulen und Klassenräume)
  • Eine Ansicht, für die keine Aufnahme in das Pilotprogramm erforderlich ist – die Einstellungsseite steht berechtigten Rollen auch ohne Aktivierung der API zur Verfügung

MCP und die API spielen ihre Stärken aus, wenn die kuratierten Tabs die konkrete Frage, die Sie für eine Demo oder ein Verlängerungsgespräch beantworten müssen, nicht abdecken.

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 – bei Teams führen diese Metriken zu einem Fehler 400
  • Mitgliederzahlen: beziehen sich auf die aktuelle Mitgliederliste und nicht auf einen historischen Stand der damaligen Mitgliedschaft
  • Ausstehend ≠ null: eine noch berechnete Metrik fehlt in der Antwort. Behandeln Sie sie nicht als null.
  • Organisationstyp: derzeit nur wksp_

Häufig gestellte Fragen

Warum erhalte ich bei einer Analyseanfrage den Fehler 404?

Während der Pilotphase sehen alle Ablehnungen gleich aus: „nicht aufgenommen“, „unbekannte Organisation“ und „kein Zugriff“ führen alle zu 404. Vergewissern Sie sich, dass Sie als Admin angemeldet sind (oder als Lehrkraft bei einem Classroom), dass Ihre Organisation das Präfix wksp_ hat und dass Padlet den Eigentümer der Organisation in das Pilotprogramm aufgenommen hat. Kontaktieren Sie den Support, um die Aufnahme zu beantragen.

Muss ich Code schreiben?

Nein. Verbinden Sie Padlet MCP, melden Sie sich als Admin an und stellen Sie Ihre Frage in Alltagssprache. Die API ist optional für Entwickler und erfahrene Nutzer, die bereits die Public API verwenden.

Ist das dasselbe wie die Public API?

Die Produkte hängen zusammen, sind aber nicht identisch. Die Public API richtet sich an Entwickler, die einen API-Schlüssel verwenden. Padlet MCP ist für KI-Assistenten gedacht, denen Sie durch Anmeldung Zugriff gewähren. Sobald Ihre Organisation aufgenommen wurde, können beide auf Organisationsanalysen zugreifen. Sie können eine der beiden Möglichkeiten oder beide verwenden.

Können Schüler oder Personen ohne Admin-Rechte auf diese Weise Organisationsanalysen einsehen?

Nein. Für Analysen ist ein Admin der Organisation oder eine Lehrkraft bei einem Classroom erforderlich. Der Assistent hat genau dieselben Zugriffsrechte wie das Konto, mit dem Sie sich angemeldet haben – nicht mehr.

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

Bei manchen Clients wird die Tool-Liste verzögert aktualisiert. Versuchen Sie, Padlet MCP erneut zu verbinden, zu einem anderen MCP-kompatiblen Client zu wechseln oder die API für Organisationsanalysen direkt zu verwenden. Wenn Sie nach der Aufnahme weiterhin keinen Zugriff haben, kontaktieren Sie uns.

Verwandte Artikel

War dieser Artikel hilfreich?

Verwandte Artikel

Auf die Diagnoseseite zugreifen

Beheben Sie Probleme mit Padlet mithilfe von Diagnosetools im Web oder auf Mobilgeräten und wenden Sie sich bei Bedarf mit den Ergebnissen an den Support.

Wie setze ich meine Apple-ID zurück?

Setzen Sie Ihre Apple-ID für Padlet zurück, indem Sie sie aus Ihren Apple-ID-Einstellungen entfernen und sich erneut anmelden.

Ich möchte bei Padlet arbeiten. Wo kann ich mich bewerben?

Entdecken Sie Karrieremöglichkeiten bei Padlet und bewerben Sie sich auf offene Stellen unter padlet.jobs.

Was passiert mit Ihren Daten, wenn ein Konto gelöscht wird?

Erfahren Sie, was passiert, wenn Sie Ihr Padlet-Konto löschen, und wie Sie es innerhalb von 14 Tagen wiederherstellen können.