TestDino MCP

Um servidor Model Context Protocol (MCP) que conecta o TestDino a agentes de IA. Este servidor permite que você interaja diretamente com seus dados de teste do TestDino por meio de comandos em linguagem natural.

GitHub
9
Experimente este MCPPatrocinado

Documentação

TestDino Logo TestDino MCP

Um servidor Model Context Protocol (MCP) que conecta o TestDino a agentes de IA. Este servidor permite que você interaja com seus dados de teste do TestDino diretamente por meio de comandos em linguagem natural.

npm version Node.js License: MIT Docs

Início Rápido

Adicione isto à configuração do seu cliente MCP (~/.cursor/mcp.json para Cursor) e reinicie o cliente:

{
  "mcpServers": {
    "TestDino": {
      "command": "npx",
      "args": ["-y", "@testdino/mcp"],
      "env": {
        "TESTDINO_PAT": "your-pat-here"
      }
    }
  }
}

Obtenha seu PAT em TestDino → Configurações do Usuário → Tokens de Acesso Pessoal e pergunte ao seu assistente: "Verifique a saúde do TestDino." Você deve ver sua conta, organizações e projetos. A configuração completa para Cursor e Claude Desktop está em Integração.

O Que É Isto?

Este servidor MCP preenche a lacuna entre sua plataforma de gerenciamento de testes TestDino e agentes de IA. Em vez de navegar manualmente pelo painel do TestDino, você pode pedir ao seu assistente de IA para:

  • Verificar resultados de execuções de teste
  • Analisar falhas de teste
  • Obter informações detalhadas de casos de teste
  • Gerenciar casos de teste e suítes manuais
  • Planejar releases, iniciar execuções de teste manuais e atribuir testadores
  • Executar sessões de teste exploratório
  • Registrar veredictos por caso (aprovado / reprovado / bloqueado / etc.) pelo chat

Tudo por meio de comandos conversacionais simples.

Recursos

  • 🔍 Verificação de Saúde: Verifique sua conexão e valide seu PAT do TestDino. Obtenha informações da conta e liste todas as organizações e projetos disponíveis.
  • 📊 Gerenciamento de Execuções de Teste: Liste e recupere informações detalhadas sobre suas execuções de teste com opções de filtro (branch, tempo, autor, commit, ambiente).
  • 🧪 Análise de Casos de Teste: Obtenha detalhes abrangentes sobre casos de teste individuais, incluindo erros, logs, etapas de execução e artefatos (capturas de tela, vídeos, traces).
  • 🐛 Depuração Assistida por IA: Depure falhas de casos de teste com agregação de dados históricos, análise de padrões de falha e prompts de depuração amigáveis para IA. Analise padrões em múltiplas execuções para identificar causas raiz.
  • 🧭 Auditoria de Qualidade de Teste: Busque um prompt de auditoria selecionado pelo servidor mais sinais de branch, analise seu código de teste local e armazene o relatório concluído de volta no TestDino sem enviar arquivos de código-fonte brutos.
  • 📝 Gerenciamento de Casos de Teste: Crie, atualize, liste e recupere casos de teste manuais com filtragem e organização abrangentes (status, prioridade, severidade, tipo, camada, comportamento, tags).
  • 📁 Organização de Suítes de Teste: Crie e gerencie hierarquias de suítes de teste para organizar seus casos de teste manuais.
  • 🚀 Planejamento de Releases: Crie, navegue e atualize releases (também conhecidos como marcos), aninhe-os em até 3 níveis de profundidade e acompanhe estatísticas de progresso consolidadas em todas as execuções de um release.
  • ▶️ Execuções de Teste Manuais: Inicie execuções com escopo em suítes específicas ou no projeto inteiro, vincule-as a um release e atualize o estado do fluxo de trabalho sem sair do chat.
  • ✅ Atribuição e Veredictos por Caso: Dentro de uma execução, atribua cada caso de teste a um testador (por User _id ou e-mail) e defina o resultado — passed, failed, blocked, skipped, retest — exatamente como a interface faz.
  • 🔭 Sessões Exploratórias: Crie sessões de teste exploratório com missão/carta, atribua um testador, vincule a um release e acompanhe o estado.
  • 🧩 Triagem de Falhas em Escala: Agrupe os testes com falha de uma execução pela assinatura de erro subjacente para ver quais vermelhos têm uma única causa raiz versus várias, para que você corrija o problema real primeiro.
  • 🔗 Integrações com Rastreadores de Issues: Conecte Jira, Linear, Asana ou monday.com e registre uma issue rastreada diretamente de um teste ou execução com falha e verifique o status depois sem sair do chat.
  • 🔌 Compatível com MCP: Construído no padrão Model Context Protocol. Você pode configurar o TestDino MCP com qualquer IDE ou agente de IA compatível com MCP (Cursor, Claude Desktop, etc.).
  • ⚡ Configuração Fácil: Instale e configure em minutos com npx. Sem necessidade de instalação!
  • 🔐 Seguro: PAT armazenado com segurança na sua configuração local. Um único PAT fornece acesso a todas as organizações e projetos para os quais você tem permissões.

Ferramentas Disponíveis

O servidor fornece 43 ferramentas em nove domínios:

Execução e Resultados de Teste:

  1. health - Verifique sua conexão e valide seu PAT. Mostra informações da conta, organizações disponíveis e projetos com permissões de acesso.
  2. list_testruns - Navegue pelas execuções de teste com filtros (branch, intervalo de tempo, autor, commit, ambiente). Suporta paginação e operações em lote.
  3. get_run_details - Obtenha detalhes abrangentes sobre uma execução de teste específica, incluindo estatísticas, suítes de teste, casos de teste e metadados. Suporta operações em lote (IDs separados por vírgula, máx. 20).
  4. list_testcase - Liste casos de teste com filtragem abrangente (por execução de teste, status, navegador, categoria de erro, branch, ambiente, commit, autor, arquivo de spec, tags, tempo de execução, artefatos e mais). Pode filtrar por critérios da execução de teste ou diretamente por propriedades do caso de teste.
  5. get_testcase_details - Obtenha informações detalhadas sobre um caso de teste específico, incluindo mensagens de erro, stack traces, etapas de teste, logs de console e artefatos. Pode identificar pelo testcase_id sozinho ou por testcase_name com testrun_id/contador.
  6. debug_testcase - Depure um caso de teste agregando dados históricos de falhas em múltiplas execuções. Retorna padrões de falha, categorias de erro, mensagens de erro comuns, locais de erro, problemas específicos de navegador e um prompt de depuração pré-formatado para análise de IA. Perfeito para análise de causa raiz e identificação de comportamento flaky de teste.
  7. get_debug_evidence - Comece toda investigação de teste com falha aqui: uma chamada retorna o veredicto de flakiness com assinaturas por tentativa, o limite de regressão (última aprovação → primeira falha) e links de download de curta duração para cada artefato armazenado (trace, capturas de tela, imagens de diff visual). JSON ou markdown.
  8. get_flake_verdict - Compare as tentativas de repetição de um teste dentro de uma execução e diga se a falha se repete: deterministic, flaky ou inconclusive.
  9. verify_fix - Após uma nova execução chegar, verifique se uma correção se manteve contra a execução em que você viu a falha: fixed, not_fixed, changed_failure, still_failing, unstable, no_runs_since_baseline ou baseline_not_found.
  10. get_audit_report - Busque o contexto de auditoria (prompt selecionado pelo servidor + principais testes com falha / flaky / lentos para o branch) para iniciar uma nova auditoria, navegue por relatórios históricos ou recupere um por reportId.
  11. submit_audit_report - Envie um relatório de auditoria concluído (pontuação, descobertas, recomendações, markdown) para o TestDino.

Gerenciamento de Casos de Teste:

  1. list_manual_test_cases - Pesquise e liste casos de teste manuais com filtragem abrangente (projeto, suíte, status, prioridade, severidade, tipo, camada, comportamento, status de automação, tags, status flaky).
  2. get_manual_test_case - Obtenha informações detalhadas sobre um caso de teste manual específico, incluindo etapas, campos personalizados, pré-condições, pós-condições e todos os metadados.
  3. create_manual_test_case - Crie novos casos de teste manuais com etapas, pré-condições, pós-condições e metadados (prioridade, severidade, tipo, camada, comportamento).
  4. update_manual_test_case - Atualize casos de teste manuais existentes (título, descrição, etapas, status, prioridade, severidade, tipo, camada, comportamento, pré-condições, pós-condições).
  5. list_manual_test_suites - Liste a hierarquia de suítes de teste para encontrar IDs de suíte para organização. Suporta filtragem por suíte pai.
  6. create_manual_test_suite - Crie novas pastas de suíte de teste para organizar casos de teste. Suporta suítes aninhadas fornecendo parentSuiteId.

Releases (também conhecidos como Marcos):

  1. list_releases - Navegue pelos releases de um projeto com filtros (pesquisa, tipo, status de conclusão, release pai). Releases agrupam execuções + sessões e podem aninhar em até 3 níveis de profundidade.
  2. get_release - Obtenha detalhes completos de um release, incluindo datas, status, hierarquia pai/raiz e estatísticas de progresso consolidadas em todas as execuções deste release e seus descendentes. Aceita _id interno ou ID no estilo contador como MS-12.
  3. create_release - Crie um novo release com nome, tipo, datas e pai opcional para aninhamento.
  4. update_release - Modifique um release existente — nome, datas, sinalizadores de conclusão, tipo, issues vinculadas. Releases fechados ainda são editáveis.

Execuções de Teste Manuais:

  1. list_manual_runs - Navegue pelas execuções manuais em um projeto. Filtre por status, estado, ambiente, release, tags ou pesquisa de nome em texto livre.
  2. get_manual_run - Obtenha detalhes completos de uma execução — estatísticas de teste (total/aprovado/reprovado/bloqueado/não testado), contribuidores, anexos, release vinculado. Aceita _id interno ou ID no estilo contador como RUN-12.
  3. create_manual_run - Crie uma nova execução manual. Escolha selectionMode='all' para cada caso no projeto, ou 'selected' com IDs de suíte/caso para definir o escopo. Vincule a um release com releaseId.
  4. update_manual_run - Modifique metadados da execução — nome, ambiente, estado, vínculo de release, tags. Execuções fechadas são somente leitura, exceto para releaseId.
  5. list_run_test_cases - Obtenha as linhas de execução por caso dentro de uma execução — exatamente o que a interface mostra na tabela de casos de teste da execução. Cada linha inclui o responsável atual e o resultado atual. Filtre por responsável (e-mail ou _id) ou resultado.
  6. update_run_test_case - Defina o responsável e/ou resultado para um caso de teste dentro de uma execução — igual a clicar em "Atribuir a" + a pílula de resultado na interface. Funciona até em casos não testados (cria automaticamente a linha por caso na primeira edição). Aceita caseKey (TC-156), _id do caso de teste ou o ID interno tcm_rtc_….

Sessões Exploratórias:

  1. list_sessions - Navegue pelas sessões exploratórias em um projeto. Filtre por status, estado, sessionType, responsável (e-mail ou _id), release, tags.
  2. get_session - Obtenha detalhes completos de uma sessão — nome, missão, status, responsável, release vinculado, descobertas. Aceita _id interno ou ID no estilo contador como SES-12.
  3. create_session - Crie uma nova sessão exploratória com missão/carta, sessionType, responsável, estimativa e vínculo opcional de release.
  4. update_session - Modifique metadados da sessão — nome, missão, responsável, estado, estimativa, issues vinculadas, anexos.

Análise de Erros:

  1. get_run_error_clusters - Agrupe os testes com falha de uma execução por assinatura de erro para triagem em escala. Revela clusters de testes que compartilham o mesmo erro de causa raiz, com filtro opcional de status (all, failed, flaky). Use após list_testruns para entender por que uma execução falhou.

Integrações (Rastreadores de Issues):

  1. connect_integration - Retorne uma URL de conexão OAuth para um provedor (Jira, Linear, Asana, monday.com, GitHub). Mostre a URL ao usuário para autorizar; não a abra programaticamente.
  2. get_integration_status - Informe se um provedor está conectado para um projeto. Defina includeCreateOptions para também buscar os campos disponíveis para criação de issues. Chame isto antes de create_external_issue.
  3. create_external_issue - Registre uma issue em um rastreador conectado (Jira, Linear, Asana, monday.com) a partir de uma entidade de origem do TestDino, como um caso de teste ou execução com falha. Suporta preview e novas tentativas idempotentes via idempotencyKey.
  4. get_external_issue - Busque issues criadas anteriormente por seus IDs ou chaves (uma ou várias) e retorne o status atual no provedor (Jira, Linear, Asana).

Suporte a provedores: Todos os provedores podem ser conectados e ter o status verificado. A criação de issues funciona com Jira, Linear, Asana e monday.com. A leitura de issues funciona com Jira, Linear e Asana. GitHub é suportado como integração de PR/CI, não como rastreador de issues. AI Insights:

  1. get_ai_insights - Análise de IA do TestDino em três níveis: visão geral do projeto (contagem de falhas por categoria + principais problemas em um intervalo de datas), execução (categorização de falhas por IA, clusters de falhas, tabela de análise de erros, resumo escrito por LLM) e caso de teste (recomendações + correções rápidas). Retorna um status disabled quando os recursos de IA estão desativados para o projeto (Configurações → IA).
  2. get_trace_analysis - Resolve o trace do Playwright hospedado de um teste com falha para uma URL de download de curta duração e retorna um runbook para depuração local com trace-CLI (abrir → ações → snapshot → fechar).

Os AI Insights também estão disponíveis inline: passe include_ai_insights: true para get_run_details (anexa os AI Insights da execução em ai_insights) ou debug_testcase (anexa recomendações + correções rápidas em ai_fixes).

Opções de Instalação

Existem principalmente 3 opções para usar o TestDino MCP:

Opção 1: Via npx (Recomendado - Sem Instalação)

  • Nenhuma instalação necessária
  • Baixa e executa automaticamente quando necessário
  • Sempre usa a versão mais recente
  • Configurado em qualquer plataforma compatível com MCP

Opção 2: Instalação Global

npm install -g @testdino/mcp
  • Instale uma vez, use em qualquer projeto
  • Requer Node.js 20+ e npm
  • Use o comando: testdino-mcp

Opção 3: Instalação no Projeto

npm install @testdino/mcp
  • Instalado no node_modules do seu projeto
  • Use o comando: npx @testdino/mcp

Integração

Um guia simples de integração para o Cursor IDE:

Passo 1: Obtenha seu Personal Access Token (PAT)

  1. Faça login na sua conta TestDino
  2. Navegue até User Settings → Personal Access Tokens
  3. Gere um novo PAT na seção Personal Access Tokens.
  4. Importante: Este PAT fornece acesso a todas as organizações e projetos para os quais você tem permissão

Passo 2: Configure o Cursor

  1. Abra ou crie o arquivo de configuração do MCP:

    • Windows: %APPDATA%\Cursor\mcp.json
    • macOS/Linux: ~/.cursor/mcp.json
    • Específico do projeto: .cursor/mcp.json na raiz do seu projeto

  2. Se você estiver usando npx ou instalando dentro do projeto, adicione a configuração:

{
  "mcpServers": {
    "TestDino": {
      "command": "npx",
      "args": ["-y", "@testdino/mcp"],
      "env": {
        "TESTDINO_PAT": "Your PAT here"
      }
    }
  }
}

Importante: Substitua Your PAT here pelo seu Personal Access Token (PAT) real do Passo 1.

Passo 3: Reinicie e Verifique

  1. Feche completamente e reinicie o Cursor
  2. Verifique a conexão perguntando: "Check TestDino health"
  3. Você deve ver seu nome de conta, organizações disponíveis e projetos!

Alternativa: Instalação Global

Se você preferir instalar globalmente em vez de usar npx ou instalação no projeto:

npm install -g @testdino/mcp

Em seguida, use esta configuração:

{
  "mcpServers": {
    "TestDino": {
      "command": "testdino-mcp",
      "env": {
        "TESTDINO_PAT": "Your PAT here"
      }
    }
  }
}

O servidor usa o protocolo MCP padrão, portanto funcionará com outros clientes compatíveis com MCP também.

Claude Desktop

O Claude Desktop usa o mesmo formato de configuração, em um arquivo diferente:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "TestDino": {
      "command": "npx",
      "args": ["-y", "@testdino/mcp"],
      "env": {
        "TESTDINO_PAT": "your-pat-here"
      }
    }
  }
}

Reinicie o Claude Desktop e pergunte "Check TestDino health" para verificar.

Desenvolvimento local

Por padrão, o servidor fala com https://mcp.testdino.com. Para apontá-lo para uma API local durante o desenvolvimento, defina TESTDINO_API_URL (veja .env.example):

TESTDINO_API_URL=http://localhost:3001

Uso

Uma vez configurado, basta conversar com seu assistente de IA em linguagem natural. Importante: As ferramentas exigem seu Personal Access Token (PAT) configurado como TESTDINO_PAT em mcp.json. O PAT fornece automaticamente acesso a todas as organizações e projetos para os quais você tem permissão.

Exemplos de Comandos

Experimente estes comandos em linguagem natural no Cursor ou Claude Desktop (ou outros clientes compatíveis com MCP):

Conexão e Configuração:

  • "Check if my TestDino connection is working"
  • "Validate my TestDino PAT"

Explorando Execuções de Teste:

  • "Show me my last 5 test runs"
  • "What test runs are on the develop branch?"
  • "List test runs from the last 3 days"
  • "Show me test runs by author john"
  • "Find test runs for commit abc123"
  • "List all test runs in production environment"

Analisando Resultados de Teste:

  • "Get details for test run test_run_6901b2abc6b187e63f536a6b"
  • "Get details for test run counter 42"
  • "What test cases failed in test run test_run_6901b2abc6b187e63f536a6b?"
  • "Show me all flaky tests from the last test run"
  • "List all failed test cases in production environment"
  • "Show me test cases from the main branch that took more than 100 seconds"
  • "Find all timeout issues in test cases from commit abc123"

Depurando Falhas de Teste:

  • "Debug test case 'Verify user login' in project proj_123"
  • "Debug 'Verify that User Can Complete the Journey from Login to Order Placement @webkit' from testdino reports"
  • "Analyze failures for 'Checkout flow' test case in project proj_123"
  • "What are the failure patterns for 'API authentication' test?"
  • "Why is test case 'User registration' failing?"
  • "Debug test case 'Verify that user can login and logout successfully @chromium'"

Gerenciando Casos de Teste Manuais:

  • "List all manual test cases in project proj_123"
  • "Search for manual test cases with tag 'smoke' in project proj_123"
  • "Show me all critical priority manual test cases in project proj_123"
  • "Get details for manual test case TC-123 in project proj_123"
  • "Create a new manual test case for login feature in suite Authentication Tests"
  • "Update test case TC-123 to mark it as deprecated"
  • "List all test suites in project proj_123"
  • "Create a new test suite called 'Authentication Tests' in project proj_123"

Releases:

  • "List all releases in project proj_123"
  • "Show me the open iterations on this project"
  • "Get details for release MS-12 and show the rolled-up test progress"
  • "Create a release called 'Sprint 42' as an iteration from May 12 to May 26"
  • "Mark release MS-12 as completed"

Execuções de Testes Manuais:

  • "List manual runs in release MS-12"
  • "Show me all in-progress runs on staging"
  • "Get details for run RUN-7"
  • "Create a manual run called 'Sprint 42 Smoke' linked to release MS-12 on staging, covering the Authentication suite"
  • "Set run RUN-7's state to Done"
  • "Re-attach run RUN-7 to release MS-13"

Atribuindo Casos e Registrando Veredictos em uma Execução:

  • "List the test cases in run RUN-1 with their current assignees and results"
  • "Assign TC-156 in run RUN-1 to alice@company.com and mark it Passed"
  • "Mark TC-157 in run RUN-1 as Failed"
  • "Assign TC-158 in run RUN-1 to bob@company.com — leave the result untested"
  • "Show me all cases in run RUN-1 assigned to alice@company.com that are still untested"

Sessões Exploratórias:

  • "List active exploratory sessions for project proj_123"
  • "Show me sessions assigned to tester@company.com"
  • "Get details for session SES-3"
  • "Create an exploratory session called 'Auth charter — May 12' with mission 'find session-handling bugs around 2FA' assigned to tester@company.com, 60 minute estimate"
  • "Update session SES-3 to mark it Done"

Documentação

Requisitos

  • Node.js: Versão 20.0.0 ou superior
  • NPM: Versão mais recente recomendada (para gerenciamento de pacotes)
  • Conta TestDino: Conta válida com acesso a Test Runs e/ou Test Case Management
  • Personal Access Token (PAT): Necessário para autenticação. Obtenha-o em TestDino Settings → Personal Access Tokens

Principais Recursos Explicados

Depuração Assistida por IA com debug_testcase

A ferramenta debug_testcase ajuda você a entender por que os testes estão falhando, analisando dados históricos de execução:

  • Análise Histórica: Agrega dados de múltiplas execuções de teste para identificar padrões
  • Padrões de Falha: Identifica categorias de erro, mensagens e locais comuns
  • Problemas Específicos de Navegador: Detecta padrões de falha específicos de navegador
  • Detecção de Testes Flaky: Analisa padrões de repetição e indicadores de flakiness
  • Saída Amigável para IA: Retorna prompts de depuração pré-formatados para análise por IA
  • Correlação de Código: Fornece arquivo e números de linha para locais de erro, permitindo que a IA correlacione com o código-fonte

Exemplo de Fluxo de Trabalho:

  1. Pergunte: "Debug test case 'Verify user login' from testdino reports"
  2. A IA chama debug_testcase com projectId e testcase_name
  3. A ferramenta retorna dados históricos com padrões de falha
  4. A IA analisa os dados e correlaciona com seu código de teste (se acessível)
  5. A IA fornece sugestões específicas de correção com base nos padrões e na análise de código

Suporte