Comment demander à Padlet MCP les analyses administrateur (bêta) ?
Mis à jour il y a 13 heures par Carla SeseLes chiffres du tableau de bord d'administration de votre établissement scolaire ou de votre équipe ne sont pas présentés comme vous le souhaitez ? Connectez Padlet MCP à un assistant IA et demandez-lui des analyses sur votre établissement scolaire, votre salle de classe ou votre équipe en langage courant, ou appelez vous-même l'API d'analyse de l'organisation.
À qui s'adresse cet article ?
Cet article s'adresse :
- aux propriétaires et administrateurs des comptes Padlet pour les établissements scolaires ou Équipe
- aux propriétaires et enseignants des comptes de salle de classe
Vous n'avez pas besoin d'écrire du code pour utiliser la méthode MCP. La méthode API est facultative pour les utilisateurs avancés qui utilisent déjà l'API publique.
Ce dont vous disposez déjà
La page Analytiques de votre organisation, dans les Paramètres, affiche déjà des onglets sélectionnés pour la période de facturation en cours. Les établissements scolaires et les salles de classe disposent des onglets Vue d'ensemble, Utilisation, Impact, Sécurité, Utilisateurs principaux et Tous les utilisateurs. Les équipes disposent des onglets Général, Padlets et Utilisateurs.
- Données analytiques d'un compte d'établissement scolaire (Padlet pour les établissements scolaires et salle de classe)
- Données analytiques d'un compte d'équipe
Utilisez le tableau de bord pour obtenir rapidement un aperçu visuel. Utilisez MCP ou l'API lorsque vous avez besoin d'un angle d'analyse personnalisé auquel les onglets ne répondent pas aussi clairement.
Ce qu'apportent MCP et l'API
Le tableau de bord propose des onglets sélectionnés. MCP et l'API vous permettent de demander exactement l'angle d'analyse dont vous avez besoin :
- Des questions en langage courant dans votre client IA (« Quels enseignants ont été inactifs lors de la dernière période de facturation ? »)
- Des combinaisons personnalisées de métriques d'engagement, d'effectifs et de sécurité du contenu
- Des séries mensuelles sur une plage de dates
- Des filtres par rôle (enseignants ou élèves, créateurs ou contributeurs)
- Les padlets, utilisateurs et médias les plus populaires, classés selon vos critères
- Des réponses que vous pouvez copier dans une présentation de revue trimestrielle ou de renouvellement
Prise en main rapide de Padlet MCP
- Connectez Padlet MCP à votre client IA. Utilisez l'URL du serveur
https://mcp.padlet.com. Consultez Serveur Padlet MCP pour connaître toutes les étapes de configuration. - Connectez-vous et autorisez l'accès en tant qu'administrateur de l'organisation sur laquelle vous souhaitez effectuer des recherches. Dans une salle de classe, un enseignant peut également consulter les données analytiques.
- Posez votre question en langage courant. Vous n'avez pas besoin de nommer les outils internes. Dites à l'assistant IA ce que vous voulez savoir sur votre établissement scolaire, votre salle de classe ou votre équipe ; il utilisera Padlet MCP pour vous.
Voici un exemple :
Facultatif : API d'analyse de l'organisation
Vous préférez créer votre propre script ? Utilisez l'API publique avec une clé API d'administrateur (ou une clé d'enseignant dans une salle de classe).
- Créez ou copiez une clé API depuis la page Développeur de vos Paramètres. Consultez l'article sur l'API publique pour en savoir plus.
- Trouvez l'identifiant de votre organisation avec
GET /me?include=organizations. Vous avez besoin d'un identifiantwksp_: les organisationsorg_sur padlet.org ne sont pas encore prises en charge pour ce point de terminaison. - Envoyez une requête
POSTà/organizations/{org_id}/analyticsen indiquant les métriques souhaitées. - Si la réponse est
202ou simeta.pendingn'est pas vide, attendez le délai indiqué dansRetry-After, puis renvoyez une requête identique. Les données analytiques sont calculées de manière asynchrone : une métrique en attente est absente, et non égale à zéro. Ne considérez jamais une métrique en attente comme égale à zéro.
Accès au programme pilote
404 (la même réponse que pour une organisation inconnue).Pour l'instant, seules les organisations
wksp_ sont prises en charge.Contactez l'assistance et demandez l'inscription du propriétaire de votre organisation à l'accès aux données analytiques d'administration.
Exemples de requêtes
Voici quelques exemples à copier dans votre client MCP. Adaptez la formulation à votre établissement scolaire, votre salle de classe ou votre équipe, et vérifiez les chiffres sur la page Analytiques lorsque vous préparez une présentation destinée à un client.
- « Pour notre établissement scolaire, au cours de cette période de facturation, combien d'enseignants ont été actifs par rapport au nombre de licences, et quels mois ont connu une baisse ? »
- « Quels padlets de notre organisation ont le plus de vues ? Donne-moi les 3 tableaux/sandbox les plus populaires. »
- « Quels membres ayant un rôle d'enseignant n'ont pas utilisé Padlet au cours des 12 derniers mois ? »
- « Combien de membres n'ont pas l'adresse e-mail du domaine <ouremaildomain.edu> ? »
Ce que le tableau de bord fait toujours mieux
Utilisez la page Analytiques des Paramètres si vous souhaitez :
- La bannière visuelle de la vue d'ensemble, les alertes sur les principales opportunités et la possibilité de demander une formation professionnelle en un clic
- Le tableau Tous les utilisateurs / Utilisateurs avec recherche, filtres par rôle et téléchargement CSV en un clic
- Des listes téléchargeables des enseignants actifs et inactifs pour la période sélectionnée, depuis l'onglet Vue d'ensemble (établissements scolaires et salles de classe)
- Une vue qui ne nécessite pas d'inscription au programme pilote : la page Paramètres est accessible aux rôles autorisés sans activation de l'accès à l'API
MCP et l'API sont particulièrement utiles lorsque les onglets sélectionnés ne répondent pas à la question précise que vous vous posez pour une démonstration ou une discussion sur le renouvellement.
Limites :
- Limitation du débit : 60 requêtes par heure et par clé API et organisation, y compris les vérifications après une réponse
202 - Plage de dates : 24 mois maximum par requête
- Sécurité du contenu : établissements scolaires et salles de classe uniquement — les équipes reçoivent une erreur
400pour ces métriques - Nombre de membres : correspond à la liste des membres actuelle, et non à un instantané historique des personnes qui en faisaient partie à l'époque
- En attente ≠ zéro : une métrique dont le calcul est en cours est absente de la réponse ; ne la considérez pas comme égale à zéro
- Type d'organisation : uniquement
wksp_pour l'instant
FAQ
Pourquoi est-ce que je reçois une erreur 404 lorsque je demande des données analytiques ?
Pendant le programme pilote, toutes les demandes refusées renvoient la même réponse : organisation non inscrite, inconnue ou accès refusé, elles renvoient toutes 404. Vérifiez que vous êtes connecté en tant qu'administrateur (ou enseignant dans une salle de classe), que votre organisation est de type wksp_ et que Padlet a inscrit le propriétaire de l'organisation. Contactez l'assistance pour demander l'inscription.
Dois-je écrire du code ?
Non. Connectez Padlet MCP, connectez-vous en tant qu'administrateur et posez votre question en langage courant. La méthode API est facultative pour les développeurs et les utilisateurs avancés qui utilisent déjà l'API publique.
Est-ce la même chose que l'API publique ?
Les deux sont liées, mais il ne s'agit pas de la même interface produit. L'API publique s'adresse aux développeurs qui utilisent une clé API. Padlet MCP est destiné aux assistants IA auxquels vous accordez l'accès en vous connectant. Les deux permettent d'accéder aux données analytiques de l'organisation une fois celle-ci inscrite ; vous pouvez utiliser l'un, l'autre ou les deux.
Les élèves ou les personnes qui ne sont pas administratrices peuvent-ils consulter les données analytiques de l'organisation de cette manière ?
Non. Pour consulter les données analytiques, il faut être administrateur de l'organisation ou enseignant dans une salle de classe. L'assistant dispose exactement des mêmes droits que le compte utilisé pour vous connecter, et de rien de plus.
Mon client MCP ne semble pas connaître les données analytiques. Que puis-je essayer ?
Certains clients mettent à jour leur liste d'outils avec un délai. Essayez de reconnecter Padlet MCP, de passer à un autre client compatible avec MCP ou d'utiliser directement l'API d'analyse de l'organisation. Si vous ne parvenez toujours pas à y accéder après l'inscription, contactez-nous.
