🔌 Analise testes SUM conversando com o Claude

O servidor MCP do SUM Analyzer conecta o Claude Code (no terminal ou no VS Code) à mesma metodologia deste app: SUM Score de Sauro & Kindlund (2005), com Z-scores, benchmarks KLM/P95 e comparação de interfaces. Os CSVs do Maze são lidos direto do seu disco; você só conversa.

1 Pré-requisitos

Node.js 18+: confira com node --version (instale em nodejs.org se precisar)
Claude Code: no terminal (claude) ou pela extensão do VS Code

2 Instalar (escolha um caminho)

A · Individual 1 comando

Fica disponível em todos os seus projetos. Rode uma única vez:

claude mcp add sum-analyzer -- npx -y sum-analyzer-mcp

B · Para o time todo zero comando

Num repositório compartilhado (ex: onde ficam os exports do Maze), commite um arquivo .mcp.json na raiz. Quem abrir o projeto no Claude Code recebe o servidor automaticamente; basta aprovar no primeiro uso:

{ "mcpServers": { "sum-analyzer": { "command": "npx", "args": ["-y", "sum-analyzer-mcp"] } } }

✨ Atualizações são automáticas nos dois caminhos: o npx -y sempre resolve a versão mais recente publicada, então ninguém precisa reinstalar nada.

3 Organizar os CSVs do Maze

teste-menu/ ├── Porto/ ← uma pasta por interface (comparação múltipla) │ ├── Tarefa 1_.csv ← missão (métricas principais) │ ├── Tarefa 1_...satisfação....csv │ ├── Tarefa 1_...difícil....csv │ ├── Tarefa 1_...tempo que levou....csv │ └── Tarefa 1_...comentar....csv └── Bradesco/ └── ...

Nomes aceitos: Tarefa 1, Task 1 ou Missão 1 (acentos não atrapalham)
O tipo de cada CSV é identificado pela pergunta no nome ou pelo conteúdo, então nome fora do padrão não quebra
Pasta única = teste único · pasta única com As_IS/To_Be nos nomes = comparativo clássico · subpastas nomeadas = comparação múltipla (2–6)

4 Usar: é só conversar

"Analisa os testes SUM em ~/Downloads/teste-menu, comparando as pastas Porto e Bradesco. Qual venceu e onde está o gargalo?"

"Gera o KLM desta jornada: o usuário abre o menu, procura Empréstimos, clica, preenche o CPF e confirma. Perfil intermediário com uso semanal. Depois recalcula o SUM usando esse benchmark."

"Quais temas aparecem nos comentários negativos da Tarefa 2? Cruza com as métricas."

🧰 O que o Claude ganha

Ferramenta	O que faz
`detect_maze_files`	Varre a pasta e mostra o que foi identificado (task, tipo, versão) antes de calcular
`analyze_sum`	SUM Score por task e geral, com as 4 dimensões, métricas brutas e comentários dos usuários para análise qualitativa
`klm_from_operators`	O Claude descreve a jornada em operadores KLM e o servidor valida e soma; o total vira benchmark de eficiência
`sum_methodology`	A documentação da metodologia, para respostas com rigor acadêmico

❓ Problemas comuns

"command not found: claude"

O Claude Code não está instalado ou não está no PATH. Instale pelo site da Anthropic ou, no VS Code, use a extensão Claude Code e o terminal integrado.

O servidor não aparece na conversa

Verifique com claude mcp list (deve listar sum-analyzer). No caminho B, confirme que o .mcp.json está na raiz do projeto aberto e aceite a aprovação que o Claude Code mostra no primeiro uso. Em sessão aberta, digite /mcp para ver o status.

"Nenhuma task detectada"

Os nomes dos CSVs precisam conter o número da task (Tarefa 1/Task 1). Peça ao Claude para rodar detect_maze_files na pasta — ele mostra exatamente o que foi (e o que não foi) reconhecido.

Primeira execução demora

Normal: o npx baixa o pacote na primeira vez. Nas seguintes, usa o cache.

Qual a diferença para o app?

Mesma metodologia e mesmo código de cálculo (sum-core). O app entrega o dashboard visual e a captura via plugin; o MCP entrega análise conversacional, automação e cruzamentos qualitativos (os históricos são independentes).

← SUM Analyzer Pacote no npm Paper (Sauro & Kindlund, 2005) 💙 Criado por Paulo Ortega