如何向 Padlet MCP 请求管理员分析（测试版）？
由 Carla Sese 于 16小时前 更新学校或团队管理员仪表板中的数据未按你想要的方式细分？将 Padlet MCP 连接到 AI 助手，用日常语言询问学校、班级或团队的数据分析；也可以自行调用组织数据分析 API。
适用对象
本文适用于：
- Padlet for Schools 或 Team 账户的所有者和管理员
- Classroom 账户的所有者和教师
使用 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 服务器。 - 登录，并以你要查询的组织的管理员身份授权。在 Classroom 中，教师也可以获取数据分析。
- 用日常语言提问。无需指定内部工具名称。告诉 AI 助手你想了解学校、班级或团队的哪些信息，它会代你使用 Padlet MCP。
示例如下：
可选：组织数据分析 API
想要自行编写脚本？请使用公共 API，并提供管理员 API 密钥（Classroom 账户也可使用教师密钥）。
- 在“设置”的“开发者”页面创建或复制 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 的表板/沙盒。”
- “哪些具有教师角色的成员过去 12 个月没有使用 Padlet？”
- “有多少成员的电子邮件域名不是 <ouremaildomain.edu>？”
仪表板仍更胜一筹的方面
如果你需要以下功能，请使用“设置”中的“数据分析”页面：
- 可视化的“概览”横幅、“热门机会”提示，以及一键提交的专业发展（PD）申请
- 带搜索、角色筛选器和一键 CSV 下载功能的“所有用户”/“用户”表格
- 可下载所选周期内活跃和非活跃教师名单的列表，位于“概览”标签页中（学校和班级）
- 无需申请试点权限即可查看的数据——符合条件的角色无需通过 API 申请使用权限，也能访问“设置”页面
如果精选标签页无法准确回答演示或续约沟通中需要的问题，MCP 和 API 就能发挥优势。
限制：
- 速率限制：每个 API 密钥和组织每小时 60 次请求，包括
202响应后的轮询 - 日期范围：单次请求最多覆盖 24 个月
- 内容安全：仅适用于学校和班级——团队请求这些指标会收到
400错误 - 成员人数：反映当前成员名单，而非特定历史时点的成员情况
- 待处理 ≠ 0：仍在计算的指标不会出现在响应中；切勿将其视为 0
- 组织类型：目前仅支持
wksp_
常见问题
为什么我请求数据分析时会收到 404？
该端点处于试点阶段时，所有拒绝访问的情况都会返回相同结果：尚未获准加入、组织不存在或无权访问，均会返回 404。请确认你是以管理员身份登录（Classroom 用户也可使用教师身份）、组织为 wksp_ 类型，并且 Padlet 已为组织所有者开通权限。请联系支持团队申请开通。
我需要编写代码吗？
不需要。连接 Padlet MCP，以管理员身份登录，然后用日常语言提问即可。API 方式为可选项，适合开发者和已在使用公共 API 的高级用户。
这和公共 API 是同一个东西吗？
两者相关，但并非同一种产品形式。公共 API供使用 API 密钥的开发者使用。Padlet MCP 则供经登录授权的 AI 助手使用。组织获准加入后，两者都能访问组织数据分析；你可以任选其一，也可以同时使用。
学生或非管理员可以通过这种方式查看组织数据分析吗？
不可以。查看数据分析需要具备组织管理员身份；Classroom 用户也可以是教师。助手的访问权限与你登录账户的权限完全相同，不会拥有更多权限。
我的 MCP 客户端似乎无法识别数据分析功能。我该怎么办？
有些客户端更新工具列表会有延迟。请尝试重新连接 Padlet MCP、更换为其他兼容 MCP 的客户端，或直接使用组织数据分析 API。如果组织获准加入后仍无法使用，请联系我们。
