Servidor MCP para atender chamados do GestãoX (EMX) e preparar tickets do Azure DevOps.
Strong foundation with 15 well-named tools following verb_noun convention. All tools have descriptions (avg 120 chars) and input schemas with Zod validation. Tool annotations present (readOnlyHint/destructiveHint/idempotentHint). Key gaps: output schemas not documented in code; error handling lacks recovery guidance; some parameter descriptions could be more prescriptive about constraints and formats; write operations include idempotencyKey and confirmed guards (good), but no explicit dry-run validation shown in implementation.
Registra um andamento no chamado (tela Inserir atividade). Verifica a gravação relendo o histórico. Escrita.
Analisa completude, SLA, risco e próximos passos, e gera rascunho de resposta. Sem rede além da leitura do chamado.
Assume o chamado para o atendente (diálogo Sim/Não). Verifica que a ação de assumir sumiu da linha. Escrita.
Registra andamento/comentário no chamado pela tela de atendimento (NÃO cria atividade de workflow). Escrita.
Abre um novo chamado no GestãoX (viewIncidenteDireto). Cascata departamento→serviço→solicitante. Escrita.
Detalhe completo do chamado com todos os campos do formulário de alteração. Somente leitura.
Output schemas not documented. Code shows tools return result() but no schema definitions visible for response structure. LLMs cannot plan downstream calls or extract fields without knowing what each tool returns.
Error handling lacks recovery guidance. Code shows throw new Error() with messages like 'Backend atual não suporta detalhe' but no structured error classification (retryable vs user-fixable vs fatal) or actionable next steps for LLM.
Parameter descriptions lack prescriptive constraints. E.g., 'status' in gestaox_resolve_ticket says 'Novo status exato (ex.: RESOLVIDO)' but does not enumerate valid values or state format rules. LLMs may hallucinate invalid statuses.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2025-06-18+ | v2 |
Histórico completo do chamado: todas as movimentações (usuário, status, grupo, data, SLA, descrição) e anexos. Somente leitura.
Detalhe de um chamado (RetornaDetalhesChamados). Somente leitura.
Verifica o backend configurado (mock ou gestaox) sem alterar dados.
Lista chamados da fila do atendente no GestãoX (RetornaChamadosLista). Somente leitura.
Lê notas operacionais sanitizadas gravadas pelo plugin.
Registra decisão/aprendizado sanitizado; nunca use para credenciais ou dado pessoal.
Gera prévia de work item ADO + termo de busca de duplicidade a partir do chamado. NÃO cria o item.
Resolve/fecha ou muda o status do chamado pela tela de atendimento. Status válidos incluem RESOLVIDO, CANCELADO, EM ANÁLISE etc. Escrita.
Transfere o chamado para outro grupo (e opcionalmente atendente). No GestãoX transferir é um andamento com grupo de destino. Escrita.
Dry-run and confirmation flow not validated in visible code. Write tools accept dryRun and confirmed parameters, but no explicit validation shown that confirmed=true is enforced before state mutation, or that dryRun actually prevents writes.
No pagination documented for list_tickets. Tool accepts limit (max 500) but no offset/cursor or total_count in visible schema. Large result sets risk context window exhaustion.