Como posso pedir ao Padlet MCP as análises de administrador (Beta)?

Os números no Painel de administração da escola ou da equipe não são apresentados da forma que você gostaria? 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 acesse a API de análise da organização diretamente.

Para quem é este artigo

Este artigo é para:

• Proprietários e administradores de contas Padlet para Escolas ou Equipes
• Proprietários e professores de contas de Sala de Aula

Você não precisa escrever código para usar o MCP. O uso 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á exibe guias selecionadas para o período de cobrança atual. Escolas e salas de aula têm as guias Visão geral, Uso, Impacto, Segurança, Principais usuários e Todos os usuários. Equipes têm as guias Geral, Padlets e Usuários ou, se a sua equipe tiver a nova página Análises (beta), Visão geral, Uso, Impacto, Principais usuários e Todos os usuários.

• Análises de contas escolares (Padlet para Escolas e Sala de Aula)
• Análises de contas de equipes

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 guias não respondam tão bem.

O que o MCP e a API oferecem

O painel apresenta guias selecionadas. Com o MCP e a API, você pode solicitar exatamente o recorte de que 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 para um intervalo de datas
• Recortes por função (professores e alunos, criadores e colaboradores)
• Principais Padlets, usuários e mídias, classificados conforme sua solicitação
• Respostas que você pode copiar e colar em uma apresentação de revisão trimestral do negócio (QBR) ou de renovação

Início rápido com o Padlet MCP

1. Conecte o Padlet MCP no seu cliente de IA. Use o URL do servidor https://mcp.padlet.com. Encontre as instruções completas de configuração em Servidor Padlet MCP.
2. Entre e autorize o acesso como administrador da organização que você quer consultar. Em uma conta de Sala de Aula, um professor também pode consultar as análises.
3. Faça perguntas em linguagem simples. Não é necessário 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.

Aqui está um exemplo:

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

Prefere criar seus próprios scripts? Use a API pública com uma chave de API de administrador (ou uma chave de professor em uma conta de 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 mais detalhes.
2. Encontre o ID da sua organização com 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 a solicitação idêntica. As análises são calculadas de forma assíncrona — uma métrica pendente não aparece na resposta, não tem valor zero. Nunca considere uma métrica pendente como zero.

Acesso ao piloto

Exemplos de solicitações

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

• "Neste período de cobrança, quantos professores estavam ativos em nossa escola em comparação com o número de licenças? E em quais meses houve uma queda?"
• "Quais Padlets da organização têm mais visualizações? Mostre 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>?"

O que o painel ainda faz melhor

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

• O banner visual da Visão geral, os destaques de principais oportunidades e a opção de solicitar desenvolvimento profissional (PD) com um clique
• A tabela Todos os usuários / Usuários, com busca, filtros por função e download de CSV com um clique
• Listas para baixar de professores ativos e inativos no período selecionado, na guia Visão geral (escolas e salas de aula)
• Uma visualização que não exige inscrição no piloto — a própria página Configurações está disponível para as funções elegíveis, sem ativar o acesso à API

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

Limitações:

• Limite de solicitações: 60 solicitações por hora para cada chave de API e organização, incluindo as 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 uma resposta 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 naquele momento
• Pendente ≠ zero: uma métrica ainda em processamento não aparece na resposta; não a considere como zero
• Tipo de organização: por enquanto, somente wksp_

Perguntas frequentes

Conteúdo relacionado

• Servidor Padlet MCP
• Análises de contas escolares
• Análises de contas de equipes
• API pública
• Ler dados de análise da organização (documentação para desenvolvedores)