Come posso chiedere a Padlet MCP le analisi dell’amministratore?
Vor 4 giorni fa von Carla Sese aktualisiertHai bisogno di numeri che la dashboard amministrativa della scuola o del Team non presenta nel modo che desideri? Collega Padlet MCP a un assistente AI e chiedi analisi su scuole, classroom o Team in linguaggio semplice, oppure chiama direttamente l'API di analisi dell'organizzazione.
A chi è rivolto
Questo articolo è rivolto a:
- Proprietari e amministratori degli account Padlet for Schools o Team
- Proprietari e insegnanti degli account Classroom
Non devi scrivere codice per usare Padlet MCP. L'API è facoltativa per gli utenti esperti che già utilizzano la Public API.
Cosa hai già a disposizione
La pagina Analisi della tua organizzazione, nelle Impostazioni, mostra già schede selezionate per il periodo di fatturazione corrente. Scuole e classroom hanno le schede Panoramica, Utilizzo, Impatto, Sicurezza, Utenti principali e Tutti gli utenti. I Team hanno Generale, Padlet e Utenti oppure, se il tuo Team ha la nuova pagina Analisi (beta), Panoramica, Utilizzo, Impatto, Utenti principali e Tutti gli utenti.
- Analisi degli account scolastici (Padlet for Schools e Classroom)
- Analisi degli account Team
Usa la dashboard quando vuoi una rapida panoramica visiva. Usa MCP o l'API quando ti serve un filtro personalizzato a cui le schede non rispondono in modo altrettanto chiaro.
Cosa aggiungono MCP e l'API
La dashboard offre schede selezionate. MCP e l'API ti permettono di richiedere esattamente i dati che ti servono:
- Domande in linguaggio semplice nel tuo client AI ("quali insegnanti sono stati inattivi nell'ultimo periodo di fatturazione?")
- Combinazioni personalizzate di metriche di coinvolgimento, appartenenza e sicurezza dei contenuti
- Serie mensili per un intervallo di date
- Filtri per ruolo (insegnanti e studenti, creatori e collaboratori)
- I padlet, gli utenti e i contenuti multimediali più popolari, ordinati come richiesto
- Risposte da inserire in una presentazione per una QBR o un rinnovo
Guida rapida a Padlet MCP
- Collega Padlet MCP nel tuo client AI. Usa l'URL del server
https://mcp.padlet.com. Per la procedura di configurazione completa, consulta Server Padlet MCP. - Accedi e autorizza l'accesso come amministratore dell'organizzazione per cui vuoi eseguire le query. In una classroom, anche un insegnante può consultare le analisi.
- Fai domande in linguaggio semplice. Non è necessario specificare i nomi degli strumenti interni. Spiega all'assistente AI quali informazioni vuoi ottenere sulla tua scuola, classroom o Team e userà Padlet MCP per tuo conto.
Ecco un esempio:

Facoltativo: API di analisi dell'organizzazione
Preferisci creare uno script? Usa la Public API con una chiave API da amministratore (o una chiave da insegnante per una classroom).
- Crea o copia una chiave API dalla pagina Sviluppatore nelle Impostazioni. Per i dettagli, consulta l'articolo Public API.
- Trova l'ID della tua organizzazione con
GET /me?include=organizations. Ti serve un IDwksp_. Per ora, le organizzazioniorg_su padlet.org non sono supportate da questo endpoint. - Invia una richiesta
POSTa/organizations/{org_id}/analyticscon le metriche che vuoi ottenere. - Se la risposta è
202ometa.pendingnon è vuoto, attendi il valore diRetry-Aftere invia di nuovo la richiesta identica. Le analisi vengono calcolate in background, quindi una metrica in attesa non compare nella risposta. Non considerarla mai pari a zero.
Chi può usarlo
Per ora sono supportate solo le organizzazioni
wksp_.Esempi di prompt
Ecco alcuni prompt iniziali da incollare nel tuo client MCP. Modifica la formulazione in base alla tua scuola, classroom o Team e, quando prepari una presentazione destinata ai clienti, verifica i numeri nella pagina Analisi.
- "Per la nostra scuola, in questo periodo di fatturazione, quanti insegnanti sono attivi rispetto alle licenze e in quali mesi c'è stato un calo?"
- "Quali padlet dell'organizzazione hanno più visualizzazioni? Indicami i 3 board/sandbox principali."
- "Quali membri con il ruolo di insegnante non hanno usato Padlet negli ultimi 12 mesi?"
- "Quanti membri non hanno il dominio email <ouremaildomain.edu>?"
Quando la dashboard è ancora la scelta migliore
Usa la pagina Analisi nelle Impostazioni quando vuoi:
- Il banner visivo Panoramica, i suggerimenti sulle opportunità principali e la richiesta di sviluppo professionale con un clic
- La tabella Tutti gli utenti / Utenti con ricerca, filtri per ruolo e download CSV con un clic
- Elenchi scaricabili di insegnanti attivi e inattivi per il periodo selezionato, dalla scheda Panoramica (scuole e classroom)
MCP e l'API sono particolarmente utili quando le schede selezionate non rispondono alla domanda specifica che ti serve per una demo o una trattativa di rinnovo.
Limitazioni:
- Limite di frequenza: 60 richieste all'ora per chiave API e organizzazione, compresi i controlli successivi a una risposta
202 - Intervallo di date: massimo 24 mesi per richiesta
- Sicurezza dei contenuti: solo per scuole e classroom. Per queste metriche, i Team ricevono un errore
400 - Conteggi dei membri: riflettono l'organico attuale, non un'istantanea storica dei membri dell'organizzazione in un determinato momento
- In attesa ≠ zero: una metrica ancora in fase di calcolo non compare nella risposta; non considerarla pari a zero
- Tipo di organizzazione: per ora, solo
wksp_
Domande frequenti
Perché ricevo un errore 404 quando chiedo le analisi?
Tutti i rifiuti appaiono allo stesso modo: sia un'organizzazione sconosciuta sia l'assenza di accesso restituiscono 404. Verifica di aver effettuato l'accesso come amministratore (o come insegnante per una classroom) dell'organizzazione e che questa sia un'organizzazione wksp_. Hai ancora problemi? Contatta l'assistenza.
Devo scrivere codice?
No. Collega Padlet MCP, accedi come amministratore e fai domande in linguaggio semplice. L'API è facoltativa per sviluppatori e utenti esperti che già usano la Public API.
È la stessa cosa della Public API?
Sono correlate, ma non si tratta della stessa interfaccia di prodotto. La Public API è destinata agli sviluppatori che usano una chiave API. Padlet MCP è destinato agli assistenti AI, a cui concedi l'autorizzazione effettuando l'accesso. Entrambi possono accedere alle analisi dell'organizzazione e puoi usare uno dei due o entrambi.
Studenti o utenti non amministratori possono consultare le analisi dell'organizzazione in questo modo?
No. Per accedere alle analisi è necessario essere amministratori dell'organizzazione o insegnanti di una classroom. L'assistente dispone esattamente degli stessi accessi dell'account con cui hai effettuato l'accesso, non di più.
Il mio client MCP sembra non conoscere le analisi. Cosa posso provare?
Alcuni client aggiornano l'elenco degli strumenti con un certo ritardo. Prova a riconnettere Padlet MCP, a passare a un altro client compatibile con MCP oppure a usare direttamente l'API di analisi dell'organizzazione. Se hai ancora problemi, contattaci.
Contenuti correlati
- Server Padlet MCP
- Analisi degli account scolastici
- Analisi degli account Team
- Public API
- Leggere le analisi dell'organizzazione (documentazione per sviluppatori)
