Як звернутися до Padlet MCP щодо Admin Analytics (бета-версія)?

Потрібні дані, які панель адміністратора школи чи команди не групує так, як вам потрібно? Підключіть Padlet MCP до AI-помічника та попросіть надати аналітику щодо школи, класу чи команди простою мовою — або самостійно зверніться до API організаційної аналітики.

Для кого призначена ця стаття

Ця стаття призначена для:

• Власників та адміністраторів облікових записів Padlet для шкіл або команд
• Власників та вчителів облікових записів Classroom

Для використання шляху MCP не потрібно писати код. Цей шлях API є необов’язковим для досвідчених користувачів, які вже працюють із публічним API.

Що у вас вже є

На сторінці «Аналітика» вашої організації в розділі «Налаштування» вже відображаються відібрані вкладки для поточного розрахункового періоду. Школи та класи мають вкладки «Огляд», «Використання», «Вплив», «Безпека», «Найактивніші користувачі» та «Усі користувачі». Команди мають вкладки «Загальне», «Padlets» та «Користувачі».

• Аналітика облікових записів шкіл (Padlet for Schools та Classroom)
• Аналітика облікового запису команди

Користуйтеся інформаційною панеллю, коли вам потрібна швидка візуальна картина. Використовуйте MCP або API, коли вам потрібні індивідуальні дані, які вкладки не відображають достатньо чітко.

Що додають MCP / API

Панель інструментів — це відібрані вкладки. MCP та API дозволяють отримати саме ті дані, які вам потрібні:

• Запитання простою мовою у вашому AI-клієнті («які вчителі були неактивними протягом останнього розрахункового періоду?»)
• Індивідуальні комбінації показників залученості, членства та безпеки контенту
• Щомісячні серії за певний діапазон дат
• Зрізи за ролями (викладачі проти студентів, творці проти авторів)
• Найпопулярніші Padlets, користувачі та медіа, відсортовані відповідно до ваших запитів
• Відповіді, які можна вставити у звіт про результати кварталу (QBR) або презентацію щодо продовження підписки

Швидкий старт із Padlet MCP

1. Підключіть Padlet MCP у вашому AI-клієнті. Використовуйте URL-адресу сервера https://mcp.padlet.com. Повні інструкції з налаштування наведені в розділі «Сервер Padlet MCP».
2. Увійдіть та авторизуйтеся як адміністратор організації, щодо якої ви хочете отримати дані. У класі вчитель також може отримати аналітику.
3. Задавайте запити простою мовою. Не потрібно називати внутрішні інструменти. Скажіть AI-помічнику, що ви хочете дізнатися про свою школу, клас або команду, і він скористається Padlet MCP від вашого імені.

Ось приклад:

Додатково: API аналітики організації

Хочете написати скрипт самостійно? Використовуйте публічний API з ключем API адміністратора (або ключем вчителя у Classroom).

1. Створіть або скопіюйте ключ API на сторінці «Розробник» у ваших налаштуваннях. Детальніше — у статті про публічний API.
2. Знайдіть ідентифікатор вашої організації за допомогою GET /me?include=organizations. Вам потрібен wksp_ ідентифікатор — org_ організації на padlet.org поки що не підтримуються для цього кінцевого пункту.
3. Надішліть POST на /organizations/{org_id}/analytics з потрібними показниками.
4. Якщо відповідь така: 202 або meta.pending непорожня, зачекайте Retry-After і надішліть ідентичний запит ще раз. Аналітика обчислюється асинхронно — показник у стані очікування означає відсутність, а не нуль. Ніколи не вважайте стан очікування рівним нулю.

Пілотний доступ

Приклади запитів

Ось кілька прикладів, які ви можете вставити у свій клієнт MCP. Налаштуйте формулювання відповідно до вашої школи, класу чи команди — і звіряйте цифри зі сторінкою «Аналітика», коли готуєте презентацію для клієнтів.

• «Скільки активних вчителів та ліцензій у нашій школі за цей розрахунковий період, і в яких місяцях спостерігалося зниження?»
• «Які дошки організації мають найбільшу кількість переглядів? Наведіть 3 найпопулярніші дошки/тестові дошки».
• «Які учасники з роллю вчителя не користувалися Padlet протягом останніх 12 місяців?»
• «Скільки учасників не мають домену електронної пошти <ouremaildomain.edu>?»

У чому панель управління все ще перевершує інші інструменти

Користуйтеся сторінкою «Аналітика» в налаштуваннях, коли вам потрібно:

• Візуальний банер «Огляд», виокремлені найважливіші можливості та запит на професійний розвиток одним кліком
• Таблиця «Усі користувачі / Користувачі» з пошуком, фільтрами за ролями та завантаженням у формат CSV одним кліком
• Списки активних та неактивних вчителів за вибраний період, які можна завантажити з вкладки «Огляд» (школи та класи)
• Перегляд, який не потребує реєстрації в пілотному проекті — сама сторінка «Налаштування» доступна для відповідних ролей без необхідності підключення API

MCP та API стають особливо корисними, коли підібрані вкладки не дають точної відповіді на питання, яке вам потрібно для демонстрації або переговорів щодо поновлення.

Обмеження:

• Обмеження частоти запитів: 60 запитів на годину на кожен ключ API та організацію, включаючи опитування після 202
• Діапазон дат: не більше 24 місяців у одному запиті
• Безпека вмісту: лише школи та класи — Teams отримує 400 для цих показників
• Кількість учасників: відображає поточний список, а не історичний знімок того, хто належав до команди на той момент
• «У процесі обробки» ≠ нуль: показник, який ще обчислюється, відсутній у відповіді; не слід трактувати його як нуль
• Тип організації: wksp_ лише на даний момент

Поширені запитання

Пов’язані матеріали

• Сервер Padlet MCP
• Аналітика шкільного облікового запису
• Аналітика облікового запису команди
• Публічний API
• Читання аналітики організації (документація для розробників)