如何向 Padlet MCP 请求管理员分析数据?
Aktualizované 4天前 používateľom Carla Sese学校或团队的管理员仪表板无法按你想要的方式筛选数据?将 Padlet MCP 连接到 AI 助手,用日常语言查询学校、班级或团队分析数据;你也可以直接调用组织分析 API。
适用对象
本文适用于:
- Padlet for Schools 或团队账户的所有者和管理员
- 班级账户的所有者和教师
使用 MCP 方式无需编写代码。API 方式是可选的,适合已经使用公共 API的高级用户。
你已有的功能
组织在“设置”中的分析页面已提供精心整理的标签页,展示当前计费周期的数据。学校和班级账户包含“概览”“使用情况”“影响”“安全”“热门用户”和“所有用户”。团队账户包含“常规”“Padlet”和“用户”;如果你的团队已启用新版分析页面(测试版),则包含“概览”“使用情况”“影响”“热门用户”和“所有用户”。
想快速查看直观的数据概览时,请使用仪表板。如果标签页无法清晰回答你的问题,需要自定义筛选数据时,请使用 MCP 或 API。
MCP / API 的额外功能
仪表板提供精心整理的标签页。借助 MCP 和 API,你可以精准查询所需的数据:
- 在 AI 客户端中用日常语言提问(“上个计费周期有哪些教师没有活动?”)
- 自定义组合参与度、成员身份和内容安全指标
- 查询特定日期范围内的月度数据序列
- 按角色筛选(教师与学生、创作者与贡献者)
- 按你指定的方式排列热门 padlet、热门用户和热门媒体
- 获取可粘贴到季度业务回顾(QBR)或续约演示文稿中的答案
快速开始使用 Padlet MCP
- 在 AI 客户端中连接 Padlet MCP。服务器 URL 为
https://mcp.padlet.com。完整设置步骤请参阅Padlet MCP 服务器。 - 登录并以你要查询的组织管理员身份授权。对于班级账户,教师也可以获取分析数据。
- 用日常语言提问。无需指定内部工具名称,只需告诉 AI 助手你想了解学校、班级或团队的哪些信息,它就会代表你使用 Padlet MCP。
示例如下:

可选:组织分析 API
想自己编写脚本?请使用公共 API,并提供管理员 API 密钥(班级账户也可使用教师密钥)。
- 在“设置”的“开发者”页面创建或复制 API 密钥。详情请参阅公共 API文章。
- 使用
GET /me?include=organizations查找组织 ID。你需要的是wksp_ID。目前此端点尚不支持 padlet.org 上的org_组织。 - 向
/organizations/{org_id}/analytics发送POST请求,并指定所需指标。 - 如果响应为
202,或meta.pending不为空,请等待Retry-After指定的时间,然后发送完全相同的请求。分析数据在后台计算,因此待处理的指标不会出现在响应中。切勿将其视为 0。
谁可以使用
目前仅支持
wksp_ 组织。提示示例
以下示例可以直接复制到 MCP 客户端中。根据你的学校、班级或团队调整措辞;准备面向客户的演示文稿时,请对照“分析”页面核对数据。
- “本计费周期,我们学校有多少名活跃教师,相比许可证数量如何?哪些月份的数据有所下降?”
- “我们组织中哪些 padlet 的浏览量最高?请列出排名前 3 的看板/sandbox。”
- “哪些教师角色的成员在过去 12 个月里没有使用 Padlet?”
- “有多少成员的电子邮件域名不是 <ouremaildomain.edu>?”
仪表板仍然更适合的场景
如果你需要以下功能,请继续使用“设置”中的“分析”页面:
- 可视化的“概览”横幅、“最佳机会”提示和一键提交专业发展(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 助手。两者都可以访问组织分析数据,你可以任选其一,也可以同时使用。
学生或非管理员能通过这种方式查看组织分析数据吗?
不能。查看分析数据需要具有组织管理员身份,或在班级账户中具有教师身份。助手的访问权限与你登录的账户完全相同,不会有任何额外权限。
