bugAgent

MCP v1

Navegação

Model Context Protocol

MCP

Conecte o bug_Agent_ a qualquer cliente de IA compatível com MCP.

Registre, classifique e gerencie bugs, solicitações de recursos e muito mais diretamente do seu assistente de codificação com IA. Sem alternância de contexto, sem copiar e colar — basta descrever o problema e o bug_Agent_ cuida do resto.

Comunidade no Discord support@bugagent.com

Começando

O servidor MCP do bug_Agent_ permite que clientes de IA criem, consultem e gerenciem relatórios de bugs, solicitações de recursos, melhorias e muito mais por meio do Model Context Protocol. Ele roda localmente e se comunica com a API em nuvem do bug_Agent_.

1

Obtenha sua chave de API

Crie uma conta gratuita; novos proprietários de workspace são levados diretamente à configuração da chave de API. Usuários que já voltam podem gerar uma chave em Configurações → Desenvolvedores → Chaves de API.

2

Configure seu cliente de IA

Adicione o bug_Agent_ como um servidor MCP na configuração do seu cliente (veja a configuração abaixo).

3

Comece a registrar bugs

Descreva um bug em linguagem natural e o bug_Agent_ classifica, enriquece e armazena automaticamente.

Exemplo rápido

# Create a bug report
"File a bug: Login button is unresponsive on iOS Safari.
Steps: tap login, nothing happens. Expected: navigate to
dashboard. Severity: high."

# bugAgent auto-classifies as UI bug, severity high

# File a feature request
"Feature request: Add dark mode toggle to the
settings page. Users have asked for this in surveys."

# Auto-classified as feature-request, severity medium

Configuração

Instalação

Nenhuma instalação global é necessária. Use npx para executar o servidor MCP sob demanda:

npx @bugagent/mcp-server

Configure sua chave de API

Ao conectar pela primeira vez, o bug_Agent_ solicitará sua chave de API. Você também pode defini-la por meio de uma variável de ambiente:

export BUGAGENT_API_KEY=ba_live_your_key_here

Obtenha sua chave de API no console do bug_Agent_.

Configuração do Cliente MCP

Adicione o seguinte ao arquivo de configuração do seu cliente MCP:

mcp.json

{
  "mcpServers": {
    "bugagent": {
      "command": "npx",
      "args": ["-y", "@bugagent/mcp-server"],
      "env": {
        "BUGAGENT_API_KEY": "ba_live_your_key_here"
      }
    }
  }
}

💡

Substitua ba_live_your_key_here pela sua chave de API real do console.

Conectar ao Servidor

O servidor MCP do bug_Agent_ está ativo em https://mcp.bugagent.com/mcp via transporte HTTP Streamable. Conecte-se a partir de qualquer um dos oito clientes abaixo — escolha o que melhor se adapta ao seu fluxo de trabalho.

Para uma configuração pequena e pronta para copiar, orientação sobre chaves com escopo e prompts iniciais seguros, use o quickstart público do MCP.

🔑

Obtenha sua chave de API primeiro. Entre em Configurações → Desenvolvedores, clique em Criar Chave de API e copie o valor (começa com ba_live_). Você só o verá uma vez, então cole-o em um local seguro. Todos os exemplos abaixo usam essa chave.

Opção 1 — MCP Inspector (Interface Web, recomendado para primeiros testes)

A ferramenta oficial da Anthropic. Inicia uma interface web local onde você pode clicar em cada ferramenta, preencher parâmetros e ver as respostas. Zero configuração, sem necessidade de IDE.

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell ou CMD)

PowerShell

Na interface do navegador que abrir:

1. Tipo de Transporte: selecione Streamable HTTP
2. URL: https://mcp.bugagent.com/mcp
3. Tipo de Conexão: selecione Proxy (o padrão — o Inspector faz proxy por meio de um processo Node local para contornar o CORS do navegador)
4. Clique na aba Autenticação → adicione um cabeçalho personalizado:
   • Nome do Cabeçalho: Authorization
   • Valor: Bearer ba_live_YOUR_KEY_HERE
5. Clique em Conectar. Você verá todas as 110+ ferramentas do bug_Agent_ no painel esquerdo.
6. Clique em qualquer ferramenta (ex.: list_bug_reports), preencha os parâmetros, clique em Executar Ferramenta. A resposta aparece à direita.

Pré-requisitos: Node.js 18 ou posterior. Instale a partir de nodejs.org se não tiver.

Opção 2 — Claude Desktop (Mac + Windows)

Se você usa o aplicativo Claude Desktop, pode adicionar o bug_Agent_ como um servidor MCP permanente. O Claude terá todas as ferramentas do bug_Agent_ disponíveis em todas as conversas.

macOS

1. Abra o Claude Desktop → barra de menu Claude → Configurações → Desenvolvedor → Editar Config. Isso abre ~/Library/Application Support/Claude/claude_desktop_config.json.
2. Adicione a entrada do bug_Agent_ em mcpServers:
   claude_desktop_config.json

{  
  "mcpServers": {  
    "bugagent": {  
      "type": "http",  
      "url": "https://mcp.bugagent.com/mcp",  
      "headers": {  
        "Authorization": "Bearer ba_live_YOUR_KEY_HERE"  
      }  
    }  
  }  
}  

3. Salve o arquivo e saia completamente do Claude Desktop (Cmd+Q, não apenas feche a janela).
4. Reabra o Claude Desktop. O ícone de martelo de ferramentas na parte inferior do campo de chat deve agora mostrar as ferramentas do bug_Agent_.
5. Experimente: digite "Liste meus 5 relatórios de bugs mais recentes" — o Claude chamará list_bug_reports automaticamente.

Windows

1. Abra o Claude Desktop → Arquivo → Configurações → Desenvolvedor → Editar Config. Isso abre %APPDATA%\Claude\claude_desktop_config.json (normalmente C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json).
2. Adicione o mesmo bloco JSON mostrado na seção macOS.
3. Salve o arquivo e saia completamente do Claude Desktop pela bandeja do sistema (clique com o botão direito no ícone do Claude → Sair) e reabra.
4. O ícone de martelo de ferramentas mostrará as ferramentas do bug_Agent_.

Opção 3 — Claude Code (CLI)

Se você usa o Claude Code pelo terminal (a versão CLI do Claude), registre o servidor do bug_Agent_ com um único comando. Funciona de forma idêntica em macOS, Linux e Windows.

Terminal / PowerShell

claude mcp add --transport http bugagent https://mcp.bugagent.com/mcp \
  --header "Authorization: Bearer ba_live_YOUR_KEY_HERE"

Em seguida, reinicie sua sessão do Claude Code. Verifique se está conectado:

claude mcp list

Você deve ver bugagent na lista com um ponto verde. Comece a usar as ferramentas em qualquer chat: "Mostre meu uso de exploração deste mês."

Para remover depois:

claude mcp remove bugagent

Opção 4 — OpenAI Codex CLI

Se você usa o OpenAI Codex CLI, adicione o bug_Agent_ a ~/.codex/config.toml para registro permanente, ou passe a configuração inline para uma sessão única.

Registro permanente (adicionar à configuração)

~/.codex/config.toml

[[mcp_servers]]
name = "bugagent"
type = "http"
url  = "https://mcp.bugagent.com/mcp"

[mcp_servers.headers]
Authorization = "Bearer ba_live_YOUR_KEY_HERE"

Inline — uma sessão

Terminal

codex \
  --mcp-server '{"name":"bugagent","type":"http","url":"https://mcp.bugagent.com/mcp","headers":{"Authorization":"Bearer ba_live_YOUR_KEY_HERE"}}' \
  "list the last 5 bug reports"

O Codex resolve chamadas de ferramentas automaticamente a partir do seu prompt em linguagem natural. Experimente: "Liste meus bugs abertos ordenados por severidade."

Opção 5 — Cursor (Mac + Windows)

O Cursor tem suporte MCP integrado. Adicione o bug_Agent_ uma vez e o assistente de IA dentro do Cursor poderá registrar bugs, listar relatórios, executar varreduras, etc., sem sair do editor.

1. Abra o Cursor → Configurações (Cmd+, no Mac / Ctrl+, no Windows) → MCP na barra lateral esquerda.
2. Clique em + Adicionar novo servidor MCP.
3. Selecione o tipo de transporte HTTP.
4. Preencha:
   • Nome: bugagent
   • URL: https://mcp.bugagent.com/mcp
   • Nome do cabeçalho: Authorization
   • Valor do cabeçalho: Bearer ba_live_YOUR_KEY_HERE
5. Clique em Salvar. O Cursor mostra um indicador verde quando conectado.
6. Abra o chat do Cursor (Cmd+L / Ctrl+L) e digite "Crie um relatório de bug intitulado 'Login quebrado' com severidade alta." O Cursor invocará create_bug_report.

Alternativa: O Cursor também lê ~/.cursor/mcp.json (Mac) ou %USERPROFILE%\.cursor\mcp.json (Windows). Adicione o mesmo formato JSON mostrado na seção Claude Desktop.

Opção 6 — VS Code com extensão Continue (Mac + Windows)

Se você prefere o VS Code, a extensão Continue suporta servidores MCP nativamente.

1. Instale a extensão Continue do marketplace do VS Code.
2. Abra a configuração do Continue: Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P) → Continue: Abrir config.json. O arquivo está em:
   • macOS: ~/.continue/config.json
   • Windows: %USERPROFILE%\.continue\config.json
3. Adicione uma entrada mcpServers:
   ~/.continue/config.json

{  
  "mcpServers": [  
    {  
      "name": "bugagent",  
      "type": "streamable-http",  
      "url": "https://mcp.bugagent.com/mcp",  
      "requestOptions": {  
        "headers": {  
          "Authorization": "Bearer ba_live_YOUR_KEY_HERE"  
        }  
      }  
    }  
  ]  
}  

4. Salve. O Continue recarregará automaticamente e mostrará as ferramentas do bug_Agent_ na barra lateral.
5. Abra o painel de chat do Continue e experimente: "Liste minhas varreduras de segurança."

Outras extensões do VS Code com suporte a MCP: Cline, Roo Code e Windsurf (fork) seguem padrões de configuração JSON semelhantes com uma chave mcpServers e transporte HTTP.

Opção 7 — Hosts com suporte a OAuth (Claude.ai web mostrado como exemplo)

Alguns hosts MCP autenticam via OAuth 2.0 e pedem um client_id e client_secret estáticos antecipadamente, em vez de aceitar uma chave de API bearer. Para esses hosts, você gera um par de credenciais OAuth com escopo de workspace no painel do bug_Agent_ e o cola no formulário do conector do host. As credenciais são agnósticas ao host MCP — qualquer cliente OAuth que suporte Authorization Code + PKCE pode usá-las. O passo a passo abaixo usa o aplicativo web Claude.ai como exemplo mais comum.

1. No bug_Agent_: abra Configurações → Desenvolvedores → Conectores MCP. Clique em Gerar conector, dê um nome que descreva o host (ex.: "Claude.ai (trabalho)"), cole o URI de redirecionamento que seu host MCP exige (para o aplicativo web Claude.ai é https://claude.ai/api/mcp/auth_callback — consulte a documentação do conector do seu host para outros), e escolha Confidencial para o método de autenticação. Copie o client_id e o client_secret mostrados uma vez na tela de sucesso.
2. Nas configurações de conector / OAuth do seu host MCP, cole:
   • URL do servidor: https://mcp.bugagent.com/mcp
   • Client ID + Client Secret: do passo 1
   • URL de autorização: https://mcp.bugagent.com/authorize
   • URL de token: https://mcp.bugagent.com/token
     Para Claude.ai especificamente: vá para claude.ai/customize/connectors e clique em Adicionar conector MCP.
3. Salve. O host redireciona você para o bug_Agent_ para fazer login (Google ou e-mail/senha — o método que você usa no painel) e aprovar o consentimento, então conclui o handshake OAuth.
4. Gerencie e revogue conectores gerados na mesma página de Configurações. A revogação é imediata — a próxima solicitação desse conector retorna invalid_client.

Nota: Claude Code, Cursor, VS Code e o MCP Inspector não precisam desse fluxo — eles lidam com registro dinâmico de clientes (RFC 7591) automaticamente e autenticam via chave de API, como mostrado acima. O formulário de Conectores MCP é apenas para hosts que exigem credenciais OAuth estáticas.

Opção 8 — HTTP direto com curl (Terminal)

Se você quiser testar o servidor diretamente sem nenhum cliente, ou integrá-lo a um script, pode acessar o endpoint HTTP com curl. O protocolo MCP é JSON-RPC 2.0 sobre HTTP Streamable.

macOS / Linux

Terminal

# Set your API key as a variable
export BUGAGENT_API_KEY="ba_live_YOUR_KEY_HERE"

# 1. List all available tools
curl -N -s https://mcp.bugagent.com/mcp \
  -H "Authorization: Bearer $BUGAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 2. Call a tool — list 5 reports from a specific project
curl -N -s https://mcp.bugagent.com/mcp \
  -H "Authorization: Bearer $BUGAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"list_bug_reports",
      "arguments":{"project":"bugagent","limit":5}
    }
  }'

Windows (PowerShell)

PowerShell

# Set your API key
$env:BUGAGENT_API_KEY = "ba_live_YOUR_KEY_HERE"

# Use Invoke-RestMethod (PowerShell's curl equivalent)
$headers = @{
  "Authorization" = "Bearer $env:BUGAGENT_API_KEY"
  "Content-Type" = "application/json"
  "Accept" = "application/json, text/event-stream"
}

# 1. List all tools
$body = '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Invoke-RestMethod -Uri "https://mcp.bugagent.com/mcp" `
  -Method Post -Headers $headers -Body $body

# 2. Call list_bug_reports for a specific project
$body = @{
  jsonrpc = "2.0"
  id = 2
  method = "tools/call"
  params = @{
    name = "list_bug_reports"
    arguments = @{ project = "bugagent"; limit = 5 }
  }
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Uri "https://mcp.bugagent.com/mcp" `
  -Method Post -Headers $headers -Body $body

As respostas chegam como Server-Sent Events (o padrão MCP Streamable HTTP). Cada bloco é uma linha prefixada com data: seguida por um objeto JSON. O cabeçalho Accept: application/json, text/event-stream é obrigatório — o servidor rejeita solicitações sem ele.

ℹ️

Solução de problemas 401 Não Autorizado: Verifique se sua chave de API não foi revogada em Configurações → Desenvolvedores. As chaves começam com ba_live_. Se ainda estiver com problemas, regenere a chave e tente novamente.

Experimente — Prompts em Linguagem Simples

Depois de conectado, você não precisa saber nomes de ferramentas ou parâmetros. Descreva o que deseja em linguagem simples e seu assistente de IA chama a ferramenta correta do bug_Agent_ automaticamente.

Relatórios de Bugs

Pergunte ao seu assistente de IA

List my 5 most recent bug reports
Show all open critical bugs in the Auth project
Create a bug titled "Login broken on Safari" with severity s2
Update TEST-451 status to in-progress and assign it to me
Add a comment to TEST-451: "root cause confirmed — null check missing in auth middleware"
Show me everything filed this week, grouped by severity

Gerenciamento de Testes

Create a test suite called "Smoke Tests" with cases for login, checkout, and account settings
Run the Regression suite and list all failures
Use Hermes to execute the curated "Checkout smoke" suite and report every result to bugAgent
Show failing test cases from the last 7 days
Which test cases have never been run in the past 90 days?
Get a pass-rate trend for this month vs last month

Segurança e Desempenho

Run a security scan on https://app.example.com
Get this month's security scan results — show only high and critical findings
Create a performance test for the landing page and check Lighthouse scores
What are the Core Web Vitals for our checkout flow?

Automação com Playwright

Create a Playwright script that logs in and verifies the dashboard loads
Run the checkout automation on iPhone 15 Pro on a real device
Optimize the login automation script
Show runs for the checkout automation — any failures?
Schedule the smoke test suite to run every weekday at 6 AM UTC

IA Exploratória

Run an exploratory AI session on https://app.example.com with 5 parallel agents
Get the latest exploration run results — list any bugs that were filed
What testing strategies did the agents use and which found the most issues?

Uso e Estatísticas

Check my plan usage for this month
Show team bug stats for this week broken down by severity and type
List all team members and their roles
How many security scans do I have left this month?

Referência Rápida

Locais dos arquivos de configuração para todos os oito clientes. Cada cliente se conecta a https://mcp.bugagent.com/mcp com o cabeçalho Authorization: Bearer ba_live_YOUR_KEY_HERE via HTTP Streamable.

Cliente Local do arquivo de configuração / comando

MCP Inspector Sem arquivo — insira URL + cabeçalho de autenticação na interface do navegador após npx @modelcontextprotocol/inspector

Claude Desktop — macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop — Windows %APPDATA%\Claude\claude_desktop_config.json

Claude Code (CLI) claude mcp add --transport http bugagent https://mcp.bugagent.com/mcp --header "Authorization: Bearer ba_live_..."

Codex CLI ~/.codex/config.toml

Cursor — macOS Configurações → UI MCP, ou ~/.cursor/mcp.json

Cursor — Windows %USERPROFILE%\.cursor\mcp.json

VS Code + Continue ~/.continue/config.json (macOS) / %USERPROFILE%\.continue\config.json (Windows)

HTTP direto (curl) curl / Invoke-RestMethod — inclua Accept: application/json, text/event-stream

Solução de Problemas

Sintoma Correção

401 Unauthorized A chave está errada, expirada ou revogada. Verifique Configurações → Desenvolvedores — as chaves começam com ba_live_. Regenere se necessário.

Ferramentas não aparecem no cliente Saia completamente e reabra o cliente após editar a configuração. No Claude Desktop, Cmd+Q (não apenas feche a janela). No Cursor, verifique Configurações → MCP para um ponto verde.

Accept header required Chamadas HTTP diretas devem incluir Accept: application/json, text/event-stream — a especificação Streamable HTTP exige isso. O servidor retorna 406 sem ele.

Dados do workspace errado Cada chave de API é limitada a um workspace. Gere uma nova chave a partir do workspace que deseja consultar em Configurações → Desenvolvedores.

Ferramentas aparecem, mas chamadas falham silenciosamente Confirme se o servidor está acessível: curl -I https://mcp.bugagent.com/health deve retornar 200. Se expirar, verifique regras de rede/firewall.

Erro de CORS no MCP Inspector Selecione Proxy (não Direto) para o Tipo de Conexão na interface do Inspector. O Inspector faz proxy por meio de um processo Node local para contornar as restrições de CORS do navegador.

Codex CLI — ferramentas não reconhecidas Verifique se ~/.codex/config.toml usa [[mcp_servers]] (colchetes duplos, sintaxe de array). Verifique se a versão do Codex CLI é recente o suficiente para suportar MCP (codex --version).

Recursos do MCP

O servidor MCP bug_Agent_ fornece ferramentas para:

🐛

Gerenciamento de Relatórios de Bug

• create_bug_report — Registre um novo relatório com classificação automática em 19 tipos — bugs, solicitações de recursos, melhorias, dívida técnica e mais (título: 3-500 caracteres). O array opcional attachments aceita arquivos codificados em base64 de até 400 MB cada: qualquer imagem, vídeo, áudio, PDF ou texto/JSON. Defina format_description: true para reformatar automaticamente a descrição em um modelo estruturado usando IA. Passe time_spent_seconds para rastrear o esforço de QA. Passe priority (urgent / high / normal / low) para definir a urgência da correção independentemente da gravidade. Passe is_epic: true para criar um Epic, ou parent_epic_id (UUID/ID curto) para criar um filho no mesmo projeto autorizado. A resposta inclui campos de hierarquia além de project_id, project, short_id, legacy_short_id e project_short_id.
• list_bug_reports — Liste e filtre relatórios (máx. 100 por página). Os filtros de projeto são aplicados no servidor antes da paginação. Filtre por project (UUID, slug, nome exato ou prefixo de ticket), project_id, project_slug, project_prefix, workspace (UUID, nome exato ou prefixo de ticket do workspace), workspace_id/team_id, is_epic, type, severity, status, resolution, root_cause ou reporter_user_id. Cada resultado inclui identificadores de pessoas/projetos com escopo do tenant além de is_epic, parent_epic_id, parent_epic e epic_progress limitado. As ferramentas de leitura de relatórios não expõem endereços de e-mail de membros.
• pick_next_bug — Retorna o(s) próximo(s) bug(s) em que o loop do agente deve trabalhar, em ordem de prioridade (S1 → S2 → S3, mais antigos primeiro dentro de cada grupo). Escopado automaticamente ao seu workspace — retorna tickets de todos os projetos da sua equipe com status new, awaiting-triage ou confirmed e gravidade S1-S3. Somente leitura — não faz claim atômico de tickets. severity opcional (camada única), limit (1-50, padrão 1). Retorna linhas no mesmo formato de list_bug_reports para composabilidade de ferramentas. Combine com claim_bug para o padrão de ler-depois-reivindicar.
• claim_bug — Faça a transição atômica de um bug de status new, awaiting-triage ou confirmed para status='in-progress', defina assigned_to como o usuário que chamou e carimbe claimed_at=NOW(). Livre de condições de corrida entre chamadas concorrentes via padrão UPDATE-WHERE-RETURNING do Postgres — se dois agentes chamarem claim_bug no mesmo id em rápida sucessão, exatamente um recebe claimed:true com o corpo do bug e o outro recebe claimed:false com uma string de motivo. Respostas bem-sucedidas incluem reporter_user_id, reporter_name, assigned_to e assignee_name. Um reaper pg_cron libera claims obsoletos (status=in-progress + claimed_at > 30 minutos) de volta para new automaticamente, então os tickets de um agente que travou voltam à fila sem intervenção manual. Entradas: id (UUID ou ID curto).
• get_bug_report — Obtenha todos os detalhes de um relatório por UUID ou ID curto do workspace/projeto. Retorna os campos padrão de pessoas/projeto/qualidade além de is_epic, identidade do pai, progresso agregado e uma primeira página limitada de filhos para Epics.
• list_epic_children — Pagine os relatórios filhos de um Epic com id, limit (1–100) e offset. Retorna children, total, has_more e epic_progress agregado por SQL sem carregar todos os relatórios filhos.
• update_bug_report — Atualize campos padrão de relatório além de is_epic e parent_epic_id. Passe parent_epic_id: null para desanexar; reparentalizar/desanexar é atômico e requer autorização de mesmo workspace e mesmo projeto. Promover para Epic desanexa um pai existente, enquanto um Epic com filhos não pode ser rebaixado. As regras existentes de notificação de status/resolução/causa raiz e atribuição continuam valendo.
• add_comment — Adicione um comentário a um relatório de bug (UUID ou ID curto, corpo de 1-10000 caracteres). Se o relatório estiver sincronizado com o Jira, o comentário é enviado automaticamente para a issue vinculada no Jira.
• list_comments — Liste o histórico completo de comentários de um relatório, dos mais antigos aos mais recentes — cada comentário com nome do autor, parentId (respostas em thread) e timestamps. Os comentários não fazem parte de get_bug_report, então é assim que você lê a discussão de um ticket. Aceita UUID ou ID curto.
• link_bug_reports — Crie um link semântico direcional entre dois relatórios no mesmo projeto autorizado. Para parent-of, o relatório de origem deve ser um Epic e o relatório de destino um filho padrão. Prefira parent_epic_id ao criar/atualizar para atribuição de Epic.
• unlink_bug_reports — Remova um link de relatório de bug criado anteriormente pelo seu UUID (link_id, retornado por link_bug_reports ou list_bug_report_links).
• list_bug_report_links — Liste todos os links curados pelo usuário que tocam um relatório de bug. Retorna cada link como visto da perspectiva do relatório fornecido — por exemplo, uma linha duplicate-of armazenada em que este relatório é o destino é renderizada como duplicated-by; parent-of em que este relatório é o destino é renderizada como subtask-of; depends-on em que este relatório é o destino é renderizada como blocks; testing-blocked-by em que este relatório é o destino é renderizada como blocks-testing. related-to é simétrico. Complementa o campo similar_reports detectado automaticamente retornado por get_bug_report.
• classify_bug — Classifique uma descrição em um dos 19 tipos de relatório (bugs, funcionalidades, melhorias, etc.) com pontuação de confiança
• flush_reports — Exclusão em massa de relatórios antigos (somente admin)

📊

Uso e Análises

• get_usage — Verifique o uso em relação aos limites do plano. Chamadas com chave de API exigem usage:read.
• get_stats — Contagens diárias, detalhamentos por tipo/gravidade/status

📁

Gerenciamento de Projetos

• list_projects — Liste os projetos disponíveis com id, name, slug, ticket_prefix, descrição e status padrão. Use esses valores com create_bug_report e list_bug_reports para direcionar o projeto correto.
• create_project — Crie um novo projeto (torna-se o padrão automaticamente se for o primeiro)
• delete_project — Exclua permanentemente um projeto e todos os dados associados (relatórios de bug, automações, casos de teste, aplicativos móveis, agendamentos, geo snaps, notas, registros de tempo). Somente owner/manager. Não é possível excluir o último projeto. O armazenamento é liberado automaticamente
• export_okf_bundle — Exporte o conhecimento de QA de um projeto — relatórios de bug, casos de teste, automações e testes de desempenho, segurança e exploratórios — como um pacote Markdown OKF/OQA (o formato Open Query Agent usado pelo oqa.ai). Padrão: projeto ativo; passe o project opcional (slug ou nome) para exportar outro. Retorna a lista de arquivos no pacote além do próprio pacote como um zip codificado em base64

🔐

Autenticação e Conta

• register_account — Crie uma nova conta (senha: 8-128 caracteres, limite de taxa: 5/15min)
• login — Entre e receba tokens de acesso (limite de taxa: 5/15min)
• update_profile — Atualize o nome de exibição
• change_password — Altere a senha da conta
• get_settings / update_settings — Gerencie preferências

🔑

Gerenciamento de Chaves de API

• generate_api_key — Crie uma chave de API nomeada
• list_api_keys — Liste chaves ativas (somente prefixo)
• regenerate_api_key — Revogue e substitua uma chave
• delete_api_key — Revogue permanentemente uma chave

👥

Gerenciamento de Equipe

• list_team_members — Liste todos os membros do seu workspace com papéis, status e flags de booster
• invite_team_member — Convide um usuário por e-mail (gerentes podem convidar contribuidores e gerentes; somente owners podem convidar admins). Link com validade de 5 dias

🎯

Integrações

• sync_to_jira — Sincronize um relatório com o Jira usando a conexão compartilhada da equipe
• push_to_claude — Gere (ou regenere) as Notas do Desenvolvedor para um relatório de bug — causa raiz, correção sugerida, etapas de verificação e avaliação de risco. Aceita UUID ou ID curto (WRKID-545). Usa chaves da plataforma — nenhuma conexão Claude por equipe necessária. Executa uma cadeia adaptativa: três etapas em bugs s3/medium ou s4/low (rascunho Sonnet → crítica OpenAI gpt-5 → síntese Sonnet), cinco etapas nos dois grupos de gravidade mais altos — s1/critical ou s2/high — (rascunho → crítica → réplica Sonnet → árbitro Claude Opus que lê a transcrição completa e escreve as notas finais com julgamento independente). A resposta expõe cada rodada: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model e um sinalizador debated. Qualquer etapa com falha recorre à próxima melhor resposta. Dispara automaticamente na criação do bug; geralmente é chamado apenas para regeneração manual.
• analyze_fix_area — Gere (ou regenere) o sub-bloco "Área Provável da Correção" das Notas do Desenvolvedor — uma saída Sonnet enxuta que indica onde no código-fonte a correção provavelmente pertence. Aceita UUID ou ID curto. Usa a chave Anthropic da plataforma. Quando a equipe tem uma linha github_connections e o projeto tem um github_repo mapeado, a saída é fundamentada em trechos reais de arquivos do repositório conectado; caso contrário, recorre a orientações gerais com um incentivo para conectar um repositório. Retorna texto likely_fix_area, generated_at, repo_used e um sinalizador grounded. Dispara automaticamente na criação do bug — agentes normalmente só precisam chamar isso para regeneração manual.
• upgrade_plan — Obtenha o link de inscrição Enterprise assistido por vendas

⚡

Testes de Desempenho

• create_performance_test — Crie uma configuração de teste de desempenho com URL, dispositivo, usuários virtuais, duração, limite de pontuação e alternância de criação automática de bug. Somente Enterprise
• run_performance_test — Dispare uma auditoria de página e teste de carga para um teste de desempenho web. Retorna um ID de execução para consultar os resultados. Execuções de perfil de aplicativos móveis são acionadas pelo dashboard
• get_performance_results — Obtenha resultados completos, incluindo pontuações Lighthouse (Performance, Acessibilidade, Boas Práticas, SEO), Core Web Vitals (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI) e métricas de teste de carga (VUs, requests, RPS, latências p50/p90/p95/p99)
• list_performance_tests — Liste todas as configurações de teste de desempenho da equipe atual
• get_performance_usage — Verifique o uso mensal de testes de desempenho. Testes de desempenho são exclusivos Enterprise. Free=0, Enterprise=ilimitado

Exemplo de Fluxo de Trabalho

1. get_performance_usage → verifique a cota restante
2. create_performance_test → configure um teste para sua URL
3. run_performance_test → dispare a auditoria + teste de carga
4. get_performance_results → revise pontuações e vitals

🛡

Varredura de Segurança

• create_security_scan — Cria uma configuração de varredura de segurança. Varreduras web usam Quick Scanner + Nuclei (mais de 4.000 modelos) com três níveis de profundidade e varredura autenticada opcional. Varreduras móveis usam MobSF para análise binária de APK/IPA. Criação automática de bugs configurável com limites de severidade. Somente Enterprise
• run_security_scan — Dispara uma varredura de vulnerabilidades. Varreduras web exigem verificação de domínio DNS. Varreduras móveis exigem um app enviado. Retorna um ID de execução para consultar os resultados
• get_security_results — Obtém resultados completos, incluindo pontuação de segurança (0–100), descobertas categorizadas por severidade (Critical, High, Medium, Low, Info) com referências CWE, mapeamentos OWASP, evidências e orientações de correção
• list_security_scans — Lista todas as configurações de varredura de segurança da equipe atual com a última pontuação e selos de autenticação/profundidade
• get_security_usage — Verifica o uso mensal de varredura de segurança. Varredura de segurança é exclusiva para Enterprise. Enterprise = ilimitado
• list_security_schedules — Lista todas as varreduras de segurança agendadas da equipe com cron, fuso horário, estado de habilitação, próxima execução e configurações de notificação. Faz join com a configuração de varredura pai (name, scan_type, target_url)
• create_security_schedule — Cria um agendamento recorrente para uma varredura de segurança. Requer scan_id e cron_expression. Um agendamento por configuração de varredura. Opcionais: timezone, notify_on_fail (none/email/slack/both), notify_email, slack_channel_id. Cada execução conta contra seu limite mensal; usuários administradores ignoram o limite. A profundidade da varredura é sempre lida da configuração de varredura no momento da execução
• delete_security_schedule — Exclui uma varredura de segurança agendada. Não afeta a configuração de varredura pai nem as execuções concluídas

1. get_security_usage → verificar a cota restante
2. create_security_scan → configurar uma varredura para sua URL ou repositório
3. run_security_scan → disparar uma varredura de vulnerabilidades única
4. create_security_schedule → automatizar execuções recorrentes (ex.: SAST semanal no branch principal)
5. get_security_results → revisar descobertas e correções

📖

Code Review

• list_code_reviews — Lista revisões de código de IA recentes da equipe. Retorna pontuações de qualidade, contagens de severidade, informações de PR e carimbos de data/hora. Somente Enterprise
• get_code_review — Obtém uma revisão de código com todas as descobertas. Cada descoberta inclui severidade, categoria (bug/security/performance/style/logic/maintainability), título, descrição, sugestão de código, caminho do arquivo e números de linha
• get_code_review_usage — Verifica o uso de revisão de código. Revisão de código com IA é exclusiva para Enterprise; ilimitada no Enterprise
• get_code_review_analytics — Obtém análises de revisão: tendências, categorias/origens das descobertas, distribuição de severidade, métricas de velocidade, principais repositórios/autores. Suporta períodos de 7/30/90 dias

1. get_code_review_usage → verificar revisões restantes
2. Revisar um PR no painel em /dashboard/code-review
3. list_code_reviews → ver revisões recentes
4. get_code_review → obter descobertas e sugestões

🔍

Exploratory AI

Localizador autônomo de bugs em sites com múltiplos agentes, com até 10 agentes paralelos, cada um usando uma estratégia de teste diferente.

• list_explorations — Lista as configurações de Exploratory AI da equipe
• create_exploration — Cria uma nova exploração. Aceita agent_count (1–10, máx. 10) para executar vários agentes paralelos com estratégias exclusivas: happy_path, edge_case, security, accessibility, error_path, performance, mobile, data_integrity, navigation, custom
• get_exploration — Obtém a configuração de exploração com configurações de agente, metadados seguros de autenticação e execuções recentes. Senhas e textos cifrados nunca são retornados
• get_exploration_run — Obtém resultados de execução com progresso por agente, dados de fase, descobertas com atribuição de agente (agent_index, agent_strategy) e bugs vinculados
• get_exploration_usage — Verifica o uso mensal. Exploratory AI é exclusivo para Enterprise; Enterprise: ilimitado (10 agentes)

1. create_exploration com agent_count: 5 → configurar 5 agentes paralelos
2. Disparar uma execução pelo painel ou via POST /api/explorations/run
3. get_exploration_run → consultar o progresso e as descobertas por agente
4. Visualizar descobertas deduplicadas com atribuição de agente no painel

📝

Notes

• list_notes — Lista notas com busca opcional por palavra-chave, filtro de projeto, filtro de autor e intervalo de datas. Retorna notas que o usuário possui ou notas compartilhadas dentro da equipe
• create_note — Cria uma nota em um dos 5 formatos: markdown, plain_text, rich_text, checklist, outline. Defina visibility como private ou shared. Título automático a partir dos primeiros 30 caracteres se nenhum título for fornecido. O array opcional attachments aceita arquivos codificados em base64 de até 400 MB cada: qualquer imagem, vídeo, áudio, PDF ou text/JSON. Passe time_spent_seconds para acompanhar o esforço de QA
• get_note — Obtém detalhes completos da nota, incluindo conteúdo e anexos. Requer id
• update_note — Atualiza título, conteúdo, formato, visibilidade, projeto ou time_spent_seconds. Passe um array attachments para anexar novos arquivos (máx. 400 MB cada) aos anexos existentes da nota sem substituí-los. Somente o autor pode atualizar. Requer id
• delete_note — Exclui permanentemente uma nota e seus anexos. Somente o autor pode excluir. Requer id

1. create_note → iniciar uma nota de sessão de teste
2. update_note → adicionar observações enquanto testa
3. list_notes → buscar notas anteriores por palavra-chave ou projeto
4. get_note → recuperar a nota completa com anexos

🤖

Automation

• create_automation — Cria uma nova automação com um script Playwright personalizado (nenhum registro FAB necessário). Requer name. Opcionais: target_url (derivado automaticamente da primeira URL page.goto(...) no script se omitido), script (Node.js/JavaScript/TypeScript ou Python — a linguagem é detectada automaticamente; o padrão é um placeholder), status (draft ou active, padrão: draft), project_id. Retorna o id da automação. Plano Enterprise obrigatório. Dica — Duplicar uma automação: use get_automation para buscar o script original e, em seguida, chame create_automation com name definido como "[Copy] Original Name" e passe o script, o target_url e o project_id originais. A duplicata começa com status draft e sem histórico de versões
• list_automations — Lista scripts de automação Playwright. Filtra por project_id ou status (draft, active, paused). Retorna um array de automações com nome, target_url, last_run_status e run_count
• get_automation — Obtém detalhes completos da automação, incluindo script Playwright e execuções recentes. Requer id. Retorna a automação com o script ativo, uma pilha script_versions (do mais antigo ao mais recente, até 100 entradas anteriores, cada uma { script, source, timestamp }) e um array recent_runs em que cada execução carrega o script_version_label/script_version_source que foi executado. Chame isso antes de run_automation se precisar selecionar uma versão histórica específica
• run_automation — Dispara uma execução imediata de um teste Playwright. Requer automation_id. Localizadores autorreparáveis (automáticos): quando uma ação de localizador expira, o executor pede ao Claude um seletor funcional e repete a etapa uma vez — asserções nunca são reparadas, então regressões reais continuam falhando — e cada reparo é registrado no stdout da execução. Modo virtual (padrão): device opcional para emulação de viewport (ex.: desktop, iphone-15). Modo ao vivo: defina browserstack: true com bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X) e bs_os_version para executar em um navegador de desktop real. Ao vivo em celular real: defina bs_os: "android" (dispositivos: "Samsung Galaxy S25 Ultra", "Google Pixel 10", "OnePlus 13R") ou bs_os: "ios" (dispositivos: "iPhone 17 Pro Max", "iPhone 16 Pro Max", "iPhone 15 Pro Max") e passe o nome do dispositivo em bs_os_version. Scripts Node.js passam por browserstack-node-sdk (cobre desktop + Android + iPhone). Scripts Python passam por browserstack-sdk (pytest-playwright) e cobrem apenas desktop — celular real via Python não é suportado porque o browser_type.connect() do pytest-playwright não consegue acionar os endpoints de celular real do BrowserStack. Vídeo e logs de rede são capturados automaticamente; logs de console apenas em desktop. Replay de versão: passe o version_index opcional (inteiro, com índice baseado em 0) para executar uma entrada anterior do histórico script_versions da automação. Padrão: quando version_index é omitido ou null, o script ativo atual é executado — não passe um valor placeholder apenas para "escolher o atual". Valores fora do intervalo, negativos ou não inteiros são rejeitados. O registro da execução armazena o snapshot exato que foi executado, e qualquer relatório de bug criado automaticamente a partir de uma execução com falha tem link direto para essa versão no editor
• list_automation_runs — Lista execuções recentes de uma automação. Requer automation_id. Retorna execuções com status, duration_ms e error_message
• list_schedules — Lista todas as execuções de automação web agendadas com cron, fuso horário, dispositivo e configurações de notificação
• create_schedule — Cria uma execução de automação web agendada. Requer automation_id e cron_expression. Suporta dispositivo, fuso horário, notify_on_fail (email/slack/both) e opções de canal do Slack. BrowserStack Live em execuções agendadas: passe browserstack: true com bs_browser, bs_os e bs_os_version — mesma matriz de dispositivos do run_automation (Node = desktop + Android real + iPhone real; Python = apenas desktop)
• delete_schedule — Exclui uma execução de automação web agendada
• list_mobile_schedules — Lista todas as execuções de automação móvel agendadas com dispositivos, cron, fuso horário e notificações
• create_mobile_schedule — Cria uma execução de automação móvel agendada em dispositivos reais. Requer automation_id, cron_expression e array devices
• delete_mobile_schedule — Exclui uma execução de automação móvel agendada
• optimize_automation_script — Envia um script Playwright ao Sonnet 4 para otimização com tecnologia de IA. Aplica uma lista de verificação de 12 pontos que corrige seletores, estratégias de espera, asserções, tratamento de erros, padrões de autenticação, compatibilidade com dispositivos móveis e modo estrito. Requer automation_id. A versão atual do script é salva antes da otimização. Retorna o script otimizado e um resumo das alterações
• undo_automation_script — Reverte um script de automação para a versão anterior. Até 10 versões anteriores são mantidas. Requer automation_id. Retorna o script restaurado e o número de versões restantes

1. create_automation → criar um teste com script personalizado
2. list_automations → navegar pelos testes disponíveis
3. get_automation → inspecionar o script Playwright
4. run_automation → disparar o teste
5. list_automation_runs → verificar resultados e duração

⏱️

Time Tracking

• list_time_entries — Lista entradas de tempo da equipe. Filtra por period (today, week, month, all), project_id, category e sort (newest, oldest, most_time, least_time). Somente plano Enterprise
• create_time_entry — Registra tempo gasto em tarefas de QA. Requer description, category e duration_minutes. Opcionalmente defina project_id e entry_date (o padrão é hoje). Somente plano Enterprise
• update_time_entry — Atualiza uma entrada de tempo existente. Requer id. Pode atualizar description, category, duration_minutes, project_id ou entry_date. Somente plano Enterprise
• delete_time_entry — Exclui permanentemente uma entrada de tempo. Requer id. Somente plano Enterprise

1. create_time_entry → registrar 45 minutos de teste de regressão
2. list_time_entries → ver as entradas de tempo desta semana
3. update_time_entry → ajustar duração ou categoria
4. delete_time_entry → remover uma entrada incorreta

☑️

Test Cases

Gerenciamento de testes com pastas hierárquicas, suítes aninhadas (até 3 níveis de profundidade com expansão automática de sub-suítes nas execuções), reordenação por arrastar e soltar e uma aba de Relatórios analíticos com tendências de KPI, análise de falhas, saúde da suíte, cobertura e produtividade dos testadores. Todas as ferramentas chamam o Supabase diretamente — sem ida e volta HTTP, mesma latência do painel.

Limites gratuitos: 10 casos de teste armazenados, 1 suíte, 3 pastas, 128 KB de conteúdo estruturado por caso, 2 chaves de API ativas do workspace e 10 execuções de teste totais por mês calendário UTC. Até 3 dessas execuções podem usar o Hermes ou outro agente externo, com 1 execução externa ativa e no máximo 10 casos em cada plano externo. O tráfego MCP gratuito por chave de API é limitado a 30 requisições por chave e 60 por workspace por minuto. O armazenamento de casos de teste e as execuções Enterprise são ilimitados, sujeitos às proteções gerais da plataforma.

Geração de casos de teste por IA, sugestões de tags por IA, importação do Figma e anexos de arquivos em casos de teste exigem Enterprise. O limite gratuito de 128 KB de conteúdo estruturado é separado dos anexos de arquivos Enterprise. O plano Free pode armazenar referências de URL. As ferramentas MCP principais de casos de teste permanecem disponíveis no Free dentro dos limites acima.

Execução mãos-livres: a página de revisão de execução é um carrossel com um caso visível por vez, atalhos de teclado (P Passar · F Falhar · B Bloquear · S Pular) e controle por voz. Clique no microfone e diga "Pass", "Fail", "Block", "Skip", "Next", "Previous", "Add notes" (transcreve para o campo de notas), "Save notes" ou "Voice off". Avança automaticamente para o próximo caso não testado em resultados de sucesso; permanece no caso em Falha para que os testadores possam ditar detalhes e abrir um bug. Funciona no Chrome, Edge e Safari.

Casos e Pastas

• list_test_cases — Lista casos de teste com search, priority opcionais (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated) e sort (newest, oldest, name, priority). Chamadas com chave de API exigem test_cases:read.
• create_test_case — Cria um caso de teste. Duas variantes de modelo: steps (padrão) — grade de { action, expected } por etapa via array steps; text — descrição única de formato livre via text_content. Ambos os campos podem ser enviados na mesma chamada (a plataforma os armazena de forma independente, para que um testador que altere o template_type depois não perca os dados de nenhum dos lados). O array urls opcional (máx. 10 URLs http/https) anexa links de referência e está disponível no Free. Exige name. Opcionais: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (segundos). Anexos de arquivos exigem Enterprise e são enviados pelo endpoint POST /api/test-cases/:id/attachments do painel (multipart) — ainda não expostos como ferramenta MCP. Chamadas com chave de API exigem test_cases:write.
• get_test_case — Obtém os detalhes completos do caso de teste, incluindo etapas e histórico de execução.
• list_test_case_folders — Lista as pastas da equipe (uma pasta por caso via folder_id; distintas das suítes, que são agrupamentos de plano de teste muitos-para-muitos). Limitado a 500; respeita os filtros project_id e parent_folder_id (use "root" para apenas o nível superior).
• create_test_case_folder — Cria uma pasta (aninha até 3 níveis via parent_folder_id). Use bulk_update_test_cases para mover casos para dentro dela. Chamadas com chave de API exigem test_cases:write.
• bulk_update_test_cases — Aplica uma ação a até 500 casos de uma vez: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin.
• link_test_case_to_bug — Estabelece rastreabilidade entre um caso de teste e um relatório de bug (verified_by, covers ou relates).
• list_test_case_links — Lista todos os links de rastreabilidade de um caso de teste.
• list_test_case_review_candidates — Sinalizadores de teste morto: never_run (90+ dias desde a criação), always_passes (5+ aprovações consecutivas em 90 dias), always_skipped (3+ pulos consecutivos).
• mark_test_case_review_flags — Persiste os sinalizadores atuais de candidato a arquivamento em test_cases.review_flag. Executa automaticamente toda segunda-feira às 09:00 UTC via pg_cron.

Importações

• Importação do Figma (Enterprise) (UI do painel + REST): envie um arquivo zip da exportação de frames do Figma (até 100 MB); o Claude analisa cada tela e elabora casos de teste em uma pasta que você escolhe ou cria. Pipeline de múltiplas passadas (classificar → casos por tela → casos de nível de fluxo entre telas com prefixo compartilhado → autocrítica) com cache de prompt, nova tentativa em 429 e isolamento de erro por frame, para que um frame ruim não reprove o lote. Os casos chegam como status=active, marcados com ai_generated=true, com source='figma' e source_frame_name preservando um link para o frame original. Usa a chave Anthropic da plataforma — não é necessária conexão Claude por equipe. Endpoints: POST /api/test-cases/import/figma/request, POST /api/test-cases/import/figma/start, GET /api/test-cases/import/figma/:id.

Suítes e Execuções

• list_test_suites — Lista suítes de teste com identidade do projeto, contagem de casos e status da última execução. Chamadas com chave de API exigem test_runs:read.
• create_test_suite — Cria uma suíte. Aninha até 3 níveis via parent_suite_id.
• list_test_runs — Lista execuções de teste com nome da suíte, responsável e resumo de aprovação/reprovação.
• create_test_run — Cria uma execução de suíte gerenciada pelo painel. Executar uma suíte pai inclui automaticamente todos os casos de todas as sub-suítes descendentes (um caso vinculado a ambas é adicionado exatamente uma vez). Cada linha de test_run_results registra de qual sub-suíte de origem o caso veio, para que as páginas de resultado possam agrupar por origem.

Execução por Agente Externo

Estas ferramentas permitem que o Hermes ou outro runtime de agente execute uma suíte aprovada sem se tornar o sistema de registro de QA. Use uma chave com escopo de workspace contendo apenas test_runs:read e test_runs:write. A suíte define o limite do projeto; os chamadores não podem sobrescrevê-lo.

• start_test_plan — Inicia ou retoma um snapshot imutável de suíte com um external_run_id estável. Um ID repetido retorna a execução correspondente existente e a primeira página, em vez de criar uma duplicata.
• get_test_run_plan — Lê o estado canônico da execução e uma página de plano estável. Passe o next_cursor anterior; as páginas têm como padrão 100 casos e são limitadas a 200.
• report_test_results — Envia de 1 a 200 resultados com status passed, failed, blocked ou skipped. Repetições exatas são seguras; tentar sobrescrever um caso com outro status é rejeitado.
• abort_test_run — Interrompe de forma idempotente uma execução interrompida, preservando os resultados parciais aceitos e o resumo canônico.

Comportamento de cota: repita start_test_plan com o mesmo external_run_id para retomar a execução correspondente sem consumir outra execução. Excluir dados não redefine o uso mensal de execuções.

Limite de runtime: os snapshots de caso excluem credenciais, corpos de arquivos e caminhos privados de anexos. As evidências de resultado são texto no MVP. As credenciais de destino permanecem no runtime de execução. Os custos de navegador, modelo e rede permanecem do lado do cliente, e os clientes devem restringir o acesso ao destino e a saída de rede. Um humano permanece responsável pelas decisões de defeito e release.

O guia do Agente Hermes empacota esse fluxo como uma skill comunitária mantida pelo bugAgent. O kit inicial público contém uma configuração pronta para cópia e uma skill instalável. Não é uma integração oficial da Nous Research.

Relatórios (análises Tier 1 + Tier 4)

• get_test_reports_overview — KPIs principais para um período (taxa de aprovação, execuções concluídas, casos executados) com deltas em relação ao período equivalente anterior. Os mesmos números exibidos na faixa de KPI da aba Relatórios.
• get_test_reports_failures — Quatro listas de "o que corrigir?": failing_cases (≥50% de falha, mín. 3 execuções), flaky_cases (mais alternâncias aprovação/reprovação), failing_suites (≥30% de falha, mín. 5 execuções), regressed_cases (falha mais recente com aprovação anterior no período).

1. create_test_case_folder → crie uma árvore de pastas (ex.: Smoke → Auth)
2. create_test_case → defina casos; mova-os para pastas com bulk_update_test_cases
3. create_test_suite → monte um plano de teste (sub-suítes opcionais, até 3 níveis de profundidade)
4. create_test_run → crie uma execução gerenciada por humano/painel a partir de uma suíte pai — sub-suítes incluídas automaticamente
5. start_test_plan → inicie ou retome uma execução de agente externo segura contra repetições
6. get_test_run_plan → recupere todas as páginas imutáveis do plano e execute-as no runtime selecionado
7. report_test_results → retorne lotes de resultados limitados; chame abort_test_run se a execução não puder continuar com segurança
8. get_test_reports_failures → pergunte "o que corrigir esta semana?" quando a execução for concluída
9. get_test_reports_overview → acompanhe a tendência da taxa de aprovação semana a semana

⚡

Team Booster

• scale_team — Expanda sua equipe de QA instantaneamente com testadores booster. As contas são provisionadas automaticamente com acesso de testador. Especifique team_size (1–10), location, duration, budget e, opcionalmente, product_url, product_types e tech_levels. Disponível no plano Enterprise. Você não será cobrado até que a aprovação seja dada.

1. scale_team → provisione 5 testadores seniores nos EUA por 1 mês
2. list_team_members → verifique se os novos testadores aparecem na sua equipe
3. list_reports → revise os relatórios enviados pelos testadores booster

📱

Testes Mobile (Enterprise)

Os recursos mobile têm escopo de projeto. Passe project_id ou um seletor flexível de project em criações, importações e listas filtradas. As automações herdam o projeto do aplicativo vinculado; caso contrário, o servidor usa o projeto padrão do workspace. Listas sem filtro ainda podem incluir linhas legadas de nível de workspace até que sejam migradas.

• list_mobile_apps — Lista os aplicativos enviados com filtros opcionais de project_id/project, platform e limit. Retorna o project_id de cada aplicativo para que os agentes possam manter as operações subsequentes no mesmo projeto.
• upload_mobile_app — Registra um aplicativo APK (Android) ou IPA (iOS) para testes em dispositivos reais. Requer name, platform (android/ios) e file_url; passe project_id para atribuí-lo ao projeto ativo. Para iOS, envie o IPA para execuções em dispositivos reais e, em seguida, use o dashboard para enviar um build de simulador .app para gravação.
• update_mobile_app — Substitui o binário de um aplicativo por uma nova versão. Limpa URLs em cache e builds de simulador para que todas as automações usem a nova versão na próxima execução. Requer app_id e file_url. Opcional: version. Se as automações vinculadas usarem perfis de login, o chamador deve estar autorizado para todos os perfis ou ser um proprietário/administrador ativo do workspace; os agendamentos herdam o padrão de automação protegida.
• list_mobile_automations — Lista automações móveis com filtros opcionais de project_id/project, app_id, status e limit. Os resultados incluem project_id e o ID do aplicativo vinculado.
• create_mobile_automation — Cria um script de teste. Requer name, app_id, script_type (maestro para YAML, appium para Appium Python, appium_js para Appium JavaScript) e script; passe project_id quando o aplicativo ainda não estiver no escopo do projeto. Para um fluxo Maestro YAML autossuficiente e validado externamente, defina execution_mode como browserstack_maestro; caso contrário, o padrão é appium_actions. O appId do YAML deve corresponder ao nome do pacote ou bundle ID armazenado do aplicativo vinculado; se nenhum estiver armazenado, o primeiro fluxo nativo validado o estabelece. IDs de aplicativo de espaço reservado e IDs de recursos Android ofuscados são rejeitados. O runFlow inline é suportado, mas referências a arquivos de fluxo/script externos são rejeitadas na v1. O Maestro nativo preserva comandos como inputRandomText e copyTextFrom, além de expressões de tempo de execução como ${maestro.copiedText} e ${output.value}. Um credential_id do mesmo projeto pode fornecer valores completos de inputText de ${USERNAME}/${PASSWORD}. Um variable_profile_id do mesmo projeto pode salvar o padrão para valores de ${DATA_*} referenciados; toda chave referenciada deve existir. Perfis de dados contêm apenas dados sintéticos não secretos.
• import_mobile_script — Importa um script de teste móvel existente e o transforma em uma automação executável, preservando os próprios localizadores do desenvolvedor para que as execuções resolvam elementos com precisão. Dialetos suportados: Appium-Python, WebdriverIO, Maestro (fluxos YAML) e Playwright (mobile-web). Espaços reservados de ID de recurso Android ofuscados são ignorados e relatados no mapeamento de seletores warnings. Apenas aplicativos Android. Requer name, app_id e script; opcionais target_devices e project_id. Retorna a automação, além de action_count, dialect detectados e o mapeamento de seletores warnings.
• run_mobile_automation — Inicia uma automação móvel em um dispositivo real. Requer automation_id; opcionais device, os_version, credential_id e variable_profile_id do Maestro nativo. Para dados, omita variable_profile_id para herdar o padrão da automação, passe null para não usar perfil ou passe um UUID do mesmo projeto para substituir. Toda chave de ${DATA_*} referenciada deve existir. Apenas o criador ativo do perfil ou um proprietário/administrador ativo do workspace pode executar um perfil selecionado. Valores exatos de credenciais conhecidas são filtrados, e valores exatos de perfis de dados recebem filtragem de melhor esforço a partir de evidências textuais persistidas; valores transformados, parciais, codificados ou derivados do aplicativo podem permanecer. Vídeos/capturas de tela privados autorizados permanecem disponíveis e podem exibir valores renderizados pelo aplicativo testado, portanto os perfis de dados devem conter apenas valores sintéticos não secretos. Se o contexto de edição de credenciais não estiver disponível ou a sanitização não puder ser comprovadamente segura, o texto detalhado com credenciais é omitido, enquanto status e evidências visuais disponíveis permanecem. Os diagnósticos exigem autorização de workspace e projeto; os links de mídia expiram após cinco minutos.
• list_mobile_runs — Obtém resultados autorizados de execuções móveis (status, dispositivo, resumo de resultados, links privados de vídeo e captura de tela, sessão BrowserStack, logs nativos do Maestro com credenciais filtradas e falhas quando seguramente disponíveis, e qualquer bug criado automaticamente). A associação ao workspace e o acesso ao projeto são aplicados aos diagnósticos de execução. Filtros opcionais: project_id, automation_id, status (queued, running, passed, failed, error, archived) e limit. Execuções arquivadas são excluídas por padrão.
• create_mobile_credential — Cria um perfil de login nomeado (ex.: "Admin", "Contribuidor") para um projeto: um nome de usuário + senha usados pelas automações móveis. Ambos os valores são armazenados criptografados com AES-256-GCM e são somente gravação — nenhuma ferramenta ou API jamais os retorna, e outros membros/a interface veem apenas o nome. Apenas o membro ativo do workspace que o criou ou um proprietário/administrador ativo do workspace pode vincular, executar, rotacionar ou excluir. Requer project_id, name, username, password. Somente Enterprise.
• list_mobile_credentials — Lista perfis de login (opcionalmente um project_id). Retorna apenas campos não secretos (id, name, projeto, criador, data de criação) — nunca o nome de usuário ou senha. Use o id retornado como seleção de credencial ao executar uma automação.
• update_mobile_credential — Renomeia um perfil de login ou rotaciona seu nome de usuário/senha por id. Inclua apenas os campos a alterar. Novos valores secretos são criptografados imediatamente e nunca são retornados. Apenas o membro ativo do workspace que criou o perfil ou um proprietário/administrador ativo do workspace pode atualizá-lo.
• delete_mobile_credential — Exclui permanentemente (soft-delete) um perfil de login por id. Apenas o membro ativo do workspace que criou o perfil ou um proprietário/administrador ativo do workspace pode excluí-lo. Ele é retido para auditoria e histórico de execuções, mas não pode mais ser usado nem listado; os padrões de automação são limpos e o nome torna-se reutilizável.
• create_mobile_variable_profile — Cria dados de teste sintéticos reutilizáveis, no escopo do projeto, com project_id, name e um objeto variables como {"DATA_EMAIL":"qa@example.test","DATA_REGION":"ca"}. As chaves devem ser identificadores DATA_* em maiúsculas. Os perfis permitem de 1 a 100 strings, 4096 bytes UTF-8 por valor e 65536 bytes no total. Nomes reservados de credenciais/tempo de execução são rejeitados. Nunca armazene credenciais, tokens, dados pessoais de produção ou outros segredos.
• list_mobile_variable_profiles — Lista perfis e seus valores não secretos legíveis para um project_id autorizado. As regras de atribuição de projeto se aplicam.
• update_mobile_variable_profile — Renomeia um perfil ou substitui seu objeto variables completo por id. Apenas o criador ativo ou um proprietário/administrador ativo do workspace pode atualizá-lo.
• delete_mobile_variable_profile — Exclui permanentemente (soft-delete) um perfil por id. Apenas o criador ativo ou um proprietário/administrador ativo do workspace pode excluí-lo; os padrões de automação são limpos enquanto referências históricas de execução permanecem.
• list_mobile_schedules, create_mobile_schedule, delete_mobile_schedule — Lista, cria e remove agendamentos em dispositivos reais. Os agendamentos herdam o contexto do projeto, o perfil de login e o perfil de variáveis não secretas da automação selecionada. Um agendamento que use qualquer perfil protegido exige o criador ativo do perfil ou um proprietário/administrador ativo do workspace; alterações e exclusão de agendamentos são restritas ao criador ativo do agendamento ou a um proprietário/administrador ativo do workspace.

Fluxo de Trabalho de Exemplo — Android

1. list_projects → resolva o project_id de destino
2. upload_mobile_app → registre o APK nesse projeto
3. Grave com segurança no dashboard ou use import_mobile_script / create_mobile_automation
4. list_mobile_automations → resolva a automação no mesmo projeto
5. run_mobile_automation → acione-a em um dispositivo real, opcionalmente com um perfil de login
6. list_mobile_runs → verifique status, resumo de resultados, links visuais privados e metadados da sessão BrowserStack
7. Falhas criam automaticamente relatórios de bug com snapshot da falha e detalhamento das etapas

Fluxo de Trabalho de Exemplo — iOS

1. upload_mobile_app → registre seu IPA com project_id para execuções em dispositivos reais
2. Envie o build de .app do simulador na página de detalhes do aplicativo (para gravação)
3. Grave o teste no navegador → ações capturadas do simulador
4. run_mobile_automation → acione a automação salva em um iPhone (usa o IPA)
5. update_mobile_app → substitua o IPA por uma nova versão quando estiver pronto

Fluxo de Trabalho de Exemplo — Maestro Nativo

1. upload_mobile_app → registre o APK ou IPA no projeto de destino
2. create_mobile_credential → opcionalmente, crie um perfil do mesmo projeto para um fluxo autenticado
3. create_mobile_variable_profile → opcionalmente, crie valores sintéticos DATA_* do mesmo projeto usados pelo fluxo
4. create_mobile_automation → passe um fluxo YAML conhecido e funcional com o appId exato de pacote/bundle do aplicativo vinculado, script_type: maestro e execution_mode: browserstack_maestro. Use ${USERNAME}/${PASSWORD} para login e espaços reservados do tipo ${DATA_EMAIL} para entrada sintética; passe IDs de perfil para salvar os padrões.
5. run_mobile_automation → selecione um dispositivo compatível e, opcionalmente, substitua o perfil de login ou de variáveis. Omita o perfil de variáveis para herdar, ou passe null para desativá-lo em uma execução.
6. list_mobile_runs → inspecione resumos autorizados de aprovação/reprovação, vídeos/capturas de tela privados, logs filtrados, nomes reais de etapas, falhas detalhadas e metadados de sessão. Se a sanitização segura não puder ser estabelecida para uma execução com credenciais, o texto detalhado é omitido enquanto status e evidências visuais disponíveis permanecem.

Refinar com IA: a versão beta na allowlist está disponível pelo dashboard e pelos endpoints REST de refinamento. Nenhuma ferramenta MCP de Refine faz parte do catálogo público ainda.

✅

Conformidade e Evidências (Enterprise)

• collect_compliance_evidence — Aciona a coleta automatizada de evidências a partir de serviços conectados (Cloudflare, GitHub, Sentry, Supabase, Railway). Retorna o ID da execução. Coleta configurações SSL/TLS, status do WAF, alertas do Dependabot, tendências de erros, histórico de deploys e mais.
• check_config_drift — Verifica todos os serviços conectados quanto a desvios de configuração de segurança em relação às linhas de base (modo SSL, versão TLS, HSTS, regras de WAF, cabeçalhos de segurança).
• generate_access_review — Cria um relatório trimestral de revisão de acessos. Audita membros da equipe, papéis, status de MFA, uso de chaves de API e gera recomendações (ex.: revogar chaves inativas).
• get_security_events — Consulta a linha do tempo de eventos de segurança entre serviços. Filtre por fonte (cloudflare, sentry, github) e gravidade (critical, high, medium, low, info). Eventos são correlacionados automaticamente entre serviços.

Cobertura de Conformidade

Estas ferramentas ajudam com requisitos de conformidade SOC2 (CC4.1, CC6.1, CC7.2, CC8.1), ISO 27001 (A.5.18, A.8.8, A.8.9, A.8.15-16, A.8.29) e GDPR (Art. 5, 25, 32, 33).

Clientes Compatíveis

bug_Agent_ funciona com qualquer cliente que suporte o Model Context Protocol. Aqui estão guias de configuração para clientes populares:

🤖

Claude Desktop

Abra Configurações → Desenvolvedor → Editar Config e adicione:

claude_desktop_config.json

Reinicie o Claude Desktop após salvar.

✳️

Cursor

Abra Configurações → MCP Servers → Adicionar Servidor, ou edite .cursor/mcp.json na raiz do seu projeto:

.cursor/mcp.json

🌊

Windsurf

Abra Configurações → MCP → Adicionar Servidor, ou edite o arquivo de configuração MCP:

mcp_config.json

💻

Claude Code (CLI)

Adicione bug_Agent_ diretamente do terminal:

claude mcp add bugagent -- npx -y @bugagent/mcp-server

Defina sua chave de API com export BUGAGENT_API_KEY=ba_live_... antes de iniciar.

🔧

Outros Clientes MCP

Qualquer cliente que suporte transporte MCP stdio funciona com bug_Agent_. Use a configuração padrão:

• Comando: npx
• Argumentos: ["-y", "@bugagent/mcp-server"]
• Ambiente: BUGAGENT_API_KEY

CLI

Primeiros Passos com a CLI

A CLI do bug_Agent_ dá a você controle total sobre relatórios de bugs, solicitações de recursos, projetos e integrações a partir do seu terminal. Use-a para:

• Automatize fluxos de trabalho — Integre o relato de bugs em pipelines de CI/CD, scripts e tarefas cron
• Operações em lote — Liste, filtre e gerencie relatórios sem sair do seu terminal
• Saída compatível com pipes — Formatos JSON, YAML e brutos para compor com jq, yq e outras ferramentas
• Iteração rápida — Sem necessidade de navegador — crie e atualize relatórios em segundos

Instalação

npm install -g @bugagent/cli

Verifique a instalação:

bugagent --version

Autenticação

Defina sua chave de API como uma variável de ambiente:

Ou passe-a diretamente com a flag --api-key:

bugagent reports list --api-key ba_live_your_key_here

🔑

Obtenha sua chave de API no console do bug_Agent_. As chaves começam com ba_live_.

Para autenticação persistente, adicione a exportação ao seu perfil de shell (~/.bashrc, ~/.zshrc, etc.).

Uso

Os comandos seguem o padrão:

bugagent <resource> <action> [flags]

Os recursos também podem usar sintaxe de dois pontos para subrecursos:

bugagent reports comments add --report-id WRKID-545 --body "Reproduced on v2.1"

Use --help em qualquer comando para obter detalhes:

bugagent reports --help
bugagent reports create --help

Exemplo de Sessão

Terminal

# List your projects
bugagent projects list

# Create a bug report in your default project
bugagent reports create \
  --title "Checkout 500 on discount code" \
  --description "Applying SAVE20 returns HTTP 500" \
  --severity critical \
  --type logic

# View recent reports
bugagent reports list --limit 5 --format pretty

# Get full details on a report (use the short ID or UUID)
bugagent reports get WRKID-545

# Sync a report to Jira
bugagent jira sync --report-id WRKID-545

# Check your usage
bugagent usage get --format json

Recursos da CLI

A CLI fornece comandos para:

reports Criar, listar, obter, atualizar e limpar relatórios de bugs

projects Criar, listar, atualizar e excluir projetos

keys Gerar, listar, regenerar e revogar chaves de API

jira Conectar, sincronizar relatórios e configurar configurações do Jira

usage Verificar o uso atual em relação aos limites do plano

stats Visualizar análises e detalhamentos

profile Visualizar e atualizar seu perfil e configurações

auth Fazer login, registrar e gerenciar credenciais

Flags Globais

Descrição da Flag

--api-key <key> Substituir a chave de API para este comando

--format <fmt> Formato de saída: json, yaml, pretty, raw

--debug Mostrar detalhes de requisição/resposta para solução de problemas

--help Mostrar ajuda para qualquer comando

--version Imprimir a versão da CLI

Formatos de Saída

A CLI suporta vários formatos de saída para diferentes casos de uso:

json

JSON legível por máquina. Ideal para canalizar para jq ou outras ferramentas.

yaml

Saída YAML amigável para humanos, para arquivos de configuração e legibilidade.

pretty

Padrão. Saída colorida e formatada, projetada para o terminal.

raw

Saída sem formatação. Útil para scripts e automação.

Filtrando com --transform

Use --transform com sintaxe GJSON para consultar e filtrar dados de saída:

# Default pretty output
bugagent reports list

# JSON for piping to other tools
bugagent reports list --format json

# YAML
bugagent reports list --format yaml

# Raw (no formatting)
bugagent reports get rpt_abc123 --format raw

# Filter with GJSON syntax
bugagent reports list --format json \
  --transform "items.#(severity==critical).title"

Skill de IA

A CLI também está disponível como um AgentSkill, permitindo que assistentes de codificação de IA usem o bug_Agent_ em seu nome.

✨

O que é um AgentSkill?

AgentSkills permitem que assistentes de codificação de IA (Claude Code, Cursor, etc.) invoquem ferramentas CLI contextualmente. A skill do bug_Agent_ dá ao seu assistente de IA a capacidade de registrar bugs, verificar o status do projeto e sincronizar com o Jira — tudo sem você digitar um comando.

Instalar a Skill

claude skills install bugagent --from @bugagent/mcp-server

Uma vez instalado, o Assistente de IA com consciência de contexto pode usar comandos do bug_Agent_ naturalmente — com conhecimento completo do seu produto, diretrizes de teste e documentação enviada:

Prompt do Assistente de IA

"File a critical bug: the payment webhook is returning
a 403 after the latest deploy. It affects all Stripe
events. Assign it to the payments project."

A skill traduz a linguagem natural para os comandos CLI apropriados e os executa.

🎬

Session Replay + Assistente de IA: Quando o Session Replay está habilitado (plano Enterprise), o Assistente de IA pode referenciar a sessão do usuário capturada — cliques, navegação, erros e falhas de rede dos últimos 60 segundos — para redigir automaticamente relatórios de bugs mais ricos e precisos, com contexto completo de reprodução.

Obter Ajuda

Precisa de ajuda? Estamos aqui para ajudar.

Comunidade Discord

Junte-se ao nosso Discord para suporte em tempo real e discussões da comunidade.

Suporte por E-mail

support@bugagent.com — Normalmente respondemos em até 24 horas.