Come posso chiedere a Padlet MCP le analisi per gli amministratori (Beta)?
Vor 13 ore fa von Carla Sese aktualisiertI dati presenti nella dashboard amministrativa della scuola o del team non sono suddivisi nel modo desiderato? Collega Padlet MCP a un assistente AI e richiedi le analisi relative alla scuola, alla classe o al team in linguaggio semplice, oppure chiama direttamente l’API delle analisi organizzative.
A chi è rivolto
Questo articolo è rivolto a:
- Proprietari e amministratori di account Padlet for Schools o Team
- Proprietari e insegnanti con account Classroom
Non è necessario scrivere codice per utilizzare il percorso MCP. Il percorso API è facoltativo per gli utenti esperti che già utilizzano l’API pubblica.
Cosa hai già a disposizione
La pagina "Analisi" della tua organizzazione, accessibile da "Impostazioni", mostra già delle schede selezionate relative al periodo di fatturazione corrente. Le scuole e le classi hanno a disposizione le schede Panoramica, Utilizzo, Impatto, Sicurezza, Utenti principali e Tutti gli utenti. I team hanno a disposizione le schede Generale, Padlet e Utenti.
- Analisi degli account scolastici (Padlet for Schools e Classroom)
- Analisi degli account Team
Utilizza la dashboard quando desideri una rapida panoramica visiva. Utilizza MCP o l’API quando hai bisogno di una visione personalizzata che le schede non riescono a fornire in modo chiaro.
Cosa aggiungono MCP e API
La dashboard è costituita da schede predefinite. MCP e l’API ti consentono di richiedere esattamente la panoramica di cui hai bisogno:
- Domande in linguaggio semplice nel tuo client AI ("quali insegnanti sono stati inattivi nell'ultimo periodo di fatturazione?")
- Combinazioni personalizzate di metriche relative al coinvolgimento, all’iscrizione e alla sicurezza dei contenuti
- Serie mensili relative a un intervallo di date
- Fette per ruolo (insegnanti vs studenti, creatori vs collaboratori)
- I padlet più popolari, gli utenti più attivi e i contenuti multimediali più visualizzati, classificati in base alle tue richieste
- Risposte che puoi incollare in un QBR o in una presentazione per il rinnovo
Guida rapida a Padlet MCP
- Collega Padlet MCP al tuo client AI. Utilizza l’URL del server
https://mcp.padlet.com. I passaggi completi per la configurazione sono disponibili in Padlet MCP Server. - Accedi e autorizza l’operazione come amministratore dell’organizzazione che desideri interrogare. In una classe, anche un insegnante può estrarre le analisi.
- Formula la richiesta in linguaggio naturale. Non è necessario menzionare gli strumenti interni. Spiega all’assistente AI cosa desideri sapere sulla tua scuola, classe o team, e lui utilizzerà Padlet MCP per tuo conto.
Ecco un esempio:
Opzionale: API di analisi dell’organizzazione
Preferisci creare uno script da solo? Utilizza l’API pubblica con una chiave API da amministratore (o una chiave da insegnante su Classroom).
- Crea o copia una chiave API dalla pagina "Sviluppatori" nelle tue Impostazioni. Trovi i dettagli nell’articolo sull’API pubblica.
- Trova l’ID della tua organizzazione con
GET /me?include=organizations. Ti serve unwksp_ID —org_le organizzazioni su padlet.org non sono ancora supportate per questo endpoint. - Invia un
POSTa/organizations/{org_id}/analyticscon le metriche desiderate. - Se la risposta è
202ometa.pendingnon è vuota, attendiRetry-Aftere inviare nuovamente la stessa richiesta. Le analisi vengono calcolate in modo asincrono: una metrica in sospeso è assente, non pari a zero. Non considerare mai "in sospeso" come zero.
Accesso alla fase pilota
404 (la stessa risposta che si otterrebbe per un’organizzazione sconosciuta).Per ora sono supportate solo
wksp_ organizzazioni.Contatta l’assistenza e chiedi loro di registrare il proprietario della tua organizzazione per le analisi amministrative.
Esempi di prompt
Questi sono spunti iniziali che puoi incollare nel tuo client MCP. Adatta il testo in base alla tua scuola, classe o squadra e verifica i numeri confrontandoli con la pagina Analisi quando prepari una presentazione per i clienti.
- "Per la nostra scuola, in questo periodo di fatturazione, quanti insegnanti attivi ci sono rispetto alle licenze e in quali mesi si è registrato un calo?"
- "Quali Padlet dell’organizzazione hanno il maggior numero di visualizzazioni? Indica le prime 3 bacheche/aree di prova."
- "Quali membri con il ruolo di insegnante non hanno utilizzato Padlet negli ultimi 12 mesi?"
- "Quanti membri non hanno il dominio e-mail <ouremaildomain.edu>?"
Cosa fa ancora meglio la dashboard
Utilizza la pagina “Analisi” nelle Impostazioni quando desideri:
- Il banner visivo "Panoramica", i riquadri delle opportunità principali e la richiesta di formazione professionale con un solo clic
- La tabella "Tutti gli utenti / Utenti" con ricerca, filtri per ruolo e download CSV con un solo clic
- Elenchi scaricabili di insegnanti attivi e inattivi per il periodo selezionato, dalla scheda Panoramica (scuole e classi)
- Una visualizzazione che non richiede l’iscrizione al programma pilota: la pagina “Impostazioni” stessa è disponibile per i ruoli idonei senza necessità di abilitazione API
MCP e l’API danno il meglio di sé quando le schede predefinite non rispondono esattamente alla domanda di cui hai bisogno per una demo o una conversazione sul rinnovo.
Limitazioni:
- Limite di rate: 60 richieste all’ora per chiave API e organizzazione, inclusi i sondaggi dopo un
202 - Intervallo di date: al massimo 24 mesi in una singola richiesta
- Sicurezza dei contenuti: solo scuole e classi — I team ottengono un
400per quelle metriche - Numero di iscritti: riflette l’elenco attuale, non un’istantanea storica di chi ne faceva parte in quel momento
- "In sospeso" ≠ zero: una metrica ancora in fase di calcolo non è presente nella risposta; non considerarla pari a zero
- Tipo di organizzazione:
wksp_solo per ora
Domande frequenti
Perché ricevo un errore 404 quando richiedo i dati analitici?
Finché l’endpoint è in fase pilota, ogni errore appare uguale: “non registrato”, “organizzazione sconosciuta” o “nessun accesso” sono i messaggi restituiti 404. Verifica di aver effettuato l'accesso come amministratore (o insegnante su Classroom), che la tua organizzazione sia un' wksp_ organizzazione e che Padlet abbia registrato il proprietario dell’organizzazione. Contatta l’assistenza per richiedere la registrazione.
Devo scrivere del codice?
No. Collega Padlet MCP, accedi come amministratore e formula la richiesta in linguaggio semplice. Il percorso API è facoltativo per gli sviluppatori e gli utenti esperti che utilizzano già l’API pubblica.
È la stessa cosa dell’API pubblica?
È correlata, ma non si tratta della stessa interfaccia di prodotto. L’API pubblica è destinata agli sviluppatori che utilizzano una chiave API. Padlet MCP è destinato agli assistenti AI che autorizzi effettuando l’accesso. Entrambi possono accedere alle analisi dell’organizzazione una volta che questa è stata registrata; puoi utilizzare l’uno o l’altro oppure entrambi.
Gli studenti o gli utenti non amministratori possono visualizzare le analisi dell’organizzazione in questo modo?
No. Le analisi richiedono un amministratore dell’organizzazione o un insegnante su Classroom. L’assistente ha esattamente lo stesso accesso dell’account con cui hai effettuato l’accesso — niente di più.
Il mio client MCP sembra non riconoscere le statistiche. Cosa posso provare a fare?
Alcuni client aggiornano l’elenco degli strumenti con un certo ritardo. Prova a ricollegare Padlet MCP, a passare a un altro client compatibile con MCP o a utilizzare direttamente l’API delle analisi dell’organizzazione. Se dopo la registrazione continui a riscontrare problemi, contattaci.
Correlati
- Server Padlet MCP
- Analisi degli account scolastici
- Analisi dell'account di team
- API pubblica
- Leggi le analisi dell'organizzazione (documentazione per sviluppatori)
