Как запросить Admin Analytics в Padlet MCP?
Mis à jour 4 дня назад par Carla SeseНе хватает данных в панели администратора школы или Команды? Подключите Padlet MCP к ИИ-ассистенту и задавайте вопросы об аналитике школы, класса или команды обычным языком либо самостоятельно вызывайте API аналитики организации.
Для кого эта статья
Эта статья предназначена для:
- Владельцев и администраторов аккаунтов Padlet для школ или Команд
- Владельцев и учителей аккаунтов классов
Для работы через MCP не нужно писать код. API — дополнительный вариант для опытных пользователей, которые уже работают с публичным API.
Что у вас уже есть
На странице «Аналитика» вашей организации в настройках уже есть тематические вкладки за текущий расчетный период. Для школ и классов доступны вкладки «Обзор», «Использование», «Влияние», «Безопасность», «Самые активные пользователи» и «Все пользователи». Для Команд доступны вкладки «Общие сведения», «Padlet» и «Пользователи» либо «Обзор», «Использование», «Влияние», «Самые активные пользователи» и «Все пользователи», если в вашей Команде доступна новая страница «Аналитика» (бета-версия).
- Аналитика аккаунта школы (Padlet для школ и классы)
- Аналитика аккаунта Команды
Если вам нужен быстрый визуальный обзор, воспользуйтесь панелью. Если нужны данные в разрезе, которого нет на вкладках, используйте MCP или API.
Что дают MCP и API
На панели собраны тематические вкладки. MCP и API позволяют запросить именно нужные вам данные:
- Задавайте вопросы обычным языком в своем ИИ-клиенте («Какие учителя не проявляли активность в прошлом расчетном периоде?»)
- Сочетайте метрики вовлеченности, состава участников и безопасности контента
- Получайте помесячные данные за выбранный период
- Фильтруйте по ролям (учителя и ученики, авторы и участники)
- Составляйте рейтинги популярных padlet, пользователей и медиа по заданным критериям
- Получайте ответы, которые можно вставить в презентацию для ежеквартального обзора бизнеса или продления подписки
Быстрый старт с Padlet MCP
- Подключите Padlet MCP в своем ИИ-клиенте. URL сервера:
https://mcp.padlet.com. Полные инструкции по настройке см. в статье Сервер Padlet MCP. - Войдите в систему и предоставьте разрешение как администратор организации, данные которой хотите запросить. В классе аналитику также может получать учитель.
- Задавайте вопросы обычным языком. Называть внутренние инструменты не нужно. Скажите ИИ-ассистенту, что хотите узнать о своей школе, классе или команде, и он выполнит запрос через Padlet MCP.
Например:

Дополнительно: API аналитики организации
Предпочитаете написать собственный скрипт? Используйте публичный API с ключом API администратора (или ключом учителя для класса).
- Создайте или скопируйте ключ API на странице для разработчиков в настройках. Подробности — в статье Публичный API.
- Найдите идентификатор организации с помощью
GET /me?include=organizations. Вам нужен идентификаторwksp_. Организацииorg_на padlet.org пока не поддерживаются этой конечной точкой. - Отправьте запрос
POSTна/organizations/{org_id}/analyticsс нужными метриками. - Если ответ содержит код
202или полеmeta.pendingне пустое, дождитесь значенияRetry-Afterи повторно отправьте точно такой же запрос. Аналитика рассчитывается в фоновом режиме, поэтому ожидающая метрика отсутствует в ответе. Никогда не считайте ее нулевой.
Кто может пользоваться
Пока поддерживаются только организации с идентификатором
wksp_.Примеры запросов
Вот несколько примеров запросов, которые можно скопировать в MCP-клиент. Измените формулировки с учетом своей школы, класса или команды и сверяйте цифры со страницей «Аналитика», когда готовите презентацию для клиентов.
- «Сколько учителей проявляли активность в нашей школе в этом расчетном периоде по сравнению с количеством лицензий и в какие месяцы показатели снижались?»
- «У каких padlet организации больше всего просмотров? Покажи три самые популярные доски или пространства sandbox».
- «Кто из участников с ролью учителя не пользовался Padlet последние 12 месяцев?»
- «У скольких участников адрес электронной почты не относится к домену <ouremaildomain.edu>?»
В чем панель по-прежнему удобнее
Воспользуйтесь страницей «Аналитика» в настройках, если вам нужны:
- Визуальный баннер «Обзор», подсказки о лучших возможностях и отправка запроса на повышение квалификации одним нажатием
- Таблица «Все пользователи» / «Пользователи» с поиском, фильтрами по ролям и скачиванием CSV одним нажатием
- Списки активных и неактивных учителей за выбранный период, которые можно скачать на вкладке «Обзор» (для школ и классов)
MCP и API особенно полезны, когда тематические вкладки не дают точного ответа, необходимого для демонстрации или обсуждения продления подписки.
Ограничения:
- Ограничение частоты запросов: 60 запросов в час на ключ API и организацию, включая повторные запросы после ответа
202 - Диапазон дат: не более 24 месяцев в одном запросе
- Безопасность контента: только для школ и классов. Для Команд при запросе этих метрик возвращается ошибка
400 - Количество участников: отражает текущий состав, а не исторический снимок участников на определенную дату
- Ожидание ≠ ноль: метрика, которая еще рассчитывается, отсутствует в ответе; не считайте ее нулевой
- Тип организации: пока поддерживается только
wksp_
Часто задаваемые вопросы
Почему при запросе аналитики я получаю ошибку 404?
Во всех случаях отказ выглядит одинаково: для неизвестной организации и при отсутствии доступа возвращается код 404. Убедитесь, что вы вошли как администратор этой организации (или как учитель в классе) и что у нее идентификатор wksp_. Не помогло? Обратитесь в службу поддержки.
Нужно ли писать код?
Нет. Подключите Padlet MCP, войдите как администратор и задавайте вопросы обычным языком. API — дополнительный вариант для разработчиков и опытных пользователей, которые уже используют публичный API.
Это то же самое, что публичный API?
Эти продукты связаны, но это не одно и то же. Публичный API предназначен для разработчиков, использующих ключ API. Padlet MCP предназначен для ИИ-ассистентов, которым вы предоставляете доступ после входа в систему. Оба способа позволяют получать аналитику организации, и вы можете использовать любой из них или оба.
Могут ли ученики или пользователи без прав администратора просматривать таким способом аналитику организации?
Нет. Для доступа к аналитике требуется быть администратором организации или учителем в классе. Ассистент имеет ровно те же права доступа, что и учетная запись, с которой вы вошли в систему, и не более того.
Кажется, мой MCP-клиент не знает об аналитике. Что попробовать?
Некоторым клиентам требуется время, чтобы обновить список инструментов. Попробуйте переподключить Padlet MCP, переключиться на другой клиент с поддержкой MCP или напрямую воспользоваться API аналитики организации. Если проблема не решилась, свяжитесь с нами.
Связанные материалы
- Сервер Padlet MCP
- Аналитика аккаунта школы
- Аналитика аккаунта Команды
- Публичный API
- Чтение аналитики организации (документация для разработчиков)
