Padlet MCPにAdmin Analytics(ベータ版)について尋ねるにはどうすればよいですか?

Carla Seseのプロフィール写真Carla Seseが13 時間前に更新

学校やチームの管理ダッシュボードでは、希望通りの切り口でデータを分析できないとお困りですか? Padlet MCPをAIアシスタントに連携させ、学校、教室、チームの分析データを平易な言葉でリクエストするか、組織分析APIを直接呼び出してみてください。

RESTリファレンス(メトリクスカタログ、リクエスト形式、エラーコード)の詳細については、docs.padlet.devの「組織分析の読み取り」をご覧ください。

対象読者

この記事の対象者:

  • Padlet for Schools または Team アカウントのオーナーおよび管理者
  • Classroomアカウントのオーナーおよび教師

MCPパスを利用するためにコードを記述する必要はありません。このAPIパスは、すでにパブリックAPIを利用している上級ユーザーにとってはオプションです。

すでに利用可能な機能

設定内の組織の「アナリティクス」ページには、現在の請求期間に関する厳選されたタブがすでに表示されています。「Schools」および「Classrooms」では、「概要」、「利用状況」、「影響」、「安全性」、「トップユーザー」、「すべてのユーザー」が表示されます。「Teams」では、「一般」、「Padlet」、「ユーザー」が表示されます。

状況を一目で把握したい場合はダッシュボードをご利用ください。タブでは明確に把握できないようなカスタムな分析が必要な場合は、MCPまたはAPIをご利用ください。

MCP/APIが追加する機能

ダッシュボードは厳選されたタブで構成されています。MCPやAPIを使用すれば、必要なデータを正確に抽出できます:

  • AIクライアントでの平易な質問(「前回の請求期間に非アクティブだった教員は誰ですか?」)
  • エンゲージメント、会員数、コンテンツ安全性の指標を自由に組み合わせたカスタム分析
  • 指定した日付範囲にわたる月次データシリーズ
  • 役割別のデータ(講師対生徒、制作者対寄稿者)
  • 質問の仕方に応じてランク付けされたトップのPadlet、トップユーザー、トップメディア
  • QBRや更新資料にそのまま貼り付けられる回答
コンテンツの安全性に関する指標(スキャンされたアイテム、フラグが立てられたアイテム、検出率)は、学校および教室でのみ利用可能です。チーム組織でこれらをリクエストすると、ゼロではなくエラーが返されます。

Padlet MCPのクイックスタート

  1. AIクライアントでPadlet MCPを接続します。サーバーURLを使用してください https://mcp.padlet.com。詳細な設定手順は「Padlet MCP サーバー」に記載されています。
  2. クエリを実行したい組織の管理者としてサインインし、認証を行ってください。教室(Classroom)では、教師も分析データを取得できます。
  3. 平易な言葉で質問してください。内部ツールの名称を明記する必要はありません。学校、教室、またはチームについて知りたいことをAIアシスタントに伝えれば、AIアシスタントが代わりにPadlet MCPを利用します。

例を以下に示します:

特定のMCPクライアントでまだ分析結果が表示されない場合は、別のMCP対応クライアントを試すか、代わりに組織分析APIをご利用ください。クライアントの対応状況はサーバーに遅れをとる場合があります。
アシスタントはあなたとして動作します。ログインしているアカウントが閲覧を許可されている分析データのみを取得できます。

オプション:組織分析API

自分でスクリプトを作成したい場合は、管理者用APIキー(またはClassroomの場合は教師用キー)を使用してパブリックAPIを利用してください。

  1. [設定]内の[開発者]ページからAPIキーを作成またはコピーしてください。詳細はパブリックAPIの記事に記載されています。
  2. 組織 ID は次のコマンドで確認できます GET /me?include=organizations。必要なのは wksp_ id — org_ padlet.org上の組織は、このエンドポイントではまだサポートされていません。
  3. 以下のリクエストを送信してください POST を /organizations/{org_id}/analytics に、必要なメトリクスを指定して送信してください。
  4. 応答が 202 の場合、または meta.pending 空でない場合は、 Retry-After 同じリクエストを再度送信してください。分析は非同期で計算されます。処理中のメトリクスは「存在しない」状態であり、「ゼロ」ではありません。処理中の状態をゼロとして扱わないでください。
完全なリクエストの構成、メトリクスのカタログ、および実例は、「組織の分析」に収録されています。

パイロット版へのアクセス

MCPおよびAPI経由の組織分析は、パイロット期間中はオプトイン制となっています。Padletは組織所有者を登録します。管理者であるだけでは不十分です。組織が登録されるまでは、すべての呼び出しに対して 404 (未知の組織と同じ応答が返されます)。

現時点では wksp_ 組織のみがサポートされています。

サポートに連絡し、組織所有者を管理者向けアナリティクスに登録するよう依頼してください。

プロンプトの例

これらは、MCPクライアントに貼り付けて使えるテンプレートです。学校、教室、またはチームに合わせて文言を調整し、顧客向けのプレゼン資料を作成する際は、[アナリティクス]ページで数値を確認してください。

  • 「当校の今請求期間において、アクティブな教員数とライセンス数の比率はどのくらいですか?また、どの月に減少が見られましたか?」
  • 「組織内のPadletの中で、閲覧数が最も多いのはどれですか? 閲覧数トップ3のボード/サンドボックスを教えてください。」
  • 「教師の役割を持つメンバーのうち、過去12ヶ月間にPadletを使用していないのは誰ですか?」
  • 「メールアドレスドメインが <ouremaildomain.edu> ではないメンバーはどれくらいいますか?」
必要なデータ(月次データ、役割フィルター、投稿数や訪問者数に基づくトップPadlet、学校や教室ごとのコンテンツ安全性の合計など)を指定してください。アシスタントが、質問内容を利用可能な指標に照らし合わせて回答します。

ダッシュボードが依然として優れている点

次のような場合は、引き続き「設定」内の「アナリティクス」ページをご利用ください:

  • 視覚的な「概要」バナー、注目の機会のハイライト表示、ワンクリックでのPDリクエスト
  • 検索、役割フィルター、ワンクリックでのCSVダウンロード機能を備えた「すべてのユーザー/ユーザー」テーブル
  • 「概要」タブ(学校および教室)から、選択した期間のアクティブな教員および非アクティブな教員のリストをダウンロード可能
  • パイロット登録を必要としないビュー — 設定ページ自体は、APIへのオプトインなしでも対象となる役割のユーザーが利用可能です

デモや更新の打ち合わせで、厳選されたタブだけでは必要な質問に正確に答えられない場合、MCPとAPIが真価を発揮します。

制限事項:

  • リミット:APIキーおよび組織ごとに1時間あたり60リクエスト( 202
  • 日付範囲:1回のリクエストにつき最大24か月
  • コンテンツの安全性:学校および教室のみ — Teamsでは、 400 が適用されます
  • メンバー数:その時点での所属状況の過去のスナップショットではなく、現在の名簿を反映しています
  • 「保留中」≠ 0:計算中の指標はレスポンスに含まれていません。0として扱わないでください
  • 組織の種類: wksp_ 現時点では

よくある質問

分析データをリクエストすると404エラーが表示されるのはなぜですか?

エンドポイントがパイロット段階にある間、拒否の理由はすべて同じ表示になります:「登録済みではありません」、「組織が不明」、または「アクセス権限なし」のいずれかが返されます 404。管理者(またはClassroomの場合は教師)としてログインしていること、所属組織が wksp_ 組織であること、およびPadletが組織所有者を登録済みであることを確認してください。登録を依頼するには、サポートにお問い合わせください。

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

いいえ。Padlet MCPに接続し、管理者としてログインして、平易な言葉でリクエストしてください。APIパスは、すでにパブリックAPIを使用している開発者や上級ユーザーにとっては任意です。

これはパブリックAPIと同じものですか?

関連はしていますが、提供される機能は異なります。パブリックAPIはAPIキーを使用する開発者向けです。Padlet MCPは、ログインして認証を行うAIアシスタント向けです。組織が登録されれば、どちらも組織の分析データにアクセスできます。どちらか一方、または両方を使用できます。

生徒や管理者以外のユーザーも、この方法で組織の分析データを見ることができますか?

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

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

クライアントによっては、ツールリストの更新に時間がかかる場合があります。Padlet MCPを再接続するか、他のMCP対応クライアントに切り替えるか、組織の分析データを直接APIから取得してみてください。登録後もアクセスできない場合は、弊社までご連絡ください。

関連情報

この記事は役に立ちましたか?

関連記事