Guia do Usuário: Casos de Uso e Exemplos de Instruções do MCP
Assim que seu assistente estiver conectado, a maneira mais rápida de aprender o que o Servidor MCP pode fazer é copiar um prompt. Tudo abaixo está escrito da mesma forma que você digitaria no Claude, Cursor ou Codex. As ferramentas nomeadas de acordo com cada grupo são aquelas que o assistente utiliza, então você pode consultá-las no Guia de Referência de Ferramentas MCP do UserGuiding .
Ainda não está conectado? Comece configurando o servidor MCP do UserGuiding .
Produto e crescimento: como está o desempenho do produto?
Comece com uma visão geral e depois aprofunde-se. Uma pergunta sobre todo o projeto geralmente se transforma em três perguntas subsequentes sobre um único guia, e o assistente as encadeia sem que você mencione uma única ferramenta.
- "Me dê um resumo do engajamento dos últimos 30 dias e me diga o que mudou em comparação com as duas semanas anteriores."
- "Quais guias foram mais acessados no mês passado e qual deles teve a pior taxa de conclusão?"
- "Mostre-me o funil de etapas do guia de integração dos últimos 90 dias. Onde as pessoas desistem?"
- Quantos usuários adotaram o recurso export_csv neste trimestre e ele é permanente ou foi implementado apenas uma vez?
- "Monitore o uso semanal do novo evento do painel desde o seu lançamento e me diga se ele ainda está crescendo."
Ferramentas: get_project_overview , get_material_performance , get_guide_step_funnel , analyze_feature_adoption , get_event_timeseries , get_goal_performance .
Ativação e retenção: quem permanece por mais tempo
As perguntas sobre cohort são aquelas em que as planilhas têm mais dificuldade, e cada uma delas corresponde a uma chamada do MCP.
- "Crie uma matriz de retenção semanal para usuários que se cadastraram pela primeira vez nos últimos três meses. Qual é o formato médio dessa curva?"
- "Os usuários que concluíram a lista de verificação de integração retêm melhor o conteúdo do que aqueles que não a concluíram?"
- "Quais de nossas metas estão sendo de fato alcançadas e quais ninguém atingiu neste trimestre?"
- "Compare a taxa de conclusão de cada lista de verificação que temos, da melhor para a pior."
Ferramentas: analyze_retention , get_checklist_item_stats , get_goal_performance , get_material_performance .
Segmentação sem o construtor de filtros
Descreva o público-alvo em uma frase. O assistente primeiro descobre os nomes dos seus atributos e eventos, dimensiona o público e, em seguida, salva o segmento assim que você concordar com o número.
- "Quantos usuários estão no plano Pro, se inscreveram nos últimos 30 dias e executaram o comando export_csv pelo menos uma vez?"
- "Crie um segmento chamado Usuários Avançados: plano empresarial, mais de dez sessões e guia de integração concluído."
- "Crie um segmento para contas que tenham o churn_risk definido como verdadeiro ou que não tenham sido visualizadas nos últimos 30 dias e que estejam em um plano pago."
- "Atualize o segmento de Usuários em Período de Avaliação para que também exclua qualquer pessoa que já tenha feito o upgrade."
- "Pegue o segmento de Administradores Corporativos e me diga com o que seus membros realmente interagiram no mês passado."
Ferramentas: list_attributes , list_events , get_user_count , create_segment , update_segment , list_segments , get_segment_user_interactions .
Dica: pergunte a quantidade de participantes antes de perguntar sobre o segmento. Isso custa apenas uma ligação e evita que o público-alvo seja mal interpretado antes de se tornar um público salvo.
Sucesso do Cliente: saúde da conta e pesquisa pré-chamada
Tudo o que você normalmente precisaria abrir quatro abas para ver, em um único aviso antes de uma ligação de renovação.
- "Consulte o perfil do usuário [email protected]. Qual plano ele utiliza, quando se cadastrou e o que fez no produto esta semana?"
- "Qual é o nível de engajamento da Acme Corp neste mês em comparação com o mês passado? Eles estão ficando mais quietos?"
- "Quais funcionalidades a equipe da Acme Corp utilizou efetivamente nos últimos 60 dias e quem são os seus membros mais ativos?"
- "Encontre usuários do plano Starter que atingiram o limite de taxa de requisições da API (api_rate_limit_hit) mais de dez vezes neste mês. Esses são os meus contatos para oferecer um upgrade."
Ferramentas: get_user , get_user_activities , get_company , get_company_engagement , search_users , list_users_by_event .
Suporte: contexto completo em um ticket
Elimina a troca de duas ou três mensagens que geralmente começa com "em qual plano você está?".
- "Obtenha o perfil completo do usuário [email protected] para que eu possa ver o plano dele, os recursos que ele usa e sua atividade recente."
- "Este usuário chegou a visualizar o banner de atualização de faturamento e o ignorou?"
- "Pesquise na base de conhecimento por artigos sobre configuração de SSO e me envie os dois melhores links."
- "Este cliente diz que o processo de integração está travado. Redefina o histórico do Guia do Usuário para que ele possa visualizá-lo novamente."
Ferramentas: get_user , get_user_activities , search_kb_articles , get_kb_article , reset_user_history .
Feedback e pesquisas
- "Resuma a pesquisa NPS do último trimestre: taxa de resposta, distribuição de pontuação e onde as pessoas desistiram."
- "Leia as respostas em texto livre das últimas 50 respostas à pesquisa Motivos de Cancelamento e agrupe-as em temas."
- "Qual de nossas pesquisas teve a pior taxa de resposta neste mês?"
Ferramentas: get_survey_report , list_survey_responses , get_material_performance .
Base de conhecimento: escrever, organizar e migrar
As ferramentas da Base de Conhecimento abrangem toda a estrutura, não apenas o corpo dos artigos, portanto, "reorganizar a central de ajuda" é uma sugestão real, em vez de uma tarde inteira de cliques.
- "Redija um novo artigo sobre nossa nova configuração de SSO, no mesmo tom dos artigos existentes na categoria Primeiros Passos."
- "O artigo 299 está desatualizado desde que implementamos as novas opções de indexação. Atualize-o."
- "Mostre-me a estrutura da central de ajuda e diga-me quais categorias ainda não têm títulos em português."
- "Crie uma subcategoria de Faturamento em Configurações e mova esses cinco artigos para dentro dela."
- "Nosso antigo centro de ajuda está em support.example.com. Descubra em qual plataforma ele funciona para que possamos planejar a migração."
Ferramentas: search_kb_articles , get_kb_article , create_kb_article , update_kb_article , list_kb_categories , create_kb_sub_category , assign_kb_articles , detect_kb_platform .
Os artigos escritos desta forma são enviados como rascunhos. Você os revisa e publica a partir do painel, portanto, nada chega à sua central de ajuda sem que uma pessoa clique em "Publicar".
Atualizações de produtos: anuncie o que foi enviado.
- "Leia nossas últimas cinco postagens sobre atualizações de produtos e, em seguida, escreva uma sobre os novos filtros do painel, usando o mesmo tom."
- "Quais posts sobre atualizações de produtos tiveram o maior número de visualizações no mês passado?"
- Quantas vezes a página de atualizações de produtos foi acessada nos últimos 30 dias?
- "Adicione a etiqueta Beta à publicação sobre a nova API e corrija o erro de digitação no segundo parágrafo."
Ferramentas: list_product_updates_posts , create_product_updates_post , update_product_updates_post , get_material_performance , count_events .
Roteiro e solicitações de recursos: limpe a caixa de entrada
- "Quantas solicitações de recursos estão aguardando moderação e quais são as colunas do roteiro?"
- "Mostre-me as solicitações de recursos pendentes, classificadas por votos, e resuma os temas."
- "Aprove os três primeiros, rejeite tudo o que for obviamente spam e me diga o que você fez."
- "O que está atualmente no quadro do roteiro público, coluna por coluna?"
Ferramentas: get_roadmap_overview , list_feature_requests , get_feature_request , approve_feature_request , reject_feature_request , list_roadmap_items .
Obtendo melhores respostas
- Dê um nome ao período. "Últimos 30 dias" ou um intervalo de datas explícito é melhor do que "recentemente". Os intervalos são limitados a um ano.
- Solicite a quantidade antes da lista. Dimensionar o público-alvo é uma coisa. Obter milhares de perfis não é, e listas de resultados extensas são reduzidas.
- Digamos, por exemplo, pessoas ou eventos. "Quantos usuários adotaram X" e "quantas vezes X aconteceu" são perguntas diferentes, que exigem ferramentas diferentes, e as respostas raramente coincidem.
- Deixe que o sistema descubra os nomes. Se você não tiver certeza se o evento é
signupousigned_up, peça ao assistente para listar os eventos primeiro. - Confirme antes de escrever. Peça para ver os filtros de segmento, o rascunho do artigo ou a lista de solicitações que planeja aprovar antes de confirmar.