FrameworkQA MCP

Servidor MCP do FrameworkQA — 40 tools para autoria e consulta de fluxos de teste, passos, bugs, ocorrências, execuções e relacionamentos, direto do seu cliente de IA (Claude Code, Cursor, Claude Desktop).

• Auth: sliding window via tool login (email/senha) → access 7d + refresh 30d com rotação automática. As credenciais ficam só na sua máquina (~/.frameworkqa/credentials.json).
• Backend: consome exclusivamente /api/mcp/* do FrameworkQA (endpoints agregados, zero N+1).
• Versão: 6.5.0 · Pré-requisito: Node.js 18+.

✅ Use via npx. O caminho suportado é npx -y frameworkqa-mcp@latest — sem git clone, sem npm install, sem caminho absoluto. Cada start resolve a versão mais nova publicada no npm. (git clone agora serve só para desenvolver/contribuir com o pacote, não para usar.)

Instalação (cada QA na própria máquina)

A documentação de setup canônica e sempre atualizada é servida pelo próprio backend — use ela como fonte da verdade:

• 🔗 https://testesimples.om30.cloud/api/mcp/docs/setup-local/ (público, sem login)
• Ou, se você já tem qualquer MCP funcionando, peça à IA: “Use a tool obter_documentacao_setup”

Resumo do fluxo (a config já roda npx, não instala nada localmente):

Claude Code (CLI) — recomendado, escopo de usuário:

claude mcp add -s user frameworkqa -- npx -y frameworkqa-mcp@latest

Cursor (.cursor/mcp.json) ou Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "frameworkqa": {
      "command": "npx",
      "args": ["-y", "frameworkqa-mcp@latest"]
    }
  }
}

Depois, no chat, faça login (uma vez):

Use a tool login com:
  url: https://testesimples.om30.cloud
  email: [email protected]
  senha: sua-senha

Valide com a tool status. Passo a passo completo, manutenção e FAQ: ver o endpoint canônico acima.

Por que MCP local? Cada QA roda o seu próprio MCP local (via npx) com sua credencial, então toda ação é registrada com a autoria correta (CriadoPor/AtualizadoPor). O antigo daemon central HTTP foi aposentado — compartilhava credenciais (tudo saía como o dono do processo) e não é mais um canal disponível.

Auth sem senha no chat (CI / agents)

Alternativas à tool login:

• Tool login_token com um JWT access pré-gerado (validado contra /api/mcp/auth/login/).
• Env vars no boot: FRAMEWORKQA_ACCESS_TOKEN (+ FRAMEWORKQA_URL opcional para a base URL). Ver .env.example.

Tools (40)

São 40 tools. Muitas são consolidadas por discriminador — reads via acao/nivel, writes via op/tipo —, então uma única tool cobre várias operações (ex.: fluxos_query, passos_query, execucoes_query, *_batch). As ondas de consolidação (v5/v6) reduziram o conjunto de ~63 (v4) para 39 sem perder cobertura. A lista canônica com descrições completas vive no schema do próprio servidor — conecte o MCP e liste, ou peça a tool obter_documentacao_setup (guia de uso pros agentes). Histórico por versão: CHANGELOG.md.

Famílias:

• Auth (4): login, login_token, logout, status
• Navegação & contexto (4): navegacao_query (nivel: sistemas/módulos/telas), obter_tela_completa, obter_componente, busca_global
• Estrutura de documentação — batch (7): sistemas_batch, modulos_batch, telas_batch, componentes_batch (tipo Componente/Modal/Aba/Dialog/Grupo; grupoPaiId para agrupamento 1 nível; cascata p/ deletar container com filhos), validacoes_batch, relacionamentos_componente_batch, notas_batch (cada uma com op criar/atualizar/deletar por item)
• Fluxos (5): fluxos_query (acao: listar/obter/stats/relacionamentos/rotulos), criar_fluxo, atualizar_fluxo (só metadados — passos via passos_fluxo_batch/passos_base_batch), fluxo_relacionamentos (op: criar/remover), arquivar_fluxo
• Passos (4): passos_query (acao: tela_passos/similares/base_listar/base_sugerir/base_obter), passos_base_batch, passos_fluxo_batch, passo_imagem (op: anexar/remover/obter; tipo: base/fluxo; path ou base64; png/jpg/webp/gif; até 20 MB)
• Bugs & ocorrências (13): criar_bug, obter_bug, atualizar_bug, listar_bugs_tela, buscar_bugs_similares, vincular_bug_passo_base, desvincular_bug_passo_base, criar_ocorrencia_em_bug, obter_ocorrencia, atualizar_ocorrencia, fechar_ocorrencia, reabrir_ocorrencia, listar_lookups
• Execuções (1): execucoes_query (acao: fluxo_execucoes/fluxo_ultima/fluxo_stats/execucao_completa/plano_listar/plano_detalhes/falhas_recentes)
• Suites (1): obter_suite
• Docs (1): obter_documentacao_setup

Deploy do daemon central (HTTP) — APOSENTADO

⚠️ Aposentado. O daemon central HTTP (modo --http na porta 4000, atrás de nginx em /mcp/, systemd frameworkqa-mcp.service) foi desativado. O modelo suportado é o MCP local por-QA via npx -y frameworkqa-mcp@latest. O DEPLOY.md permanece apenas como histórico/arquivado (referência de rollback) — não use para nova instalação.