如何向 Padlet MCP 请求管理员分析（Beta）？
由 Carla Sese 于 13小时前 更新学校或团队的管理员仪表板无法按你想要的方式细分数据？将 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。切勿将待处理状态视为 0。
试点计划访问权限
404（与组织不存在时的响应相同）。目前仅支持
wksp_ 组织。联系支持团队，请他们为你的组织所有者开通管理员分析权限。
示例提示词
以下示例可直接复制到 MCP 客户端中。请根据学校、班级或团队的情况调整措辞；准备面向客户的演示文稿时，请对照“分析”页面核实数据。
- “本计费周期内，我们学校的活跃教师人数和许可证数量分别是多少？哪些月份的数据有所下降？”
- “组织中哪些 Padlet 的浏览量最高？请列出排名前 3 的看板/sandbox。”
- “哪些拥有教师角色的成员在过去 12 个月里没有使用 Padlet？”
- “有多少成员的电子邮件地址不属于 <ouremaildomain.edu> 域名？”
仪表板仍更适合的场景
如果你需要以下功能，请使用“设置”中的“分析”页面：
- 可视化的“概览”横幅、“热门机会”提示，以及一键提交 PD 培训申请
- 包含搜索、角色筛选和一键下载 CSV 功能的“所有用户”/“用户”表格
- 从“概览”选项卡下载所选周期内活跃和不活跃教师的名单（适用于学校和班级）
- 无需加入试点计划即可使用的视图——符合条件的角色无需通过 API 主动申请即可访问“设置”页面
如果整理好的选项卡无法准确回答演示或续订沟通中所需的问题，MCP 和 API 就能发挥优势。
限制：
- 速率限制：每个 API 密钥和组织每小时最多 60 个请求，包括收到
202后的轮询请求 - 日期范围：单个请求最多涵盖 24 个月
- 内容安全：仅适用于学校和班级——团队查询这些指标会收到
400错误 - 成员人数：反映的是当前成员名单，而非某个历史时点的成员情况
- 待处理 ≠ 0：仍在计算的指标不会出现在响应中；请勿将其视为 0
- 组织类型：目前仅支持
wksp_
常见问题
为什么我查询分析数据时会收到 404？
该端点处于试点阶段，因此所有拒绝访问的情况都会返回相同结果：未加入计划、组织未知或无权访问，均返回 404。请确认你是以管理员身份（或班级账户中的教师身份）登录，组织 ID 以 wksp_ 开头，并且 Padlet 已为组织所有者开通权限。联系支持团队申请开通权限。
我需要编写代码吗？
不需要。连接 Padlet MCP，以管理员身份登录，然后用通俗语言提问即可。API 方式是可选的，适合已经在使用公共 API 的开发者和高级用户。
这和公共 API 是同一项服务吗？
两者有关联，但并非同一种产品形式。公共 API面向使用 API 密钥的开发者。Padlet MCP 则面向通过登录授权的 AI 助手。组织加入计划后，两者都能访问组织分析数据；你可以任选其一，也可以同时使用。
学生或非管理员可以通过这种方式查看组织分析数据吗？
不可以。查看分析数据需要组织管理员身份，或班级账户中的教师身份。助手拥有的访问权限与登录账户完全相同，不会超出该账户的权限。
