Jak požádám Padlet MCP o analytiku pro Adminy (beta)?

Profilový obrázek uživatele Carla SeseAktualizováno před 16 hodinami uživatelem Carla Sese

Potřebujete čísla, která nástěnka Admina školy nebo Týmu nerozčleňuje podle vašich potřeb? Propojte Padlet MCP s AI asistentem a požádejte ho běžným jazykem o analytické údaje za školu, třídu nebo Tým – případně sami zavolejte analytické API organizace.

Úplný přehled REST API (katalog metrik, struktury požadavků a chybové kódy) najdete v dokumentu Čtení analytických údajů organizace na docs.padlet.dev.

Pro koho je tento článek určen

Tento článek je určen pro:

  • Vlastníky a Adminy účtů Padlet for Schools nebo Týmu
  • Vlastníky a učitele účtů Classroom

Abyste mohli použít MCP, nemusíte psát kód. Varianta s API je nepovinná a je určena pokročilým uživatelům, kteří už pracují s veřejným API.

Co už máte k dispozici

Stránka Analytika vaší organizace v Nastavení už zobrazuje přehledné karty za aktuální fakturační období. Školy a třídy mají karty Přehled, Využití, Dopad, Bezpečnost, Nejaktivnější uživatelé a Všichni uživatelé. Týmy mají karty Obecné, Padlety a Uživatelé, případně Přehled, Využití, Dopad, Nejaktivnější uživatelé a Všichni uživatelé, pokud má váš Tým novou stránku Analytiky (beta).

Pokud chcete rychlý vizuální přehled, použijte nástěnku. Pokud potřebujete vlastní rozčlenění, které karty nezobrazují přehledně, použijte MCP nebo API.

Co navíc nabízí MCP / API

Nástěnka obsahuje předem připravené karty. MCP a API vám umožní požádat přesně o údaje, které potřebujete:

  • Dotazy v běžném jazyce ve vašem AI klientovi („Kteří učitelé nebyli v minulém fakturačním období aktivní?“)
  • Vlastní kombinace metrik zapojení, členství a bezpečnosti obsahu
  • Měsíční řady za zvolené časové období
  • Rozčlenění podle role (učitelé oproti studentům, tvůrci oproti přispěvatelům)
  • Nejpopulárnější padlety, uživatelé a média seřazené podle vašich požadavků
  • Odpovědi, které můžete vložit do prezentace pro čtvrtletní obchodní hodnocení nebo do prezentace k obnovení smlouvy
Metriky bezpečnosti obsahu (skenované položky, označené položky, míra zachycení) jsou dostupné pouze pro školy a třídy. Pokud o ně požádáte u organizace typu Tým, zobrazí se chyba, nikoli nula.

Rychlý začátek s Padlet MCP

  1. Připojte Padlet MCP ve svém AI klientovi. Použijte URL serveru https://mcp.padlet.com. Úplný postup nastavení najdete v článku Server Padlet MCP.
  2. Přihlaste se a udělte oprávnění jako Admin organizace, jejíž údaje chcete zobrazit. V Classroom může analytiku zobrazit také učitel.
  3. Ptejte se běžným jazykem. Nemusíte uvádět názvy interních nástrojů. Řekněte AI asistentovi, co chcete vědět o své škole, třídě nebo Týmu, a on použije Padlet MCP za vás.

Tady je příklad:

Pokud některý MCP klient zatím nezobrazuje analytické údaje, zkuste jiného klienta kompatibilního s MCP nebo použijte analytické API organizace. Podpora klientů může za podporou serveru zaostávat.
Asistent jedná vaším jménem. Může zobrazit pouze analytické údaje, ke kterým má přístup váš přihlášený účet.

Volitelné: analytické API organizace

Chcete si skript napsat sami? Použijte veřejné API s klíčem API pro Admina (nebo s klíčem učitele v Classroom).

  1. Vytvořte nebo zkopírujte klíč API ze stránky Vývojář v Nastavení. Podrobnosti najdete v článku Veřejné API.
  2. Vyhledejte ID organizace pomocí příkazu GET /me?include=organizations. Potřebujete ID začínající na wksp_ — organizace org_ na padlet.org zatím tento koncový bod nepodporují.
  3. Odešlete požadavek POST na adresu /organizations/{org_id}/analytics s požadovanými metrikami.
  4. Pokud je odpověď 202 nebo pole meta.pending není prázdné, počkejte po dobu uvedenou v hlavičce Retry-After a odešlete naprosto stejný požadavek znovu. Analytické údaje se počítají asynchronně — dosud zpracovávaná metrika v odpovědi chybí, neznamená nulu. Nikdy nepovažujte čekající metriky za nulu.
Úplné struktury požadavků, katalog metrik a praktické příklady najdete v dokumentu Čtení analytických údajů organizace.

Přístup v rámci pilotního programu

Analytika organizace přes MCP a API je během pilotního programu dostupná na základě dobrovolného přihlášení. Padlet do programu zařazuje vlastníka organizace — samotná role Admina nestačí. Dokud vaše organizace není zařazena, každý požadavek vrátí chybu 404 (stejnou odpověď jako u neznámé organizace).

Zatím jsou podporovány pouze organizace s ID začínajícím na wksp_.

Kontaktujte podporu a požádejte ji o zařazení vlastníka vaší organizace do analytického programu pro Adminy.

Příklady dotazů

Toto jsou úvodní dotazy, které můžete vložit do svého MCP klienta. Upravte formulaci podle své školy, třídy nebo Týmu — a při přípravě prezentace určené zákazníkům ověřte čísla na stránce Analytika.

  • „Kolik učitelů na naší škole bylo v tomto fakturačním období aktivních v porovnání s počtem licencí a ve kterých měsících došlo k poklesu?“
  • „Které padlety v naší organizaci mají nejvíc zobrazení? Uveď tři nejpopulárnější nástěnky/sandboxy.“
  • „Kteří členové s rolí učitele Padlet posledních 12 měsíců nepoužili?“
  • „Kolik členů nemá e-mailovou doménu <ouremaildomain.edu>?“
Požádejte o údaje, které potřebujete: měsíční řadu, filtr podle role, nejpopulárnější padlety podle počtu příspěvků nebo návštěvníků či souhrnné údaje o bezpečnosti obsahu pro školu nebo třídu. Asistent převede váš dotaz na dostupné metriky.

V čem je nástěnka stále lepší

Stránku Analytika v Nastavení použijte, pokud chcete:

  • Vizuální banner Přehled, upozornění na nejlepší příležitosti a možnost jedním kliknutím požádat o profesní rozvoj
  • Tabulku Všichni uživatelé / Uživatelé s vyhledáváním, filtry podle rolí a stažením souboru CSV jedním kliknutím
  • Stáhnutelné seznamy aktivních a neaktivních učitelů za zvolené období na kartě Přehled (školy a třídy)
  • Přehled, který nevyžaduje zařazení do pilotního programu — stránka Nastavení je dostupná uživatelům s příslušnými rolemi bez nutnosti povolit API

MCP a API se hodí, když předem připravené karty neodpovídají přesně na otázku, kterou potřebujete pro ukázku nebo jednání o obnovení smlouvy.

Omezení:

  • Limit požadavků: 60 požadavků za hodinu pro každý klíč API a organizaci, včetně opakovaných dotazů po odpovědi 202
  • Časové období: nejvýše 24 měsíců v jednom požadavku
  • Bezpečnost obsahu: pouze pro školy a třídy — požadavky na tyto metriky pro Týmy vrátí chybu 400
  • Počet členů: odpovídá aktuálnímu seznamu členů, nikoli historickému přehledu toho, kdo byl členem v dané době
  • Čekající výpočet ≠ nula: metrika, která se stále počítá, v odpovědi chybí; nepovažujte ji za nulu
  • Typ organizace: zatím pouze wksp_

Časté dotazy

Proč se mi při žádosti o analytické údaje zobrazuje chyba 404?

Během pilotního provozu vypadají všechna zamítnutí stejně: chyba 404 se vrátí, pokud organizace není zařazena, není známá nebo k ní nemáte přístup. Ověřte, že jste přihlášeni jako Admin (nebo jako učitel v Classroom), že vaše organizace má ID začínající na wksp_ a že Padlet zařadil vlastníka organizace. O zařazení můžete požádat prostřednictvím podpory.

Musím psát kód?

Ne. Připojte Padlet MCP, přihlaste se jako Admin a ptejte se běžným jazykem. Varianta s API je nepovinná a je určena vývojářům a pokročilým uživatelům, kteří už veřejné API používají.

Je to totéž co veřejné API?

Souvisí spolu, ale jde o různé způsoby použití. Veřejné API je určeno vývojářům, kteří používají klíč API. Padlet MCP je určen pro AI asistenty, kterým udělíte oprávnění přihlášením. Jakmile je vaše organizace zařazena, oba nástroje mohou zobrazit analytické údaje organizace; můžete používat jeden z nich nebo oba.

Mohou tímto způsobem zobrazit analytické údaje organizace studenti nebo uživatelé bez role Admina?

Ne. Pro zobrazení analytických údajů je potřeba mít roli Admina organizace, případně být učitelem v Classroom. Asistent má stejný přístup jako účet, kterým jste se přihlásili — nic víc.

Můj MCP klient zřejmě o analytice neví. Co mám zkusit?

Některým klientům chvíli trvá, než aktualizují seznam nástrojů. Zkuste Padlet MCP znovu připojit, přejít na jiného klienta kompatibilního s MCP nebo přímo použít analytické API organizace. Pokud problémy přetrvávají i po zařazení, kontaktujte nás.

Související články

Byl pro vás tento článek užitečný?

Související články