FrameworkQA MCP (simplificado)

MCP que usa token JWT diretamente nas requisições. Sem login por email/senha.

Instalação via npm

npm install frameworkqa-mcp

O postinstall do pacote gera ou atualiza automaticamente o .cursor/mcp.json do projeto, com o servidor frameworkqa já configurado e o caminho do pacote preenchido. Você só precisa colar seu token no lugar do placeholder.

O que é gerado

• Arquivo: .cursor/mcp.json (na raiz do projeto onde você rodou o install).
• Entrada do servidor frameworkqa com:
  • command: "node"
  • args: caminho absoluto do index.js do pacote instalado
  • env.FRAMEWORKQA_API_URL: "https://testesimples.om30.cloud" (pode editar depois)
  • env.FRAMEWORKQA_ACCESS_TOKEN: "COLE_SEU_TOKEN_AQUI" → troque por seu token JWT

Depois do install

1. Abra .cursor/mcp.json e substitua COLE_SEU_TOKEN_AQUI pelo valor de access que você obtém no login da API (POST .../api/Autenticacao/token/ com email e senha).
2. Reinicie o MCP no Cursor (desligar/ligar o servidor "frameworkqa") para carregar a config.

Se você instalar com variáveis de ambiente, o postinstall já preenche:

FRAMEWORKQA_ACCESS_TOKEN=seu_token_aqui npm install frameworkqa-mcp

Ou para URL customizada:

FRAMEWORKQA_API_URL=https://sua-api.example.com FRAMEWORKQA_ACCESS_TOKEN=seu_token npm install frameworkqa-mcp

Instalação global

Se você usar npm install -g frameworkqa-mcp, o postinstall não altera nenhum .cursor/mcp.json (ele só roda quando o pacote está em node_modules de um projeto). Nesse caso, adicione manualmente o servidor no mcp.json, usando o caminho global do pacote.

Tools (tudo por slug)

• listar_sistemas — Lista sistemas (nome e slug). Use para descobrir o slug do sistema.
• listar_modulos — Lista módulos de um sistema (slug_sistema). Use para descobrir o slug do módulo.
• listar_telas — Lista telas de um módulo (slug_sistema, slug_modulo). Use para descobrir o slug da tela.
• estatisticas_fluxos — Contagens por sistema/módulo/tela (filtros opcionais).
• listar_fluxos_filtrados — Lista fluxos com filtros (sistema, módulo, tela, q) e opção apenas_nao_automatizados.
• listar_fluxos — Lista fluxos de uma tela (slug_sistema, slug_modulo, slug_tela).
• obter_fluxo — slug_fluxo (ex.: FT0001).
• criar_fluxo — slug_sistema, slug_modulo, slug_tela, titulo, versao, passos (JSON), + opcionais.
• atualizar_fluxo — slug_fluxo, campos (JSON).

Pré-requisito

Node.js 18+.