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

Carla Seses profilbildUppdaterad för 16 timmar sedan av Carla Sese

Behöver du siffror som översikten för administratörer på skolan eller teamet inte visar på det sätt du vill? Anslut Padlet MCP till en AI-assistent och be om analyser av skolan, klassrummet eller teamet med vanligt språk – eller anropa organisationens analys-API själv.

Den fullständiga REST-referensen (mätvärdeskatalog, förfrågningsformat och felkoder) finns i Läs om organisationsanalys på docs.padlet.dev.

Vem är det här till för?

Den här artikeln riktar sig till:

  • Ägare och administratörer för Padlet for Schools- eller Team-konton
  • Ägare och lärare för klassrumskonton

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

Det här har du redan

Organisationens sida för Analys i Inställningar visar redan utvalda flikar för den aktuella faktureringsperioden. Skolor och klassrum har flikarna Översikt, Användning, Effekt, Säkerhet, Toppanvändare och Alla användare. Team har flikarna Allmänt, Padlets och Användare, eller Översikt, Användning, Effekt, Toppanvändare och Alla användare om ditt Team har den nya analyssidan (beta).

Använd översikten när du vill ha en snabb visuell sammanfattning. Använd MCP eller API:et när du behöver en anpassad uppdelning som flikarna inte besvarar lika tydligt.

Vad MCP/API tillför

Översikten består av utvalda flikar. Med MCP och API:et kan du be om precis den uppdelning du behöver:

  • Frågor på vanligt språk i din AI-klient (”Vilka lärare var inaktiva under förra faktureringsperioden?”)
  • Anpassade kombinationer av mätvärden för engagemang, medlemskap och innehållssäkerhet
  • Månadsserier för ett datumintervall
  • Uppdelningar efter roll (lärare jämfört med elever, skapare jämfört med bidragsgivare)
  • Populäraste padlets, användare och medier rangordnade på det sätt du ber om
  • Svar som du kan klistra in i en QBR- eller förnyelsepresentation
Mätvärden för innehållssäkerhet (skannade objekt, flaggade objekt, träffsäkerhet) är bara tillgängliga för skolor och klassrum. Om du ber om dem för en Team-organisation får du ett fel, inte noll.

Snabbstart med Padlet MCP

  1. Anslut Padlet MCP i din AI-klient. Använd serveradressen https://mcp.padlet.com. Fullständiga konfigurationssteg finns i Padlet MCP Server.
  2. Logga in och auktorisera som administratör för organisationen du vill göra förfrågningar om. I ett klassrum kan även en lärare hämta analyser.
  3. Ställ frågor med vanligt språk. Du behöver inte ange interna verktygsnamn. Berätta för AI-assistenten vad du vill veta om skolan, klassrummet eller teamet, så använder den Padlet MCP åt dig.

Här är ett exempel:

Om en viss MCP-klient ännu inte visar analyssvar kan du prova en annan MCP-kompatibel klient eller använda organisationens analys-API i stället. Klientstödet kan släpa efter servern.
Assistenten agerar som du. Den kan bara hämta analyser som ditt inloggade konto har behörighet att se.

Valfritt: organisationens analys-API

Föredrar du att skapa egna skript? Använd Public API med en API-nyckel för administratörer (eller en lärarnyckel för ett klassrum).

  1. Skapa eller kopiera en API-nyckel från sidan Utvecklare i Inställningar. Mer information finns i artikeln Public API.
  2. Hitta organisationens ID med GET /me?include=organizations. Du behöver ett wksp_-ID – organisationer med org_ på padlet.org stöds inte för den här slutpunkten än.
  3. Skicka en POST-förfrågan till /organizations/{org_id}/analytics med de mätvärden du vill ha.
  4. Om svaret är 202 eller meta.pending inte är tomt väntar du den angivna tiden i Retry-After och skickar samma förfrågan igen. Analyser beräknas asynkront – ett väntande mätvärde saknas, det är inte noll. Behandla aldrig väntande som noll.
Fullständiga förfrågningsformat, mätvärdeskatalogen och exempel finns i Läs om organisationsanalys.

Pilotåtkomst

Organisationsanalys via MCP och API är valfri under pilotperioden. Padlet registrerar organisationsägaren – det räcker inte att bara vara administratör. Fram till dess att organisationen har registrerats besvaras varje anrop med 404 (samma svar som för en okänd organisation).

För närvarande stöds endast organisationer med wksp_.

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

Exempel på frågor

Här är några förslag som du kan klistra in i MCP-klienten. Anpassa formuleringarna efter din skola, ditt klassrum eller team – och kontrollera siffrorna mot analyssidan när du förbereder en presentation för kunder.

  • ”För vår skola under den här faktureringsperioden, hur många aktiva lärare jämfört med licenser har vi, och vilka månader gick siffrorna ned?”
  • ”Vilka organisationspadlets har flest visningar? Ge mig de tre främsta anslagstavlorna/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 <ouremaildomain.edu>?”
Be om den uppdelning du behöver: en månadsserie, ett rollfilter, populäraste padlets efter antal inlägg eller besökare, eller totalsiffror för innehållssäkerhet i en skola eller ett klassrum. Assistenten mappar frågan till tillgängliga mätvärden.

Vad översikten fortfarande gör bättre

Använd analyssidan i Inställningar när du vill ha:

  • Den visuella översiktsbanderollen, utrop om de främsta möjligheterna och en knapp för att begära fortbildning
  • Tabellen Alla användare/Användare med sökning, rollfilter och nedladdning av CSV 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 aktivera API-åtkomst

MCP och API:et kommer bäst till sin rätt när de utvalda flikarna inte besvarar den exakta frågan du behöver inför en demo eller ett förnyelsesamtal.

Begränsningar:

  • Begärandebegränsning: 60 förfrågningar per timme och API-nyckel och organisation, inklusive upprepade förfrågningar efter en 202
  • Datumintervall: högst 24 månader i en förfrågan
  • Innehållssäkerhet: endast skolor och klassrum – Team får ett 400 för dessa mätvärden
  • Medlemsantal: avspeglar den nuvarande medlemslistan, inte en historisk ögonblicksbild av vilka som tillhörde organisationen vid en viss tidpunkt
  • Väntande ≠ noll: ett mätvärde som fortfarande beräknas saknas i svaret; behandla det inte som noll
  • Organisationstyp: endast wksp_ för närvarande

Vanliga frågor

Varför får jag 404 när jag ber om analyser?

Under pilotperioden ser alla avslag likadana ut: oregistrerad organisation, okänd organisation eller ingen åtkomst ger alla 404. Kontrollera att du är inloggad som administratör (eller lärare i ett klassrum), att organisationen har ett wksp_-ID och att Padlet har registrerat organisationsägaren. Kontakta supporten för att begära registrering.

Måste jag skriva kod?

Nej. Anslut Padlet MCP, logga in som administratör och ställ frågor med vanligt språk. API-vägen är valfri för utvecklare och avancerade användare som redan använder Public API.

Är det här samma sak som Public API?

De hänger ihop, men är inte samma produkt. Public API är till för utvecklare som använder en API-nyckel. Padlet MCP är till för AI-assistenter som du auktoriserar genom att logga in. Båda kan hämta organisationsanalyser när organisationen har registrerats; du kan använda det ena eller båda.

Kan elever eller personer som inte är administratörer se organisationsanalyser på det här sättet?

Nej. För analyser krävs att du är administratör för organisationen eller lärare i ett klassrum. Assistenten har exakt samma åtkomst som kontot du loggade in med – varken mer eller mindre.

Min MCP-klient verkar inte känna till analyser. Vad kan jag prova?

Vissa klienter uppdaterar verktygslistan med fördröjning. Prova att återansluta Padlet MCP, byta till en annan MCP-kompatibel klient eller använda organisationens analys-API direkt. Om du fortfarande inte kommer åt det efter registreringen kan du kontakta oss.

Relaterat

Var den här artikeln till hjälp?

Relaterade artiklar

Öppna diagnostiksidan

Felsök problem med Padlet med hjälp av diagnostiska verktyg på webben eller i mobilen, och kontakta sedan supporten med resultaten om det behövs.

Hur återställer jag mitt Apple-ID?

Återställ ditt Apple-ID för Padlet genom att ta bort det från dina Apple-ID-inställningar och logga in igen.

Jag vill jobba på Padlet. Var ska jag ansöka?

Utforska karriärmöjligheterna hos Padlet och sök lediga tjänster på padlet.jobs.

Vad händer med dina data när ett konto raderas?

Förstå vad som händer när du raderar ditt Padlet-konto och hur du återställer det inom 14 dagar.