我要如何向 Padlet MCP 要求管理員分析資料?
由 Carla Sese 於 4 天前 更新學校或團隊的管理員控制面板顯示的數字不夠符合您的需求嗎?將 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。伺服器網址為
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。請確認您是以該組織的管理員(或教室的教師)身分登入,並確認該組織屬於 wksp_ 類型。還是無法解決?請聯絡支援團隊。
我需要撰寫程式碼嗎?
不需要。連接 Padlet MCP,以管理員身分登入,然後用淺白語言提問即可。API 方式則是供開發人員和已使用公開 API 的進階使用者選用。
這和公開 API 是一樣的嗎?
兩者相關,但並非同一種產品介面。公開 API供開發人員使用 API 金鑰;Padlet MCP 則供您登入並授權的 AI 助理使用。兩者都能存取組織分析資料,您可以擇一使用,也可以兩者都用。
學生或非管理員可以透過這種方式查看組織分析資料嗎?
不可以。您必須是組織管理員或教室教師,才能查看分析資料。助理的存取權限與您登入的帳戶完全相同,不會多出任何權限。
