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

Zdjęcie profilowe użytkownika Carla SeseZaktualizowano vor 13 Stunden przez Carla Sese

Sie benötigen 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 einfacher Sprache nach Analysen zu Ihrer Schule, Ihrem Klassenraum oder Team – oder rufen Sie die API für Organisationsanalysen selbst 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

Sie müssen keinen Code schreiben, um MCP zu nutzen. Die API ist eine optionale Möglichkeit für fortgeschrittene 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. Schulen und Klassenräume erhalten die Tabs „Übersicht“, „Nutzung“, „Auswirkungen“, „Sicherheit“, „Top-Nutzer“ und „Alle Nutzer“. Teams erhalten die Tabs „Allgemein“, „Padlets“ und „Nutzer“.

Nutzen Sie das Dashboard, wenn Sie sich schnell einen visuellen Überblick verschaffen möchten. Verwenden Sie MCP oder die API, wenn Sie eine benutzerdefinierte Aufschlüsselung benötigen, die von den Tabs nicht ausreichend abgedeckt wird.

Was MCP / API zusätzlich bietet

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

  • Fragen in einfacher Sprache in Ihrem KI-Client („Welche Lehrkräfte waren im letzten Abrechnungszeitraum inaktiv?“)
  • Benutzerdefinierte Kombinationen aus Engagement-, Mitgliedschafts- und Inhaltssicherheitsmetriken
  • Monatliche Zeitreihen über einen Datumsbereich hinweg
  • Aufschlüsselungen nach Rollen (Lehrkräfte vs. Lernende, Ersteller vs. Mitwirkende)
  • Die beliebtesten Padlets, Nutzer und 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 sie für eine Teamorganisation abfragen, erhalten Sie einen Fehler und keinen Wert von null.

Schnellstart mit Padlet MCP

  1. Verbinden Sie Padlet MCP mit Ihrem KI-Client. Verwenden Sie die Server-URL https://mcp.padlet.com. Eine 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. In einem Classroom kann auch eine Lehrkraft Analysen abrufen.
  3. Stellen Sie Ihre Frage in einfacher Sprache. Sie müssen keine internen Tools benennen. Teilen Sie dem KI-Assistenten mit, was Sie über Ihre Schule, Ihren Klassenraum oder Ihr Team erfahren möchten. Er verwendet dann Padlet MCP für Sie.

Hier ein Beispiel:

Wenn 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 Serverunterstützung zurückbleiben.
Ihr Assistent handelt in Ihrem Namen. Er kann nur Analysen abrufen, die Ihr angemeldetes Konto einsehen darf.

Optional: API für Organisationsanalysen

Möchten Sie lieber selbst ein Skript dafür schreiben? Verwenden Sie die Public API mit einem API-Schlüssel für Admins (oder einem Lehrkraft-Schlüssel in einem Classroom).

  1. Erstellen oder kopieren Sie einen API-Schlüssel auf der Entwicklerseite in Ihren Einstellungen. Einzelheiten finden Sie im Artikel zur Public API.
  2. Rufen Sie Ihre Organisations-ID mit GET /me?include=organizations ab. 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. Senden Sie 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, warten Sie die angegebene Zeit unter Retry-After ab und senden Sie dieselbe Anfrage erneut. Analysen werden asynchron berechnet – eine ausstehende Metrik fehlt in der Antwort; sie ist nicht null. Behandeln Sie ausstehende Metriken niemals als null.
Die vollständigen Anfrageformate, den Metrikkatalog und ausgearbeitete Beispiele finden Sie unter Organisationsanalysen abrufen.

Pilotzugang

Organisationsanalysen über MCP und die API sind während der Pilotphase nur nach vorheriger Anmeldung verfügbar. Padlet nimmt den Eigentümer der Organisation auf – Admin zu sein, reicht nicht aus. Bis Ihre Organisation aufgenommen wurde, antwortet jeder Aufruf mit 404 (dieselbe Antwort wie bei einer unbekannten Organisation).

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

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

Beispiel-Prompts

Diese Vorschläge können Sie in Ihren MCP-Client kopieren. Passen Sie die Formulierung an Ihre Schule, Ihren Klassenraum oder Ihr Team an – und überprüfen Sie die Zahlen auf der Seite „Analysen“, wenn Sie eine Präsentation für Kunden vorbereiten.

  • „Wie viele Lehrkräfte an unserer Schule waren in diesem Abrechnungszeitraum aktiv, verglichen mit der Anzahl der Lizenzen, und in welchen Monaten gingen die Zahlen zurück?“
  • „Welche Padlets unserer Organisation haben die meisten Aufrufe? Nenne mir die Top 3 Boards/Sandboxes.“
  • „Welche Mitglieder mit der Rolle ‚Lehrkraft‘ haben Padlet in den letzten 12 Monaten nicht genutzt?“
  • „Wie viele Mitglieder haben nicht die E-Mail-Domain <ouremaildomain.edu>?“
Fragen Sie nach der gewünschten Aufschlüsselung: einer monatlichen Zeitreihe, einem Rollenfilter, den beliebtesten 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

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

  • Das visuelle Banner in der Übersicht, Hinweise auf Top-Chancen und eine PD-Anfrage 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 auf dem Tab „Übersicht“ (Schulen und Klassenräume)
  • Eine Ansicht, für die keine Aufnahme in das Pilotprogramm erforderlich ist – die Seite „Einstellungen“ steht berechtigten Rollen auch ohne API-Freischaltung zur Verfügung

MCP und die API sind besonders nützlich, wenn die kuratierten Tabs die genaue Frage, die Sie für eine Demo oder ein Verlängerungsgespräch haben, nicht beantworten.

Einschränkungen:

  • Ratenbegrenzung: 60 Anfragen pro Stunde und API-Schlüssel und Organisation, einschließlich Abfragen nach einer 202-Antwort
  • Datumsbereich: maximal 24 Monate pro Anfrage
  • Inhaltssicherheit: nur für Schulen und Klassenräume – Teams erhalten bei diesen Metriken eine 400-Antwort
  • Mitgliederzahlen: beziehen sich auf die aktuelle Mitgliederliste, 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 beim Abfragen von Analysen eine 404-Antwort?

Während der Pilotphase sehen alle Ablehnungen gleich aus: nicht aufgenommen, unbekannte Organisation oder kein Zugriff – in allen Fällen lautet die Antwort 404. Vergewissern Sie sich, dass Sie als Admin angemeldet sind (oder als Lehrkraft in einem Classroom), dass Ihre Organisation eine wksp_-Organisation ist und dass Padlet den Eigentümer der Organisation aufgenommen hat. Wenden Sie sich an 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 einfacher Sprache. Die API ist eine optionale Möglichkeit für Entwickler und fortgeschrittene Nutzer, die bereits die Public API verwenden.

Ist das dasselbe wie die Public API?

Die Produkte hängen zusammen, bieten aber unterschiedliche Nutzungsmöglichkeiten. 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 eines oder beide verwenden.

Können Lernende oder Nicht-Admins auf diese Weise Organisationsanalysen einsehen?

Nein. Für Analysen ist ein Admin der Organisation oder eine Lehrkraft in 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 erst 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 nicht weiterkommen, kontaktieren Sie uns.

Verwandte Artikel

Czy ten artykuł był pomocny?

Powiązane artykuły