Currents

oficial

Permite que Agentes de IA corrijam falhas de testes Playwright reportadas ao Currents.

GitHub

Experimente este MCPPatrocinado

O que você pode fazer com Currents MCP?

Diagnosticar testes com falha — Solicite os erros, etapas e arquivos por trás de uma execução de CI com falha via currents-get-context para corrigir problemas diretamente.
Revisar desempenho de testes — Obtenha métricas agregadas de execução e de testes para um projeto em um intervalo de datas usando currents-get-project-insights.
Gerenciar regras de quarentena — Liste, crie, atualize, ative ou desative ações que afetam os testes, como colocar specs instáveis em quarentena.
Coletar evidências de teste — Extraia capturas de tela, vídeos, rastreamentos e anexos de uma execução de CI com currents-get-test-evidence para depuração ou demonstrações.
Compartilhar resultados externamente — Crie um link público e expirável para os resultados dos testes que qualquer pessoa possa visualizar sem fazer login via currents-create-share-link.
Integrar com Jira — Crie ou vincule issues do Jira diretamente a partir de testes com falha na execução usando a integração com Jira da sua organização.

Documentação

Servidor MCP Currents

Dê aos seus agentes de codificação com IA visibilidade total sobre os resultados dos seus testes de CI. O Servidor MCP Currents conecta ferramentas como Cursor e Claude diretamente ao seu painel Currents, para que os agentes possam diagnosticar testes instáveis, identificar falhas e agir com base em dados reais de execução — sem sair do seu editor.

Consulte execuções, arquivos de spec e resultados de testes individuais do CI
Identifique tendências de erros e métricas de desempenho em toda a sua suíte de testes
Gerencie regras de quarentena, webhooks e configurações de projeto programaticamente
Deixe os agentes corrigirem o que está quebrado usando a saída real dos testes, não suposições

Ferramentas

Ferramenta	Descrição
`currents-list-actions`	Lista todas as ações de um projeto com filtragem opcional.
`currents-create-action`	Cria uma nova ação para um projeto.
`currents-get-action`	Obtém uma única ação por ID.
`currents-update-action`	Atualiza uma ação existente.
`currents-delete-action`	Exclui (arquiva) uma ação.
`currents-enable-action`	Habilita uma ação desabilitada.
`currents-disable-action`	Desabilita uma ação ativa.
`currents-list-affected-tests`	Lista testes afetados por ações (quarentena, pular, tag) para um projeto dentro de um intervalo de datas.
`currents-get-affected-test-executions`	Baseado em um teste: lista as execuções de um teste ao qual uma ação foi aplicada, dentro de um intervalo de datas, com a execução, branch e commit de cada uma.
`currents-get-action-executions`	Baseado em uma ação: lista as execuções de teste às quais uma regra foi aplicada, em todos os testes que ela tocou, dentro de um intervalo de datas.
`currents-get-projects`	Recupera projetos disponíveis na plataforma Currents.
`currents-get-project`	Obtém um único projeto por ID.
`currents-get-project-insights`	Obtém métricas agregadas de execuções e testes para um projeto dentro de um intervalo de datas.
`currents-list-pull-requests`	Lista cartões de pull request para um projeto (execuções agrupadas por meta.pr.id).
`currents-list-project-terms`	Lista termos de projeto paginados por cursor para um tipo (tag, branch, authorName, etc.).
`currents-create-jira-issue`	Cria um issue do Jira a partir de um teste de execução usando a integração Jira da organização.
`currents-link-jira-issue`	Vincula um issue Jira existente a um teste de execução usando a integração Jira da organização.
`currents-list-jira-projects`	Lista projetos Jira disponíveis para a integração da organização.
`currents-list-jira-issue-types`	Lista tipos de issue e campos personalizados do Jira para um projeto Jira.
`currents-get-runs`	Recupera uma lista de execuções para um projeto específico com filtragem opcional.
`currents-get-run-details`	Recupera detalhes de uma execução de teste específica.
`currents-find-run`	Encontra uma execução por parâmetros de consulta.
`currents-cancel-run`	Cancela uma execução em andamento.
`currents-reset-run`	Redefine arquivos de spec com falha em uma execução para permitir reexecução.
`currents-delete-run`	Exclui uma execução e todos os dados associados.
`currents-cancel-run-github-ci`	Cancela uma execução pelo ID de execução do workflow do GitHub Actions e número de tentativa.
`currents-get-spec-instance`	Recupera dados de depuração de uma execução específica de um arquivo de spec de teste por instanceId.
`currents-get-spec-files-performance`	Recupera métricas de desempenho de arquivos de spec para um projeto específico dentro de um intervalo de datas.
`currents-get-tests-performance`	Recupera métricas de teste agregadas para um projeto específico dentro de um intervalo de datas.
`currents-get-tests-signatures`	Gera uma assinatura de teste única com base no projeto, caminho do arquivo de spec e título do teste.
`currents-get-test-results`	Recupera resultados históricos de execução de testes para uma assinatura de teste específica.
`currents-get-context`	Use para corrigir testes que falharam no CI: retorna os erros, etapas e arquivos dos testes com falha de uma execução, um arquivo de spec (instância) ou um teste — o mesmo conteúdo do Fix no painel do Currents.
`currents-get-errors-explorer`	Obtenha métricas agregadas de erros para um projeto dentro de um intervalo de datas.
`currents-get-test-evidence`	Colete artefatos de evidência (capturas de tela, vídeos, traces, anexos) produzidos por testes em uma execução de CI, com URLs de download assinadas agrupadas por teste.
`currents-create-evidence-links`	Crie um link compartilhável para a evidência de uma tentativa de teste, servido a partir do trace do Playwright, e as URLs para ele: um resumo em markdown do que a tentativa fez e o que falhou, um filmstrip, uma gravação de tela animada, snapshots de DOM, requisições de rede e anexos.
`currents-create-session`	Registre uma sessão de navegador que você conduziu como uma execução do Currents, para que suas evidências possam ser lidas e compartilhadas como as de uma execução de CI.
`currents-list-webhooks`	Liste todos os webhooks de um projeto.
`currents-create-share-link`	Crie um link público para resultados de testes que qualquer pessoa possa abrir sem fazer login, até expirar. O propósito "fix" é o contexto de falha, para um agente que corrigirá os testes — o mesmo conteúdo do currents-get-context, com testes flaky incluídos e marcados como flaky. O propósito "report" lista cada teste com suas tentativas e arquivos, para uma pessoa.
`currents-create-webhook`	Crie um novo webhook para um projeto.
`currents-get-webhook`	Obtenha um único webhook por ID.
`currents-update-webhook`	Atualize um webhook existente.
`currents-delete-webhook`	Exclua um webhook.

Habilidades

Habilidades de agente que ensinam agentes de IA fluxos de trabalho da Currents em várias etapas.

Habilidade	Descrição
`browser-evidence`	Experimental.
`collect-evidence`	Mostre que o trabalho que você implementou realmente funciona, ou demonstre-o, a partir de testes executados no CI via Currents — um link de rastreamento cujo digest, filmstrip e snapshots de acessibilidade são lidos dentro de um comentário, além de screenshots, anexos e vídeos.
`fix-failing-tests`	Corrija testes que falharam no CI, usando os resultados que a Currents registrou — erros, etapas, rastreamentos, screenshots e saída do console.

O servidor publica cada habilidade como um recurso MCP, para que um agente conectado possa listá-las e lê-las sem uma cópia local:

skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md

Agentes que carregam habilidades apenas do disco ainda precisam de uma cópia — coloque o diretório de habilidades no local de habilidades do agente (ex.: .claude/skills/ para Claude Code).

Configuração

Chave da API

Obtenha uma chave da API da Currents seguindo as instruções aqui.

Uso com Cursor

Vá para Configurações do Cursor > MCP > Ativar
Adicione o seguinte ao seu mcp.json.

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Execute este comando para adicionar o MCP da Currents ao Claude Code

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

Adicione o seguinte para ativar o MCP da Currents no Claude Desktop (edite o arquivo claude_desktop_config.json):

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Endpoint MCP remoto (hospedado)

Além do transporte local stdio acima, o mesmo servidor pode ser executado como um endpoint HTTP Streamable hospedado (ex.: https://mcp.currents.dev/mcp) para uso com conectores remotos, como os aplicativos web/mobile do Claude.

O servidor hospedado não realiza autenticação própria. Cada requisição deve conter sua chave da API da Currents como um token Bearer, que é repassada para a API da Currents:

Authorization: Bearer <your-currents-api-key>

Exemplo de configuração do cliente (conector remoto):

{
  "mcpServers": {
    "currents": {
      "url": "https://mcp.currents.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Executando o servidor HTTP você mesmo:

# from the mcp-server package
npm run build && PORT=3000 npm run start:http
# or via Docker (serves /mcp, exposes the configured PORT)
docker build -t currents-mcp . && docker run -p 3000:3000 currents-mcp

O servidor Node fala HTTP simples; TLS e o domínio público terminam no proxy reverso / balanceador de carga na frente do contêiner. Um endpoint GET /healthz é fornecido para verificações de liveness.

⚠️ Aviso

Ao conectar ferramentas de IA (ex.: via MCP) à Currents, você está concedendo a elas acesso à sua chave da API, resultados de testes e metadados de CI. É sua responsabilidade avaliar quaisquer agentes ou serviços de IA que você use e garantir que eles tratem seus dados com segurança.