Como posso pedir ao Padlet MCP as análises de administração?

Carla Seseのプロフィール写真Carla Seseがhá 4 diasに更新

Precisa de números que o Painel de administração da escola ou da equipe não apresenta da forma que você quer? Conecte o Padlet MCP a um assistente de IA e peça análises da escola, da sala de aula ou da equipe em linguagem simples, ou chame você mesmo a API de análise da organização.

Para consultar a referência REST completa (catálogo de métricas, formatos de solicitação e códigos de erro), veja Ler análises da organização em docs.padlet.dev.

Para quem é este artigo

Este artigo é para:

  • Proprietários e administradores de contas Padlet para Escolas ou de equipe
  • Proprietários e professores de contas de sala de aula

Você não precisa escrever código para usar o caminho MCP. O caminho da API é opcional para usuários avançados que já trabalham com a API pública.

O que você já tem

A página Análises da sua organização, em Configurações, já mostra abas selecionadas para o período de cobrança atual. Escolas e salas de aula têm as abas Visão geral, Uso, Impacto, Segurança, Principais usuários e Todos os usuários. As equipes têm Geral, Padlets e Usuários ou, se sua equipe tiver a nova página de Análises (beta), Visão geral, Uso, Impacto, Principais usuários e Todos os usuários.

Use o painel quando quiser uma visão geral visual rápida. Use o MCP ou a API quando precisar de um recorte personalizado que as abas não respondam tão bem.

O que o MCP / a API acrescentam

O painel oferece abas selecionadas. O MCP e a API permitem solicitar exatamente o recorte de que você precisa:

  • Perguntas em linguagem simples no seu cliente de IA ("quais professores ficaram inativos no último período de cobrança?")
  • Combinações personalizadas de métricas de engajamento, participação e segurança do conteúdo
  • Séries mensais em um intervalo de datas
  • Recortes por função (professores vs. estudantes, criadores vs. colaboradores)
  • Principais padlets, usuários e mídias, classificados da forma que você pedir
  • Respostas que você pode colar em uma apresentação de QBR ou renovação
As métricas de segurança do conteúdo (itens analisados, itens sinalizados, taxa de detecção) estão disponíveis somente para escolas e salas de aula. Se você solicitá-las para uma organização de equipe, receberá um erro, não um zero.

Início rápido com o Padlet MCP

  1. Conecte o Padlet MCP ao seu cliente de IA. Use o URL do servidor https://mcp.padlet.com. As instruções completas de configuração estão em Servidor Padlet MCP.
  2. Entre e autorize o acesso como administrador da organização que você quer consultar. Em uma sala de aula, um professor também pode obter análises.
  3. Faça perguntas em linguagem simples. Não é preciso mencionar ferramentas internas. Diga ao assistente de IA o que você quer saber sobre sua escola, sala de aula ou equipe, e ele usará o Padlet MCP em seu nome.

Veja um exemplo:

Se um cliente MCP específico ainda não mostrar respostas sobre análises, experimente outro cliente compatível com MCP ou use a API de análise da organização. O suporte dos clientes pode demorar a acompanhar o servidor.
O assistente age em seu nome. Ele só pode obter as análises que sua conta conectada tem permissão para ver.

Opcional: API de análise da organização

Prefere criar seu próprio script? Use a API pública com uma chave de API de administrador (ou uma chave de professor em uma sala de aula).

  1. Crie ou copie uma chave de API na página Desenvolvedor, em Configurações. Consulte o artigo API pública para saber mais.
  2. Encontre o ID da sua organização usando GET /me?include=organizations. Você precisa de um ID wksp_. Organizações org_ em padlet.org ainda não são compatíveis com este endpoint.
  3. Envie uma solicitação POST para /organizations/{org_id}/analytics com as métricas desejadas.
  4. Se a resposta for 202 ou meta.pending não estiver vazio, aguarde o tempo indicado em Retry-After e envie novamente uma solicitação idêntica. As análises são calculadas em segundo plano, então uma métrica pendente não aparece na resposta. Nunca a considere como zero.
Os formatos completos das solicitações, o catálogo de métricas e exemplos práticos estão em Ler análises da organização.

Quem pode usar

As análises da organização pelo Padlet MCP e pela API estão disponíveis para proprietários e administradores de contas Padlet para Escolas e de equipe, e para proprietários e professores de contas de sala de aula. Não é necessário pedir ao Padlet para ativar esse recurso.

No momento, só há suporte para organizações wksp_.

Exemplos de prompts

Você pode copiar estes exemplos para seu cliente MCP. Ajuste o texto à sua escola, sala de aula ou equipe e confira os números na página Análises ao preparar uma apresentação para clientes.

  • "Para nossa escola neste período de cobrança, quantos professores estão ativos em comparação com as licenças, e em quais meses houve queda?"
  • "Quais padlets da organização têm mais visualizações? Liste os 3 principais murais/ambientes de teste."
  • "Quais membros com função de professor não usaram o Padlet nos últimos 12 meses?"
  • "Quantos membros não têm o domínio de e-mail <ouremaildomain.edu>?"
Peça o recorte de que precisa: uma série mensal, um filtro por função, os principais padlets por publicações ou visitantes, ou totais de segurança do conteúdo para uma escola ou sala de aula. O assistente associará sua pergunta às métricas disponíveis.

O que o painel ainda faz melhor

Use a página Análises em Configurações quando quiser:

  • O banner visual Visão geral, os destaques das principais oportunidades e a solicitação de desenvolvimento profissional com um clique
  • A tabela Todos os usuários / Usuários, com pesquisa, filtros por função e download de CSV com um clique
  • Listas para download de professores ativos e inativos no período selecionado, na aba Visão geral (escolas e salas de aula)

O MCP e a API são ideais quando as abas selecionadas não respondem à pergunta exata de que você precisa para uma demonstração ou conversa sobre renovação.

Limitações:

  • Limite de solicitações: 60 solicitações por hora por chave de API e organização, incluindo consultas após uma resposta 202
  • Intervalo de datas: no máximo 24 meses por solicitação
  • Segurança do conteúdo: somente para escolas e salas de aula. As equipes recebem um erro 400 para essas métricas
  • Contagens de membros: refletem a lista de membros atual, não um registro histórico de quem fazia parte da organização na época
  • Pendente ≠ zero: uma métrica ainda em processamento não aparece na resposta; não a considere como zero
  • Tipo de organização: no momento, somente wksp_

Perguntas frequentes

Por que recebo um erro 404 ao solicitar análises?

Todas as solicitações negadas têm a mesma resposta: tanto uma organização desconhecida quanto a falta de acesso retornam 404. Confira se você entrou como administrador (ou professor, em uma sala de aula) dessa organização e se ela é uma organização wksp_. Ainda precisa de ajuda? Entre em contato com o suporte.

Preciso escrever código?

Não. Conecte o Padlet MCP, entre como administrador e faça perguntas em linguagem simples. O caminho da API é opcional para desenvolvedores e usuários avançados que já usam a API pública.

É a mesma coisa que a API pública?

São recursos relacionados, mas não são a mesma interface de produto. A API pública é para desenvolvedores que usam uma chave de API. O Padlet MCP é para assistentes de IA que você autoriza ao entrar na sua conta. Ambos podem acessar as análises da organização, e você pode usar um ou os dois.

Estudantes ou pessoas que não são administradoras podem ver as análises da organização dessa forma?

Não. Para consultar as análises, é preciso ser administrador da organização ou professor em uma sala de aula. O assistente tem exatamente o mesmo acesso que a conta usada para entrar, nada além disso.

Meu cliente MCP parece não reconhecer as análises. O que devo tentar?

Alguns clientes demoram para atualizar a lista de ferramentas. Tente reconectar o Padlet MCP, mudar para outro cliente compatível com MCP ou usar diretamente a API de análise da organização. Se ainda precisar de ajuda, fale conosco.

Conteúdo relacionado

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

関連記事