Як попросити Padlet MCP надати аналітику адміністратора?

Profilbildet til Carla SeseOppdatert 4 дні тому av Carla Sese

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

Повний довідник REST API (каталог показників, формати запитів і коди помилок) див. у розділі Читання аналітики організації на docs.padlet.dev.

Для кого ця стаття

Ця стаття для:

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

Щоб скористатися MCP, писати код не потрібно. API — необов’язковий варіант для досвідчених користувачів, які вже працюють із Public API.

Що вже доступно

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

Коли потрібен швидкий візуальний огляд, скористайтеся панеллю. Якщо потрібен власний зріз даних, на який вкладки не дають чіткої відповіді, скористайтеся MCP або API.

Що дають MCP та API

На панелі є добірка вкладок. MCP та API дають змогу запросити саме потрібний зріз даних:

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

Швидкий початок роботи з Padlet MCP

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

Ось приклад:

Якщо ваш MCP-клієнт поки що не показує відповіді з аналітики, спробуйте інший клієнт, сумісний із MCP, або скористайтеся API аналітики організації. Підтримка з боку клієнтів може з’явитися із затримкою.
Асистент діє від вашого імені. Він може отримувати лише ту аналітику, яку дозволено переглядати обліковому запису, у який ви ввійшли.

Необов’язково: API аналітики організації

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

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

Хто може користуватися

Аналітика організації через Padlet MCP і API доступна власникам і адміністраторам облікових записів Padlet for Schools і Team, а також власникам і вчителям облікових записів Classroom. Просити Padlet активувати цю функцію не потрібно.

Наразі підтримуються лише організації wksp_.

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

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

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

У чому панель усе ще краща

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

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

MCP та API особливо корисні, коли добірка вкладок не дає відповіді на конкретне запитання для демонстрації чи розмови про продовження підписки.

Обмеження:

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

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

Чому під час запиту аналітики з’являється помилка 404?

У всіх випадках відмови повертається однакова відповідь: і невідома організація, і відсутність доступу дають помилку 404. Переконайтеся, що ви ввійшли як адміністратор цієї організації (або як учитель у Classroom) і що її ідентифікатор починається з wksp_. Не вдається розв’язати проблему? Зверніться до служби підтримки.

Чи потрібно писати код?

Ні. Під’єднайте Padlet MCP, увійдіть як адміністратор і ставте запитання звичайною мовою. API — необов’язковий варіант для розробників і досвідчених користувачів, які вже користуються Public API.

Це те саме, що Public API?

Ці продукти пов’язані, але це не одне й те саме. Public API призначений для розробників, які використовують API-ключ. Padlet MCP призначений для AI-асистентів, яким ви надаєте доступ після входу. Обидва дають змогу отримувати аналітику організації, тож можете користуватися будь-яким із них або обома.

Чи можуть учні або користувачі без прав адміністратора переглядати аналітику організації в такий спосіб?

Ні. Для перегляду аналітики потрібні права адміністратора організації або роль учителя в Classroom. Асистент має ті самі права доступу, що й обліковий запис, у який ви ввійшли, і не більше.

Здається, мій MCP-клієнт не знає про аналітику. Що робити?

Деякі клієнти оновлюють список інструментів із затримкою. Спробуйте повторно під’єднати Padlet MCP, перейти на інший клієнт, сумісний із MCP, або скористатися безпосередньо API аналітики організації. Якщо проблему не вдалося розв’язати, зв’яжіться з нами.

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

Var denne artikkelen nyttig?

Relaterte artikler