Как запросить у Padlet MCP аналитику администратора (бета-версия)?

Нужные цифры не представлены в панели администратора школы или Команды так, как вам хотелось бы? Подключите Padlet MCP к ИИ-ассистенту и запросите аналитику по школе, классу или Команде простым языком — или самостоятельно обратитесь к API аналитики организации.

Для кого эта статья

Эта статья предназначена для:

• Владельцев и администраторов аккаунтов Padlet для школ или Команд
• Владельцев и преподавателей аккаунтов Classroom

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

Что уже доступно

На странице «Аналитика» вашей организации в настройках уже есть подборка вкладок с данными за текущий расчетный период. Для школ и классов доступны вкладки «Обзор», «Использование», «Влияние», «Безопасность», «Самые активные пользователи» и «Все пользователи». Для Команд — «Общие сведения», «Padlet» и «Пользователи».

• Аналитика аккаунта школы (Padlet для школ и Classroom)
• Аналитика аккаунта Команды

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

Что дают MCP и API

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

• Задавайте вопросы простым языком в своем ИИ-клиенте («Какие преподаватели не проявляли активности в прошлом расчетном периоде?»)
• Составляйте собственные сочетания метрик вовлеченности, членства и безопасности контента
• Получайте помесячные данные за выбранный период
• Отбирайте данные по ролям (преподаватели и учащиеся, авторы и участники)
• Запрашивайте рейтинги популярных padlet, пользователей и медиа по нужным критериям
• Получайте ответы, которые можно вставить в презентацию для квартального обзора или продления подписки

Быстрый старт с Padlet MCP

1. Подключите Padlet MCP в своем ИИ-клиенте. Используйте URL сервера https://mcp.padlet.com. Полную инструкцию по настройке см. в разделе Сервер Padlet MCP.
2. Войдите в аккаунт и предоставьте доступ от имени администратора организации, данные которой хотите запросить. В Classroom аналитику также может получать преподаватель.
3. Задайте вопрос простым языком. Не нужно указывать названия внутренних инструментов. Скажите ИИ-ассистенту, что вы хотите узнать о своей школе, классе или Команде, и он воспользуется 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-клиент. Измените формулировки с учетом своей школы, класса или Команды. Если готовите презентацию для клиентов, проверьте цифры на странице «Аналитика».

• «Для нашей школы за этот расчетный период: сколько активных преподавателей и сколько лицензий, и в какие месяцы показатели снизились?»
• «Какие padlet нашей организации набрали больше всего просмотров? Покажи топ-3 досок/пространств sandbox».
• «Какие участники с ролью преподавателя не пользовались Padlet последние 12 месяцев?»
• «Сколько участников не используют домен электронной почты <ouremaildomain.edu>?»

В чем панель по-прежнему удобнее

Используйте страницу «Аналитика» в настройках, если вам нужны:

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

MCP и API особенно полезны, когда готовые вкладки не дают точного ответа, нужного для демонстрации или обсуждения продления подписки.

Ограничения:

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

Часто задаваемые вопросы

См. также

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