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

Carla Seseのプロフィール写真Carla Seseが16 годин томуに更新

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ось приклад:

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

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

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

  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 і API під час пілотного запуску потрібно активувати окремо. Padlet додає до пілотної програми власника організації — статусу адміністратора недостатньо. Поки вашу організацію не додано до програми, кожен виклик повертатиме помилку 404 (таку саму відповідь, як для невідомої організації).

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

Зверніться до служби підтримки та попросіть додати власника вашої організації до пілотної програми аналітики для адміністраторів.

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

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

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

Що зручніше робити на панелі

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

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

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

Обмеження:

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

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

Чому під час запиту аналітики я отримую помилку 404?

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

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

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

Це те саме, що публічний API?

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

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

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

Схоже, мій MCP-клієнт не підтримує аналітику. Що робити?

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

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

この記事は役に立ちましたか?

関連記事