Como posso pedir ao Padlet MCP as análises de administração?
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 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.
- Análises de contas escolares (Padlet para Escolas e salas de aula)
- Análises de contas de equipe
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
Início rápido com o Padlet MCP
- 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. - 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.
- 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:

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).
- Crie ou copie uma chave de API na página Desenvolvedor, em Configurações. Consulte o artigo API pública para saber mais.
- Encontre o ID da sua organização usando
GET /me?include=organizations. Você precisa de um IDwksp_. Organizaçõesorg_em padlet.org ainda não são compatíveis com este endpoint. - Envie uma solicitação
POSTpara/organizations/{org_id}/analyticscom as métricas desejadas. - Se a resposta for
202oumeta.pendingnão estiver vazio, aguarde o tempo indicado emRetry-Aftere 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.
Quem pode usar
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>?"
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
400para 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
- Servidor Padlet MCP
- Análises de contas escolares
- Análises de contas de equipe
- API pública
- Ler análises da organização (documentação para desenvolvedores)
