Bagaimana cara meminta Analitik Admin (Beta) dari Padlet MCP?

Foto profil Carla SeseDiperbarui 13 jam yang lalu oleh Carla Sese

Angka di Dasbor Admin sekolah atau Tim tidak dirinci sesuai keinginan Anda? Hubungkan Padlet MCP ke asisten AI dan minta analitik sekolah, ruang kelas, atau Tim dalam bahasa sehari-hari -- atau panggil sendiri API analitik organisasi.

Untuk referensi REST lengkap (katalog metrik, format permintaan, dan kode kesalahan), lihat Membaca analitik organisasi di docs.padlet.dev.

Untuk siapa panduan ini

Artikel ini ditujukan untuk:

  • Pemilik dan admin akun Padlet for Schools atau Tim
  • Pemilik dan guru akun Classroom

Anda tidak perlu menulis kode untuk menggunakan MCP. Penggunaan API bersifat opsional bagi pengguna tingkat lanjut yang sudah menggunakan API Publik.

Yang sudah tersedia

Halaman Analitik organisasi Anda di Pengaturan sudah menampilkan tab pilihan untuk periode penagihan saat ini. Sekolah dan ruang kelas memiliki tab Ikhtisar, Penggunaan, Dampak, Keamanan, Pengguna teratas, dan Semua pengguna. Tim memiliki tab Umum, Padlet, dan Pengguna.

Gunakan dasbor jika Anda ingin melihat ringkasan visual dengan cepat. Gunakan MCP atau API jika Anda memerlukan rincian khusus yang tidak dapat dijawab dengan mudah oleh tab-tab tersebut.

Fitur tambahan MCP / API

Dasbor menyediakan tab pilihan. MCP dan API memungkinkan Anda meminta rincian spesifik yang dibutuhkan:

  • Pertanyaan dalam bahasa sehari-hari melalui klien AI Anda ("guru mana yang tidak aktif pada periode penagihan sebelumnya?")
  • Kombinasi khusus metrik keterlibatan, keanggotaan, dan keamanan konten
  • Data bulanan dalam rentang tanggal tertentu
  • Rincian berdasarkan peran (guru vs siswa, pembuat vs kontributor)
  • Padlet, pengguna, dan media teratas yang diurutkan sesuai permintaan Anda
  • Jawaban yang dapat ditempel ke presentasi QBR atau perpanjangan
Metrik keamanan konten (item yang dipindai, item yang ditandai, tingkat deteksi) hanya tersedia untuk sekolah dan ruang kelas. Jika Anda memintanya untuk organisasi Tim, permintaan akan menghasilkan kesalahan, bukan angka nol.

Mulai cepat dengan Padlet MCP

  1. Hubungkan Padlet MCP di klien AI Anda. Gunakan URL server https://mcp.padlet.com. Petunjuk penyiapan lengkap tersedia di Server Padlet MCP.
  2. Masuk dan beri otorisasi sebagai admin organisasi yang ingin Anda tanyai. Di Classroom, guru juga dapat mengambil data analitik.
  3. Ajukan pertanyaan dalam bahasa sehari-hari. Anda tidak perlu menyebutkan nama alat internal. Beri tahu asisten AI apa yang ingin Anda ketahui tentang sekolah, ruang kelas, atau Tim Anda, dan asisten akan menggunakan Padlet MCP atas nama Anda.

Berikut contohnya:

Jika klien MCP tertentu belum menampilkan jawaban analitik, coba klien lain yang kompatibel dengan MCP atau gunakan API analitik organisasi. Dukungan klien mungkin belum mengikuti pembaruan server.
Asisten bertindak sebagai Anda. Asisten hanya dapat mengambil data analitik yang diizinkan untuk dilihat oleh akun yang Anda gunakan untuk masuk.

Opsional: API analitik organisasi

Lebih suka membuat skrip sendiri? Gunakan API Publik dengan kunci API admin (atau kunci guru di Classroom).

  1. Buat atau salin kunci API dari halaman Developer di Pengaturan Anda. Detailnya ada di artikel API Publik.
  2. Temukan ID organisasi Anda dengan GET /me?include=organizations. Gunakan ID wksp_ — organisasi org_ di padlet.org belum didukung untuk endpoint ini.
  3. Kirim permintaan POST ke /organizations/{org_id}/analytics dengan metrik yang Anda inginkan.
  4. Jika responsnya 202 atau meta.pending tidak kosong, tunggu selama yang ditentukan oleh Retry-After, lalu kirim ulang permintaan yang sama persis. Data analitik dihitung secara asinkron — metrik yang masih diproses tidak disertakan, bukan bernilai nol. Jangan pernah menganggap data yang masih diproses sebagai nol.
Format permintaan lengkap, katalog metrik, dan contoh penggunaan tersedia di Membaca analitik organisasi.

Akses uji coba

Analitik organisasi melalui MCP dan API bersifat opsional selama masa uji coba. Padlet akan mendaftarkan pemilik organisasi — menjadi admin saja tidak cukup. Sebelum organisasi Anda terdaftar, setiap panggilan akan menghasilkan 404 (respons yang sama seperti untuk organisasi yang tidak dikenal).

Untuk saat ini, hanya organisasi wksp_ yang didukung.

Hubungi dukungan dan minta mereka mendaftarkan pemilik organisasi Anda untuk analitik admin.

Contoh prompt

Berikut beberapa contoh yang dapat Anda tempel ke klien MCP. Sesuaikan kata-katanya dengan sekolah, ruang kelas, atau Tim Anda — dan verifikasi angkanya di halaman Analitik saat menyiapkan presentasi untuk pelanggan.

  • "Untuk sekolah kami pada periode penagihan ini, berapa jumlah guru aktif dibandingkan jumlah lisensi, dan bulan mana yang mengalami penurunan?"
  • "Padlet organisasi mana yang memiliki jumlah tayangan tertinggi? Beri saya 3 papan/sandbox teratas."
  • "Anggota mana yang berperan sebagai guru belum menggunakan Padlet dalam 12 bulan terakhir?"
  • "Berapa anggota yang tidak menggunakan domain email <ouremaildomain.edu>?"
Minta rincian yang Anda perlukan: data bulanan, filter peran, Padlet teratas berdasarkan jumlah postingan atau pengunjung, atau total keamanan konten untuk sekolah atau ruang kelas. Asisten akan mencocokkan pertanyaan Anda dengan metrik yang tersedia.

Keunggulan dasbor

Gunakan halaman Analitik di Pengaturan jika Anda menginginkan:

  • Banner Ikhtisar visual, sorotan Peluang teratas, dan permintaan PD sekali klik
  • Tabel Semua pengguna / Pengguna dengan fitur pencarian, filter peran, dan unduhan CSV sekali klik
  • Daftar guru aktif dan tidak aktif yang dapat diunduh untuk periode yang dipilih, dari tab Ikhtisar (sekolah dan ruang kelas)
  • Tampilan yang tidak memerlukan pendaftaran uji coba — halaman Pengaturan dapat diakses oleh peran yang memenuhi syarat tanpa perlu ikut serta melalui API

MCP dan API sangat berguna saat tab pilihan tidak menjawab pertanyaan spesifik yang Anda perlukan untuk demo atau diskusi perpanjangan.

Batasan:

  • Batas laju: 60 permintaan per jam untuk setiap kunci API dan organisasi, termasuk polling setelah respons 202
  • Rentang tanggal: maksimal 24 bulan dalam satu permintaan
  • Keamanan konten: hanya untuk sekolah dan ruang kelas — permintaan metrik tersebut untuk Tim akan menghasilkan 400
  • Jumlah keanggotaan: mencerminkan daftar anggota saat ini, bukan gambaran historis tentang siapa yang menjadi anggota pada waktu tertentu
  • Masih diproses ≠ nol: metrik yang masih dihitung tidak disertakan dalam respons; jangan menganggapnya bernilai nol
  • Jenis organisasi: untuk saat ini hanya wksp_

FAQ

Mengapa saya mendapatkan 404 saat meminta data analitik?

Selama endpoint masih dalam masa uji coba, semua penolakan memberikan respons yang sama: belum terdaftar, organisasi tidak dikenal, atau tidak memiliki akses semuanya menghasilkan 404. Pastikan Anda masuk sebagai admin (atau guru di Classroom), organisasi Anda adalah organisasi wksp_, dan Padlet telah mendaftarkan pemilik organisasi. Hubungi dukungan untuk meminta pendaftaran.

Apakah saya perlu menulis kode?

Tidak. Hubungkan Padlet MCP, masuk sebagai admin, lalu ajukan pertanyaan dalam bahasa sehari-hari. Penggunaan API bersifat opsional bagi pengembang dan pengguna tingkat lanjut yang sudah menggunakan API Publik.

Apakah ini sama dengan API Publik?

Terkait, tetapi bukan produk yang sama. API Publik ditujukan bagi pengembang yang menggunakan kunci API. Padlet MCP ditujukan bagi asisten AI yang Anda beri otorisasi dengan masuk. Keduanya dapat mengakses analitik organisasi setelah organisasi Anda terdaftar; Anda dapat menggunakan salah satunya atau keduanya.

Apakah siswa atau non-admin dapat melihat analitik organisasi dengan cara ini?

Tidak. Analitik hanya dapat diakses oleh admin organisasi atau guru di Classroom. Asisten memiliki akses yang sama persis dengan akun yang Anda gunakan untuk masuk — tidak lebih.

Klien MCP saya sepertinya tidak mengetahui fitur analitik. Apa yang harus saya coba?

Beberapa klien membutuhkan waktu untuk memperbarui daftar alatnya. Coba hubungkan kembali Padlet MCP, beralih ke klien lain yang kompatibel dengan MCP, atau gunakan API analitik organisasi secara langsung. Jika Anda masih tidak dapat mengaksesnya setelah pendaftaran, hubungi kami.

Terkait

Apakah artikel ini bermanfaat?

Artikel terkait

Akses halaman diagnostik

Perbaiki masalah Padlet menggunakan alat diagnostik di web atau perangkat seluler, lalu hubungi dukungan jika diperlukan dengan hasilnya.

Bagaimana cara mereset Apple ID saya?

Reset Apple ID Anda untuk Padlet dengan menghapusnya dari pengaturan Apple ID Anda dan masuk kembali.

Panduan Guru: Tips untuk mengakhiri tahun ajaran

Siapkan akun Padlet Anda untuk tahun ajaran berikutnya dengan mengekspor, mengorganisir, dan membersihkan padlets dan anggota.

Saya ingin bekerja di Padlet. Di mana saya harus melamar?

Jelajahi peluang karir di Padlet dan ajukan lamaran untuk posisi yang tersedia di padlet.jobs.