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

Carla Sese 的個人檔案照片由 Carla Sese 於 16 小時前 更新

學校或團隊管理員控制面板中的數據切片不符合您的需求嗎?將 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。伺服器 URL 為 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。切勿將待處理的指標視為 0。
完整的請求格式、指標目錄和範例,請參閱讀取組織分析資料。

試行版存取權

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

目前僅支援 wksp_ 組織。

請聯絡支援團隊,要求為您的組織擁有者開通管理員分析資料權限。

提示範例

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

  • 「以本校這個計費週期來說,活躍教師人數和授權數各是多少?哪些月份的數字下滑?」
  • 「哪些組織中的 Padlet 瀏覽次數最高?列出前 3 個看板/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。若加入試行計畫後仍無法使用,請與我們聯絡。

相關內容

這篇文章有幫助嗎?

相關文章