Padlet MCP に管理者分析について尋ねるにはどうすればよいですか?

Carla Sesen profiilikuvaPäivitetty 4 日前 käyttäjän Carla Sese toimesta

学校またはチームの管理者ダッシュボードでは、必要な形で数値を絞り込めませんか?Padlet MCPをAIアシスタントに接続すれば、学校、教室、チームの分析データを自然な言葉で質問できます。または、組織分析APIを直接呼び出すこともできます。

指標一覧、リクエスト形式、エラーコードを含むRESTリファレンスの全文は、docs.padlet.devの組織分析を読むをご覧ください。

対象者

この記事は、次の方を対象としています。

  • Padlet for Schoolsまたはチームアカウントのオーナーと管理者
  • Classroomアカウントのオーナーと教師

MCPを使うためにコードを書く必要はありません。APIの利用は任意で、すでにPublic APIを利用している上級ユーザー向けです。

すでに利用できる機能

設定にある組織の分析ページには、現在の請求期間に合わせたタブが表示されます。学校と教室では、概要、利用状況、効果、安全性、上位ユーザー、全ユーザーが表示されます。チームでは、一般、Padlet、ユーザーが表示されます。チームに新しい分析ページ(ベータ版)が導入されている場合は、概要、利用状況、効果、上位ユーザー、全ユーザーが表示されます。

視覚的にすばやく状況を把握したい場合は、ダッシュボードを使います。タブでは答えにくい条件でデータを絞り込みたい場合は、MCPまたはAPIを使います。

MCP / APIでできること

ダッシュボードには、あらかじめ用意されたタブが表示されます。MCPとAPIを使えば、必要な条件を指定してデータを取得できます。

  • AIクライアントに自然な言葉で質問する (「前の請求期間に利用がなかった教師は誰ですか?」)
  • エンゲージメント、メンバーシップ、コンテンツの安全性に関する指標を自由に組み合わせる
  • 指定した期間の月別データを取得する
  • 役割別に絞り込む (教師と生徒、作成者と投稿者など)
  • 指定した条件で上位のpadlet、ユーザー、メディアを並べる
  • QBRや更新提案資料に貼り付けられる回答を得る
コンテンツの安全性に関する指標 (スキャンした項目、フラグが付いた項目、検出率)は、学校と教室でのみ利用できます。チーム組織でこれらの指標をリクエストすると、ゼロではなくエラーが返されます。

Padlet MCPをすぐに使う

  1. AIクライアントでPadlet MCPに接続します。サーバーURLはhttps://mcp.padlet.comです。設定手順の詳細はPadlet MCP Serverをご覧ください。
  2. 分析を取得したい組織の管理者としてサインインし、認証します。Classroomでは、教師も分析データを取得できます。
  3. 自然な言葉で質問します。内部ツールの名前を指定する必要はありません。学校、教室、チームについて知りたいことをAIアシスタントに伝えると、代わりにPadlet MCPを使って調べます。

例:

使用中のMCPクライアントで分析結果が表示されない場合は、別のMCP対応クライアントを試すか、代わりに組織分析APIを使ってください。クライアント側の対応はサーバーより遅れることがあります。
アシスタントは、あなたとして操作します。サインイン中のアカウントに閲覧権限がある分析データのみ取得できます。

任意:組織分析API

自分でスクリプトを作成しますか?管理者のAPIキー(Classroomでは教師のキー)を使ってPublic APIを利用します。

  1. 設定の開発者ページでAPIキーを作成するか、コピーします。詳細はPublic APIの記事をご覧ください。
  2. GET /me?include=organizationsを使って組織IDを確認します。必要なのはwksp_で始まるIDです。padlet.org上のorg_組織は、現時点ではこのエンドポイントに対応していません。
  3. 必要な指標を指定して、/organizations/{org_id}/analyticsにPOSTリクエストを送信します。
  4. レスポンスが202の場合、またはmeta.pendingが空でない場合は、Retry-Afterの時間を待って、同一のリクエストを再送信します。分析はバックグラウンドで計算されるため、保留中の指標はレスポンスに含まれません。ゼロとして扱わないでください。
リクエスト形式、指標一覧、実例については、組織分析を読むをご覧ください。

利用できるユーザー

Padlet MCPおよびAPIを使った組織分析は、Padlet for Schoolsとチームアカウントのオーナーおよび管理者、ならびにClassroomアカウントのオーナーおよび教師が利用できます。Padletに有効化を依頼する必要はありません。

現在対応しているのはwksp_組織のみです。

プロンプトの例

以下は、MCPクライアントに貼り付けて使える例です。学校、教室、チームに合わせて文言を調整してください。顧客向けの資料を作成する際は、分析ページの数値と照合してください。

  • 「今期の請求期間における、学校のアクティブな教師数とライセンス数を教えてください。利用が落ち込んだ月はありますか?」
  • 「組織内で閲覧数が最も多いpadletはどれですか?上位3件のボード/サンドボックスを教えてください。」
  • 「教師の役割を持つメンバーのうち、過去12か月間Padletを利用していないのは誰ですか?」
  • 「メールドメインが<ouremaildomain.edu>ではないメンバーは何人ですか?」
必要な条件を指定して質問してください。月別データ、役割による絞り込み、投稿数や訪問者数の多いpadlet、学校や教室のコンテンツ安全性の合計値などを尋ねられます。アシスタントが、質問を利用可能な指標に対応付けます。

ダッシュボードが引き続き優れている点

次の機能を使いたい場合は、設定の分析ページを利用してください。

  • 視覚的な概要バナー、注目すべき改善点の表示、ワンクリックでのPDリクエスト
  • 検索、役割による絞り込み、ワンクリックでのCSVダウンロードができる「全ユーザー」/「ユーザー」表
  • 概要タブからダウンロードできる、選択した期間のアクティブな教師と利用のない教師の一覧 (学校と教室)

デモや更新に関する打ち合わせで必要な質問に、あらかじめ用意されたタブでは答えられない場合、MCPとAPIが役立ちます。

制限事項:

  • レート制限:APIキーおよび組織ごとに1時間あたり60リクエスト。202の後のポーリングも含みます。
  • 期間:1回のリクエストで指定できるのは最大24か月です。
  • コンテンツの安全性:学校と教室のみ対応しています。チームでは該当する指標に対して400が返されます。
  • メンバー数:過去の特定時点のメンバー構成ではなく、現在の名簿を反映します。
  • 保留中 ≠ ゼロ:計算中の指標はレスポンスに含まれません。ゼロとして扱わないでください。
  • 組織タイプ:現在はwksp_のみ対応しています。

よくある質問

分析データをリクエストすると404が返るのはなぜですか?

組織が存在しない場合も、アクセス権がない場合も、同じ404が返されます。対象組織の管理者(またはClassroomの教師)としてサインインしていることと、その組織がwksp_であることを確認してください。それでも解決しない場合は、サポートに問い合わせるをご利用ください。

コードを書く必要はありますか?

いいえ。Padlet MCPに接続し、管理者としてサインインして、自然な言葉で質問してください。APIの利用は、Public APIをすでに利用している開発者や上級ユーザー向けの任意の方法です。

これはPublic APIと同じものですか?

関連していますが、提供方法は異なります。Public APIは、APIキーを使う開発者向けです。Padlet MCPは、ログインして認証したAIアシスタント向けです。どちらでも組織分析を利用でき、片方だけでも両方でも使用できます。

生徒や管理者以外のユーザーも、この方法で組織分析を閲覧できますか?

いいえ。分析を利用するには組織の管理者、またはClassroomの教師である必要があります。アシスタントが持つアクセス権は、サインインに使用したアカウントとまったく同じで、それ以上の権限はありません。

MCPクライアントが分析機能を認識していないようです。どうすればよいですか?

一部のクライアントでは、ツール一覧の更新に時間がかかります。Padlet MCPに再接続する、別のMCP対応クライアントに切り替える、または組織分析APIを直接使う方法をお試しください。それでも解決しない場合は、お問い合わせください。

関連情報

Oliko tästä artikkelista apua?

Aiheeseen liittyvät artikkelit