Come faccio a chiedere ad Admin Analytics (Beta) di Padlet MCP?

I numeri nella dashboard amministrativa della scuola o del Team non sono suddivisi come vorresti? Collega Padlet MCP a un assistente AI e chiedi analisi della scuola, del classroom o del Team in linguaggio naturale, oppure richiama 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 è necessario scrivere codice per usare 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 curate per il periodo di fatturazione corrente. Le scuole e i 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 per una rapida panoramica visiva. Usa MCP o l'API quando ti serve una suddivisione personalizzata a cui le schede non rispondono in modo chiaro.

Cosa aggiungono MCP e l'API

La dashboard offre schede curate. MCP e l'API ti permettono di chiedere esattamente la suddivisione che ti serve:

• Domande in linguaggio naturale 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 in un intervallo di date
• Suddivisioni per ruolo (insegnanti rispetto a studenti, creatori rispetto a collaboratori)
• Padlet, utenti e contenuti multimediali più popolari, classificati secondo i criteri richiesti
• Risposte da inserire in una presentazione per una QBR o un rinnovo

Avvio rapido con Padlet MCP

1. Collega Padlet MCP nel tuo client AI. Usa l'URL del server https://mcp.padlet.com. Trovi tutte le istruzioni di configurazione in Server Padlet MCP.
2. Accedi e autorizza l'accesso come amministratore dell'organizzazione che vuoi interrogare. In un Classroom, anche un insegnante può richiedere analisi.
3. Fai domande in linguaggio naturale. Non è necessario indicare il nome degli strumenti interni. Spiega all'assistente AI cosa vuoi sapere sulla tua scuola, sul tuo classroom o sul tuo 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 un 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_: al momento gli ID di organizzazioni org_ su padlet.org non sono supportati da questo endpoint.
3. Invia una richiesta POST a /organizations/{org_id}/analytics con le metriche che ti interessano.
4. Se la risposta è 202 o meta.pending non è vuoto, attendi il tempo indicato da Retry-After e invia di nuovo la richiesta identica. Le analisi vengono calcolate in modo asincrono: una metrica in attesa non è presente, non è pari a zero. Non considerare mai un risultato in attesa come zero.

Accesso al programma pilota

Esempi di prompt

Ecco alcuni prompt iniziali da incollare nel tuo client MCP. Adatta la formulazione alla tua scuola, al tuo classroom o al tuo 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 al numero di licenze e in quali mesi si è registrato un calo?"
• "Quali padlet dell'organizzazione hanno più visualizzazioni? Dammi i primi 3 board/sandbox."
• "Quali membri con il ruolo di insegnante non hanno usato Padlet negli ultimi 12 mesi?"
• "Quanti membri non hanno un indirizzo del dominio email <ouremaildomain.edu>?"

Quando la dashboard è ancora la scelta migliore

Usa la pagina Analisi nelle Impostazioni se ti servono:

• Il banner visivo Panoramica, le segnalazioni sulle principali opportunità 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 clic
• Elenchi scaricabili degli insegnanti attivi e inattivi per il periodo selezionato, dalla scheda Panoramica (scuole e classroom)
• Una vista che non richiede l'abilitazione al programma pilota: la pagina Impostazioni è disponibile ai ruoli idonei senza dover attivare l'accesso API

MCP e l'API sono particolarmente utili quando le schede curate non rispondono alla domanda specifica che ti serve per una demo o una conversazione sul rinnovo.

Limitazioni:

• Limite di richieste: 60 richieste all'ora per chiave API e organizzazione, inclusi i tentativi 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
• Conteggio dei membri: riflette l'elenco attuale dei membri, non una fotografia storica di chi ne faceva parte in quel momento
• In attesa ≠ zero: una metrica ancora in fase di calcolo non è inclusa nella risposta; non considerarla zero
• Tipo di organizzazione: al momento sono supportate solo le organizzazioni wksp_

Domande frequenti

Articoli correlati

• Server Padlet MCP
• Analisi degli account scolastici
• Analisi degli account Team
• Public API
• Leggere le analisi dell'organizzazione (documentazione per sviluppatori)