我要如何向 Padlet MCP 要求管理員分析資料?

Carla Sese 的個人檔案照片由 Carla Sese 於 4 天前 更新

學校或團隊的管理員控制面板顯示的數字不夠符合您的需求嗎?將 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。伺服器網址為 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。請確認您是以該組織的管理員(或教室的教師)身分登入,並確認該組織屬於 wksp_ 類型。還是無法解決?請聯絡支援團隊。

我需要撰寫程式碼嗎?

不需要。連接 Padlet MCP,以管理員身分登入,然後用淺白語言提問即可。API 方式則是供開發人員和已使用公開 API 的進階使用者選用。

這和公開 API 是一樣的嗎?

兩者相關,但並非同一種產品介面。公開 API供開發人員使用 API 金鑰;Padlet MCP 則供您登入並授權的 AI 助理使用。兩者都能存取組織分析資料,您可以擇一使用,也可以兩者都用。

學生或非管理員可以透過這種方式查看組織分析資料嗎?

不可以。您必須是組織管理員或教室教師,才能查看分析資料。助理的存取權限與您登入的帳戶完全相同,不會多出任何權限。

我的 MCP 用戶端似乎不知道分析資料功能。我可以試試什麼方法?

有些用戶端會延遲更新工具清單。請嘗試重新連接 Padlet MCP、改用其他相容於 MCP 的用戶端,或直接使用組織分析 API。若仍無法解決,請與我們聯絡。

相關內容

這篇文章有幫助嗎?

相關文章