Deixe seu agente de IA cuidar do seu QA.

Instalar

Um comando só — clona e registra no Claude Code e/ou Gemini CLI automaticamente (instale o Bun antes, se ainda não tiver: curl -fsSL https://bun.sh/install | bash):

curl -fsSL https://raw.githubusercontent.com/jonathan-ponciano/sts-tools-mcp-tuxedo-qa/main/install.sh | bash

Instala em ~/tuxedo-qa (mude com TUXEDO_QA_DIR=/outro/caminho). Rodar de novo atualiza — seguro de repetir.

Instalação local

git clone https://github.com/jonathan-ponciano/sts-tools-mcp-tuxedo-qa.git
cd tuxedo-qa
bun install

Configuração

Claude Code:

claude mcp add tuxedoqa --scope user -- bun "$(pwd)/src/index.ts"

Gemini CLI (sem -- antes do comando):

gemini mcp add tuxedoqa bun "$(pwd)/src/index.ts" --scope user

Gemini CLI / Claude Code / Antigravity / opencode via config JSON:

{
  "mcpServers": {
    "tuxedoqa": {
      "command": "bun",
      "args": ["/caminho/absoluto/para/tuxedo-qa/src/index.ts"]
    }
  }
}

Antigravity / Cursor (chave mcp.servers):

{
  "mcp.servers": {
    "tuxedoqa": {
      "command": "bun",
      "args": ["/caminho/absoluto/para/tuxedo-qa/src/index.ts"]
    }
  }
}

Lista completa das 16 ferramentas disponíveis e o que cada uma faz logo abaixo.

(Opcional) iniciar o dashboard local

bun run dashboard
# → http://localhost:3131

Monitorando mais de um app/cliente?

Uma instalação só serve vários projetos isolados, com um dashboard só pra ver todos — veja a seção detalhada abaixo.

Rode /tuxedo-qa ou descreva o fluxo pro seu agente

"Crie um teste Playwright que faz login no staging e confere se o dashboard carrega" — o Claude ou Gemini chama create_test, salva a spec, e pode rodar na hora com run_tests. No Claude Code, /tuxedo-qa já confere a instalação e conhece as convenções do projeto sozinho.

(Opcional) ver o navegador rodando

Por padrão todo teste roda headless (sem janela). Pra acompanhar visualmente o que está acontecendo, passe PWHEADED=1 antes do comando — funciona rodando direto, pelo dashboard, ou disparado pelo Claude/Gemini:

PWHEADED=1 bun run test

Registrar um novo projeto

Rode o instalador de novo passando um slug — ele reaproveita a mesma instalação, só registra uma nova conexão MCP:

TUXEDO_QA_PROJECT=fretebras bash install.sh
TUXEDO_QA_PROJECT=xtagger bash install.sh

Isso registra tuxedoqa-fretebras e tuxedoqa-xtagger como servidores MCP separados, cada um isolado em projects/fretebras/ e projects/xtagger/.

Usar cada projeto pelo Claude/Gemini

Escolha a conexão MCP certa pra cada conversa — tuxedoqa-fretebras quando o assunto for o Fretebras, tuxedoqa-xtagger pro xtagger. Cada uma só vê o próprio projeto.

Ver e gerenciar tudo num dashboard só

Suba o dashboard uma vez (sem precisar de TUXEDO_QA_PROJECT nenhum):

npm run dashboard

A aba Monitor mostra todos os projetos juntos (testes, uptime, o que tá rodando agora). Clicar num projeto ali — ou no seletor no topo — troca o contexto do resto do dashboard pra aquele projeto.

Monitoramento automático, por projeto

O scheduler roda dentro do dashboard e verifica todos os projetos a cada minuto. Se um tem teste agendado a cada 1h e outro a cada 6h, cada um roda no seu próprio horário, de forma independente — enquanto o dashboard estiver de pé.