如何向 Padlet MCP 请求管理员分析数据?

Profilová fotka používateľa Carla SeseAktualizované 4天前 používateľom Carla Sese

学校或团队的管理员仪表板无法按你想要的方式筛选数据?将 Padlet MCP 连接到 AI 助手,用日常语言查询学校、班级或团队分析数据;你也可以直接调用组织分析 API。

如需查看完整的 REST 参考文档(指标目录、请求格式和错误代码),请参阅 docs.padlet.dev 上的读取组织分析数据。

适用对象

本文适用于:

  • Padlet for Schools 或团队账户的所有者和管理员
  • 班级账户的所有者和教师

使用 MCP 方式无需编写代码。API 方式是可选的,适合已经使用公共 API的高级用户。

你已有的功能

组织在“设置”中的分析页面已提供精心整理的标签页,展示当前计费周期的数据。学校和班级账户包含“概览”“使用情况”“影响”“安全”“热门用户”和“所有用户”。团队账户包含“常规”“Padlet”和“用户”;如果你的团队已启用新版分析页面(测试版),则包含“概览”“使用情况”“影响”“热门用户”和“所有用户”。

想快速查看直观的数据概览时,请使用仪表板。如果标签页无法清晰回答你的问题,需要自定义筛选数据时,请使用 MCP 或 API。

MCP / API 的额外功能

仪表板提供精心整理的标签页。借助 MCP 和 API,你可以精准查询所需的数据:

  • 在 AI 客户端中用日常语言提问(“上个计费周期有哪些教师没有活动?”)
  • 自定义组合参与度、成员身份和内容安全指标
  • 查询特定日期范围内的月度数据序列
  • 按角色筛选(教师与学生、创作者与贡献者)
  • 按你指定的方式排列热门 padlet、热门用户和热门媒体
  • 获取可粘贴到季度业务回顾(QBR)或续约演示文稿中的答案
内容安全指标(已扫描项目、已标记项目、检出率)仅适用于学校和班级。在团队组织中查询这些指标会返回错误,而不是 0。

快速开始使用 Padlet MCP

  1. 在 AI 客户端中连接 Padlet MCP。服务器 URL 为 https://mcp.padlet.com。完整设置步骤请参阅Padlet MCP 服务器。
  2. 登录并以你要查询的组织管理员身份授权。对于班级账户,教师也可以获取分析数据。
  3. 用日常语言提问。无需指定内部工具名称,只需告诉 AI 助手你想了解学校、班级或团队的哪些信息,它就会代表你使用 Padlet MCP。

示例如下:

如果某个 MCP 客户端暂时无法显示分析结果,请尝试其他兼容 MCP 的客户端,或改用组织分析 API。客户端对服务器新功能的支持可能会有所延迟。
助手会以你的身份操作。它只能获取已登录账户有权查看的分析数据。

可选:组织分析 API

想自己编写脚本?请使用公共 API,并提供管理员 API 密钥(班级账户也可使用教师密钥)。

  1. 在“设置”的“开发者”页面创建或复制 API 密钥。详情请参阅公共 API文章。
  2. 使用 GET /me?include=organizations 查找组织 ID。你需要的是 wksp_ ID。目前此端点尚不支持 padlet.org 上的 org_ 组织。
  3. 向 /organizations/{org_id}/analytics 发送 POST 请求,并指定所需指标。
  4. 如果响应为 202,或 meta.pending 不为空,请等待 Retry-After 指定的时间,然后发送完全相同的请求。分析数据在后台计算,因此待处理的指标不会出现在响应中。切勿将其视为 0。
完整的请求格式、指标目录和示例请参阅读取组织分析数据。

谁可以使用

Padlet MCP 和 API 提供的组织分析功能适用于 Padlet for Schools 和团队账户的所有者与管理员,以及班级账户的所有者与教师。无需联系 Padlet 开通。

目前仅支持 wksp_ 组织。

提示示例

以下示例可以直接复制到 MCP 客户端中。根据你的学校、班级或团队调整措辞;准备面向客户的演示文稿时,请对照“分析”页面核对数据。

  • “本计费周期,我们学校有多少名活跃教师,相比许可证数量如何?哪些月份的数据有所下降?”
  • “我们组织中哪些 padlet 的浏览量最高?请列出排名前 3 的看板/sandbox。”
  • “哪些教师角色的成员在过去 12 个月里没有使用 Padlet?”
  • “有多少成员的电子邮件域名不是 <ouremaildomain.edu>?”
按需查询数据,例如月度序列、角色筛选、按帖子数或访客数排名的热门 padlet,或学校、班级的内容安全汇总数据。助手会将你的问题映射到可用指标。

仪表板仍然更适合的场景

如果你需要以下功能,请继续使用“设置”中的“分析”页面:

  • 可视化的“概览”横幅、“最佳机会”提示和一键提交专业发展(PD)请求
  • 带搜索、角色筛选和一键 CSV 下载功能的“所有用户”/“用户”表格
  • 在“概览”标签页下载所选周期内的活跃和不活跃教师名单(学校和班级)

如果精心整理的标签页无法回答演示或续约沟通中需要的具体问题,MCP 和 API 就能大显身手。

限制:

  • 速率限制:每个 API 密钥和组织每小时最多 60 个请求,包括收到 202 后的轮询请求
  • 日期范围:单个请求最多涵盖 24 个月
  • 内容安全:仅适用于学校和班级。团队查询这些指标会收到 400 错误
  • 成员人数:反映当前名册,而非历史时点的成员名单
  • 待处理 ≠ 0:仍在计算的指标不会出现在响应中;不要将其视为 0
  • 组织类型:目前仅支持 wksp_

常见问题

为什么查询分析数据时会收到 404?

所有拒绝请求的情况都会显示相同结果:组织不存在或无权访问,都会返回 404。请确认你登录时使用的是该组织的管理员身份(班级账户则需使用教师身份),且组织 ID 以 wksp_ 开头。仍无法解决?请联系支持团队。

我需要编写代码吗?

不需要。连接 Padlet MCP,以管理员身份登录,然后用日常语言提问即可。API 方式是可选的,适合开发者和已经在使用公共 API 的高级用户。

这和公共 API 是同一个东西吗?

二者相关,但并非同一种产品界面。公共 API面向使用 API 密钥的开发者。Padlet MCP 面向通过登录授权的 AI 助手。两者都可以访问组织分析数据,你可以任选其一,也可以同时使用。

学生或非管理员能通过这种方式查看组织分析数据吗?

不能。查看分析数据需要具有组织管理员身份,或在班级账户中具有教师身份。助手的访问权限与你登录的账户完全相同,不会有任何额外权限。

我的 MCP 客户端似乎无法识别分析功能。该怎么办?

有些客户端更新工具列表时会有延迟。请尝试重新连接 Padlet MCP,换用其他兼容 MCP 的客户端,或直接使用组织分析 API。如果仍无法解决,请联系我们。

相关内容

Bol tento článok užitočný?

Súvisiace články