¿Cómo puedo pedirle a Padlet MCP las analíticas de administrador?

Carla Sese’s profile pictureUpdated hace 4 días by Carla Sese

¿Los números del panel de administración de la escuela o el Equipo no se desglosan como quieres? Conecta Padlet MCP a un asistente de IA y pídele análisis de la escuela, la clase o el Equipo en lenguaje sencillo, o llama por tu cuenta a la API de análisis de organizaciones.

Para consultar la referencia completa de REST (catálogo de métricas, formatos de solicitud y códigos de error), visita Leer análisis de organizaciones en docs.padlet.dev.

Para quién es

Este artículo está dirigido a:

  • Propietarios y administradores de cuentas de Padlet para escuelas o de Equipo
  • Propietarios y docentes de cuentas de clase

No necesitas escribir código para usar la opción de MCP. La opción de la API es optativa para usuarios avanzados que ya trabajan con la API pública.

Lo que ya tienes

La página de Análisis de tu organización en Configuración ya muestra pestañas seleccionadas para el período de facturación actual. Las escuelas y las clases tienen las pestañas Resumen, Uso, Impacto, Seguridad, Usuarios principales y Todos los usuarios. Los Equipos tienen las pestañas General, Padlets y Usuarios; o bien Resumen, Uso, Impacto, Usuarios principales y Todos los usuarios si tu Equipo tiene la nueva página de Análisis (beta).

Usa el panel principal cuando quieras una vista visual rápida. Usa MCP o la API cuando necesites un desglose personalizado que las pestañas no respondan con tanta precisión.

Qué aportan MCP y la API

El panel principal ofrece pestañas seleccionadas. MCP y la API te permiten pedir exactamente el desglose que necesitas:

  • Preguntas en lenguaje sencillo en tu cliente de IA («¿Qué docentes estuvieron inactivos en el último período de facturación?»)
  • Combinaciones personalizadas de métricas de participación, membresía y seguridad del contenido
  • Series mensuales para un intervalo de fechas
  • Desgloses por función (docentes frente a estudiantes, creadores frente a colaboradores)
  • Padlets, usuarios y contenido multimedia principales, clasificados según lo que pidas
  • Respuestas que puedes pegar en una presentación para una reunión de revisión trimestral del negocio o de renovación
Las métricas de seguridad del contenido (elementos analizados, elementos marcados, tasa de detección) están disponibles solo para escuelas y clases. Si las solicitas para una organización de Equipo, se devolverá un error, no un cero.

Inicio rápido con Padlet MCP

  1. Conecta Padlet MCP en tu cliente de IA. Usa la URL del servidor https://mcp.padlet.com. Encontrarás los pasos completos de configuración en Servidor de Padlet MCP.
  2. Inicia sesión y autoriza el acceso como administrador de la organización que quieras consultar. En una clase, un docente también puede obtener análisis.
  3. Pregunta en lenguaje sencillo. No hace falta que menciones herramientas internas. Dile al asistente de IA qué quieres saber sobre tu escuela, clase o Equipo, y usará Padlet MCP en tu nombre.

Este es un ejemplo:

Si un cliente de MCP específico todavía no muestra respuestas de análisis, prueba con otro cliente compatible con MCP o usa la API de análisis de organizaciones. La compatibilidad de los clientes puede tardar en actualizarse con respecto al servidor.
El asistente actúa como tú. Solo puede obtener los análisis que tu cuenta, con la sesión iniciada, tiene permiso para ver.

Opcional: API de análisis de organizaciones

¿Prefieres crear tus propios scripts? Usa la API pública con una clave de API de administrador (o una clave de docente en una clase).

  1. Crea o copia una clave de API desde la página Developer en Configuración. Encontrarás más información en el artículo sobre la API pública.
  2. Busca el ID de tu organización con GET /me?include=organizations. Necesitas un ID wksp_. Las organizaciones org_ de padlet.org aún no son compatibles con este endpoint.
  3. Envía una solicitud POST a /organizations/{org_id}/analytics con las métricas que quieras.
  4. Si la respuesta es 202 o meta.pending no está vacío, espera el tiempo indicado en Retry-After y vuelve a enviar la solicitud idéntica. Los análisis se calculan en segundo plano, por lo que una métrica pendiente no aparece en la respuesta. Nunca la consideres como cero.
Encontrarás los formatos completos de las solicitudes, el catálogo de métricas y ejemplos detallados en Leer análisis de organizaciones.

Quiénes pueden usarlo

Los análisis de organizaciones a través de Padlet MCP y la API están disponibles para propietarios y administradores de cuentas de Padlet para escuelas y de Equipo, y para propietarios y docentes de cuentas de clase. No necesitas pedirle a Padlet que los habilite.

Por ahora, solo se admiten organizaciones wksp_.

Ejemplos de instrucciones

Estas son instrucciones iniciales que puedes pegar en tu cliente de MCP. Adapta el texto a tu escuela, clase o Equipo, y comprueba las cifras en la página de Análisis cuando prepares una presentación para clientes.

  • «En nuestra escuela, durante este período de facturación, ¿cuántos docentes estuvieron activos en comparación con el número de licencias? ¿Y en qué meses hubo una caída?»
  • «¿Qué padlets de nuestra organización tienen más visitas? Dame los 3 principales tableros/sandbox»
  • «¿Qué miembros con la función de docente no han usado Padlet en los últimos 12 meses?»
  • «¿Cuántos miembros no tienen el dominio de correo electrónico <ouremaildomain.edu>?»
Pide el desglose que necesites: una serie mensual, un filtro por función, los padlets con más publicaciones o visitantes, o los totales de seguridad del contenido de una escuela o clase. El asistente relacionará tu pregunta con las métricas disponibles.

Qué sigue haciendo mejor el panel principal

Usa la página de Análisis en Configuración cuando quieras:

  • El banner visual de Resumen, los avisos de Mejores oportunidades y la solicitud de desarrollo profesional con un solo clic
  • La tabla Todos los usuarios/Usuarios con búsqueda, filtros por función y descarga de CSV con un solo clic
  • Listas descargables de docentes activos e inactivos para el período seleccionado, desde la pestaña Resumen (escuelas y clases)

MCP y la API son especialmente útiles cuando las pestañas seleccionadas no responden a la pregunta exacta que necesitas para una demostración o una conversación de renovación.

Limitaciones:

  • Límite de solicitudes: 60 solicitudes por hora por clave de API y organización, incluidas las consultas repetidas tras una respuesta 202
  • Intervalo de fechas: máximo 24 meses en una solicitud
  • Seguridad del contenido: solo para escuelas y clases. Los Equipos reciben un error 400 al solicitar esas métricas
  • Recuentos de miembros: reflejan la lista de miembros actual, no una instantánea histórica de quiénes pertenecían a la organización en ese momento
  • Pendiente ≠ cero: una métrica que aún se está calculando no aparece en la respuesta; no la consideres como cero
  • Tipo de organización: por ahora, solo wksp_

Preguntas frecuentes

¿Por qué recibo un error 404 al solicitar análisis?

Todos los rechazos se ven igual: tanto si la organización no existe como si no tienes acceso, se devuelve un error 404. Comprueba que hayas iniciado sesión como administrador (o como docente en una clase) de esa organización y que sea una organización wksp_. ¿Sigues teniendo problemas? Comunícate con el equipo de soporte.

¿Tengo que escribir código?

No. Conecta Padlet MCP, inicia sesión como administrador y pregunta en lenguaje sencillo. La opción de la API es optativa para desarrolladores y usuarios avanzados que ya usan la API pública.

¿Es lo mismo que la API pública?

Están relacionadas, pero no son la misma interfaz de producto. La API pública está dirigida a desarrolladores que usan una clave de API. Padlet MCP está pensado para asistentes de IA a los que autorizas al iniciar sesión. Ambos permiten acceder a los análisis de organizaciones, y puedes usar uno o los dos.

¿Pueden ver los análisis de organizaciones los estudiantes o quienes no sean administradores?

No. Para ver los análisis, se requiere ser administrador de la organización o docente de una clase. El asistente tiene exactamente el mismo acceso que la cuenta con la que iniciaste sesión, ni más ni menos.

Mi cliente de MCP no parece tener información sobre los análisis. ¿Qué puedo probar?

Algunos clientes tardan en actualizar su lista de herramientas. Prueba a volver a conectar Padlet MCP, cambiar a otro cliente compatible con MCP o usar directamente la API de análisis de organizaciones. Si sigues teniendo problemas, ponte en contacto con nosotros.

Artículos relacionados

Was this article helpful?

Related articles