Hur ber jag Padlet MCP om Admin Analytics (beta)?

Carla Sese 的头像由 Carla Sese 于 för 13 timmar sedan 更新

Behöver du siffror som inte presenteras på det sätt du vill i skolans eller lagets administratörspanel? Anslut Padlet MCP till en AI-assistent och be om analysdata för skolan, klassrummet eller laget på vanligt språk – eller anropa API:et för organisationsanalys själv.

För fullständig REST-referens (mätvärdeskatalog, förfrågningsformat och felkoder), se Läs organisationsanalyser på docs.padlet.dev.

Vem den här artikeln riktar sig till

Den här artikeln riktar sig till:

  • Ägare och administratörer av Padlet for Schools- eller Team-konton
  • Ägare och lärare med Classroom-konton

Du behöver inte skriva kod för att använda MCP-vägen. API-vägen är valfri för avancerade användare som redan arbetar med det offentliga API:et.

Vad du redan har

Din organisations Analytics-sida under Inställningar visar redan sammanställda flikar för den aktuella faktureringsperioden. Skolor och klassrum får Översikt, Användning, Effekt, Säkerhet, Toppanvändare och Alla användare. Team får Allmänt, Padlets och Användare.

Använd instrumentpanelen när du vill få en snabb visuell översikt. Använd MCP eller API:et när du behöver en anpassad översikt som flikarna inte ger ett tydligt svar på.

Vad MCP/API tillför

Dashboardet består av utvalda flikar. Med MCP och API:et kan du begära exakt den information du behöver:

  • Frågor i klartext i din AI-klient (”vilka lärare var inaktiva under den senaste faktureringsperioden?”)
  • Anpassade kombinationer av mått på engagemang, medlemskap och innehållssäkerhet
  • Månatliga serier över ett visst datumintervall
  • Uppdelningar efter roll (lärare vs elever, skapare vs bidragsgivare)
  • De populäraste padlets, användarna och medierna rankade enligt dina önskemål
  • Svar som du kan klistra in i en QBR eller en förnyelsepresentation
Mätvärden för innehållssäkerhet (skannade objekt, flaggade objekt, upptäcktsfrekvens) är endast tillgängliga för skolor och klassrum. Om du begär dessa för en Team-organisation returneras ett felmeddelande, inte noll.

Snabbstart med Padlet MCP

  1. Anslut Padlet MCP i din AI-klient. Använd server-URL:en https://mcp.padlet.com. Fullständiga installationsinstruktioner finns i Padlet MCP Server.
  2. Logga in och auktorisera dig som administratör för den organisation du vill göra en förfrågan om. I ett klassrum kan även en lärare hämta analysdata.
  3. Ställ frågorna i vardagligt språk. Du behöver inte nämna interna verktyg vid namn. Berätta för AI-assistenten vad du vill veta om din skola, ditt klassrum eller ditt team, så kommer den att använda Padlet MCP åt dig.

Här är ett exempel:

Om en viss MCP-klient ännu inte visar svar från analyserna, prova en annan MCP-kompatibel klient eller använd istället organisationens analys-API. Klientstödet kan ligga efter servern.
Din assistent agerar som du. Den kan endast hämta analysdata som ditt inloggade konto har behörighet att se.

Valfritt: API för organisationsanalys

Föredrar du att skriva ett skript själv? Använd det offentliga API:et med en administratörs-API-nyckel (eller en lärarnyckel i Classroom).

  1. Skapa eller kopiera en API-nyckel från utvecklarsidan i dina inställningar. Mer information finns i artikeln om det offentliga API:et.
  2. Hitta ditt organisations-ID med GET /me?include=organizations. Du behöver ett wksp_ ID — org_ organisationer på padlet.org stöds ännu inte för denna slutpunkt.
  3. Skicka en POST till /organizations/{org_id}/analytics med de mätvärden du vill ha.
  4. Om svaret är 202 eller meta.pending inte är tom, vänta på Retry-After och skicka samma förfrågan igen. Analyserna beräknas asynkront — en väntande mätvärde är frånvarande, inte noll. Betrakta aldrig ”väntande” som noll.
Fullständiga förfrågningsmallar, mätvärdeskatalogen och praktiska exempel finns i Read-organisationsanalys.

Tillgång till pilotprojektet

Organisationsanalys via MCP och API:et är valfritt under pilotfasen. Padlet registrerar organisationens ägare – det räcker inte att bara vara administratör. Tills din organisation är registrerad svarar varje anrop 404 (samma svar som för en okänd organisation).

Endast wksp_ organisationer stöds för tillfället.

Kontakta supporten och be dem registrera din organisationsägare för administratörsanalys.

Exempel på frågor

Här är några exempel som du kan klistra in i din MCP-klient. Anpassa formuleringarna så att de passar din skola, ditt klassrum eller ditt team – och kontrollera siffrorna mot sidan Analytics när du förbereder en presentation för kunder.

  • ”För vår skola under denna faktureringsperiod: hur många aktiva lärare jämfört med licenser, och vilka månader uppvisade en nedgång?”
  • ”Vilka organisations-Padlets har flest visningar? Ge mig de tre mest visade anslagen/sandboxarna.”
  • ”Vilka medlemmar med lärarroll har inte använt Padlet under de senaste 12 månaderna?”
  • ”Hur många medlemmar har inte e-postdomänen <vår e-postdomän.edu>?”
Be om just den information du behöver: en månatlig serie, ett rollfilter, de populäraste Padlets-tavlorna efter inlägg eller besökare, eller sammanställningar över innehållssäkerhet för en skola eller ett klassrum. Assistenten kopplar din fråga till de tillgängliga mätvärdena.

Vad instrumentpanelen fortfarande gör bättre

Håll dig till sidan Analytics i Inställningar när du vill:

  • Den visuella översiktsbannern, utmärkta möjligheter och PD-förfrågan med ett klick
  • Tabellen Alla användare / Användare med sökfunktion, rollfilter och nedladdning av CSV-fil med ett klick
  • Nedladdningsbara listor över aktiva och inaktiva lärare för den valda perioden, från fliken Översikt (skolor och klassrum)
  • En vy som inte kräver pilotregistrering – sidan Inställningar är tillgänglig för behöriga roller utan att man behöver anmäla sig till API:et

MCP och API:et kommer till sin rätt när de sammanställda flikarna inte ger exakt det svar du behöver för en demo eller ett förnyelsesamtal.

Begränsningar:

  • Begränsning av antalet förfrågningar: 60 förfrågningar per timme per API-nyckel och organisation, inklusive avröstningar efter en 202
  • Tidsintervall: högst 24 månader i en förfrågan
  • Innehållssäkerhet: endast skola och klassrum – Teams får en 400 för dessa mätvärden
  • Antal medlemmar: återspeglar den aktuella medlemslistan, inte en historisk ögonblicksbild av vilka som tillhörde vid den tidpunkten
  • Väntande ≠ noll: ett mått som fortfarande beräknas saknas i svaret; behandla det inte som noll
  • Organisationstyp: wksp_ endast för tillfället

Vanliga frågor

Varför får jag ett 404-fel när jag begär analysdata?

Så länge slutpunkten är i pilotfas ser alla avslag likadana ut: inte registrerad, okänd organisation eller ingen åtkomst returneras alltid 404. Kontrollera att du har loggat in som administratör (eller lärare i Classroom), att din organisation är en wksp_ organisation och att Padlet har registrerat organisationens ägare. Kontakta supporten för att begära registrering.

Måste jag skriva kod?

Nej. Anslut Padlet MCP, logga in som administratör och skicka din förfrågan i klartext. API-sökvägen är valfri för utvecklare och avancerade användare som redan använder det offentliga API:et.

Är detta samma sak som det offentliga API:et?

Relaterat, men inte samma produktgränssnitt. Det offentliga API:et är avsett för utvecklare som använder en API-nyckel. Padlet MCP är avsett för AI-assistenter som du auktoriserar genom att logga in. Båda kan komma åt organisationsanalyser så snart din organisation har registrerats; du kan använda endera eller båda.

Kan elever eller icke-administratörer se organisationsanalyserna på detta sätt?

Nej. Analyserna kräver att du är administratör för organisationen eller lärare i ett Classroom. Assistenten har exakt samma åtkomst som det konto du loggade in med – inget mer.

Min MCP-klient verkar inte känna till analyserna. Vad ska jag prova?

Vissa klienter uppdaterar sin verktygslista med en viss fördröjning. Försök att ansluta Padlet MCP på nytt, byta till en annan MCP-kompatibel klient eller använda API:et för organisationsstatistik direkt. Om du fortfarande inte kommer åt informationen efter registreringen, kontakta oss.

Relaterat

这篇文章对你有帮助吗?

相关文章