我要如何向 Padlet MCP 索取管理員分析(Beta)?

Carla Seses profilbilledeOpdateret 13 小時前 af Carla Sese

學校或團隊管理員控制面板中的數據切分方式不符合您的需求嗎?將 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. 將所需指標隨 POST 請求傳送至 /organizations/{org_id}/analytics。
  4. 如果回應為 202,或 meta.pending 不為空,請等候 Retry-After 指定的時間,再以完全相同的請求重新傳送。分析資料是非同步計算的;尚在處理的指標不會出現在回應中,而不是顯示為 0。切勿將待處理的指標視為 0。
完整的請求格式、指標目錄和範例,請參閱讀取組織分析資料。

試用計畫存取權

透過 MCP 和 API 存取組織分析資料的功能,在試用期間須選擇加入。Padlet 會為組織擁有者開通使用權——僅有管理員身分並不足夠。在您的組織完成開通前,每次呼叫都會回應 404(與找不到組織時的回應相同)。

目前僅支援 wksp_ 組織。

請聯絡支援團隊,請他們為您的組織擁有者開通管理員分析功能。

提示範例

以下範例可直接貼入 MCP 用戶端。請依您的學校、教室或團隊調整措辭;準備對客戶展示的簡報時,請透過「分析資料」頁面核對數字。

  • 「本校在這個帳單期間有多少位活躍教師,相較於授權數又如何?哪些月份的數字有所下滑?」
  • 「哪些組織的 Padlet 瀏覽次數最多?列出排名前三的看板/sandbox。」
  • 「哪些具有教師角色的成員在過去 12 個月內沒有使用 Padlet?」
  • 「有多少位成員的電子郵件網域不是 <ouremaildomain.edu>?」
請詢問您需要的資料切分方式:每月資料序列、角色篩選條件、依貼文數或訪客數排序的熱門 Padlet,或學校及教室的內容安全性統計。助理會將您的問題對應至可用指標。

控制面板仍較擅長的項目

若您需要以下功能,請使用「設定」中的「分析資料」頁面:

  • 「總覽」橫幅、「最佳機會」提示,以及一鍵提出 PD 申請
  • 可搜尋、篩選角色並一鍵下載 CSV 的「所有使用者/使用者」表格
  • 可下載所選期間內活躍和非活躍教師名單的功能,位於「總覽」分頁(學校和教室)
  • 無須加入試用計畫即可使用的檢視方式——符合資格的角色不需透過 API 選擇加入,即可使用「設定」頁面

若整理好的分頁無法回答您在產品展示或續約洽談中需要的確切問題,MCP 和 API 就能派上用場。

限制:

  • 速率限制:每個 API 金鑰和組織每小時 60 次請求,包括 202 後的輪詢請求
  • 日期範圍:單一請求最多涵蓋 24 個月
  • 內容安全性:僅適用於學校和教室——團隊若要求這些指標,會收到 400 錯誤
  • 成員人數:反映目前的名冊,而非特定時間點的歷史成員名單
  • 待處理 ≠ 0:仍在計算的指標不會出現在回應中;切勿將其視為 0
  • 組織類型:目前僅支援 wksp_

常見問題

為什麼我詢問分析資料時會收到 404?

端點仍在試用期間,所有拒絕存取的情況都會顯示相同結果:尚未開通、組織不存在或沒有存取權限,皆會回傳 404。請確認您是以管理員(教室帳戶則為教師)身分登入、您的組織為 wksp_ 組織,且 Padlet 已為組織擁有者開通使用權。請聯絡支援團隊申請開通。

我需要編寫程式碼嗎?

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

這和公開 API 是一樣的嗎?

兩者相關,但屬於不同的產品介面。公開 API供使用 API 金鑰的開發人員使用。Padlet MCP 則供透過登入授權的 AI 助理使用。只要您的組織已開通,兩者都能存取組織分析資料;您可以使用其中一種或兩種方式。

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

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

我的 MCP 用戶端似乎不支援分析資料功能。我可以怎麼做?

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

相關內容

Var denne artikel nyttig?

Relaterede artikler