Come posso chiedere a Padlet MCP le analisi dell’amministratore?

Profilbild von Carla SeseVor 4 giorni fa von Carla Sese aktualisiert

Hai 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.

Per consultare la documentazione REST completa (catalogo delle metriche, formati delle richieste e codici di errore), vedi Leggere le analisi dell'organizzazione su docs.padlet.dev.

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.

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
Le metriche di sicurezza dei contenuti (elementi scansionati, elementi segnalati, tasso di rilevamento) sono disponibili solo per scuole e classroom. Se le richiedi per un'organizzazione Team, riceverai un errore, non un valore pari a zero.

Guida rapida a Padlet MCP

  1. 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.
  2. 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.
  3. 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:

Se un particolare client MCP non mostra ancora le risposte alle analisi, prova un altro client compatibile con MCP oppure usa l'API di analisi dell'organizzazione. Il supporto dei client potrebbe non essere ancora aggiornato alle funzionalità del server.
L'assistente opera per tuo conto. Può consultare solo le analisi a cui ha accesso l'account con cui hai effettuato l'accesso.

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).

  1. Crea o copia una chiave API dalla pagina Sviluppatore nelle Impostazioni. Per i dettagli, consulta l'articolo Public API.
  2. Trova l'ID della tua organizzazione con GET /me?include=organizations. Ti serve un ID wksp_. Per ora, le organizzazioni org_ su padlet.org non sono supportate da questo endpoint.
  3. Invia una richiesta POST a /organizations/{org_id}/analytics con le metriche che vuoi ottenere.
  4. Se la risposta è 202 o meta.pending non è vuoto, attendi il valore di Retry-After e 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.
I formati completi delle richieste, il catalogo delle metriche e gli esempi pratici sono disponibili in Leggere le analisi dell'organizzazione.

Chi può usarlo

Le analisi dell'organizzazione tramite Padlet MCP e l'API sono disponibili ai proprietari e agli amministratori degli account Padlet for Schools e Team e ai proprietari e agli insegnanti degli account Classroom. Non è necessario chiedere a Padlet di attivarle.

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>?"
Chiedi il filtro che ti serve: una serie mensile, un filtro per ruolo, i padlet principali in base ai post o ai visitatori oppure i totali relativi alla sicurezza dei contenuti per una scuola o una classroom. L'assistente assocerà la tua domanda alle metriche disponibili.

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

War dieser Artikel hilfreich?

Verwandte Artikel