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

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

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

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

• Владельцев и администраторов аккаунтов Padlet for Schools или Команды
• Владельцев и учителей аккаунтов Classroom

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

Что у вас уже есть

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

• Аналитика аккаунта школы (Padlet for Schools и 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
• Чтение аналитики организации (документация для разработчиков)