Currents

oficial

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

O que você pode fazer com Currents MCP?

  • Diagnosticar falhas de CI — Obtenha os erros, as etapas e os arquivos relacionados a testes com falha em uma execução, arquivo de especificação ou teste individual com currents-get-context.
  • Inspecionar execuções e resultados — Liste e filtre as execuções do projeto e, em seguida, obtenha detalhes das execuções, resultados de instâncias de arquivos de especificação e resultados históricos de testes por assinatura.
  • Encontrar testes instáveis e lentos — Consulte métricas de desempenho de testes e arquivos de especificação, além de tendências agregadas de erros em um intervalo de datas.
  • Gerenciar ações de quarentena — Crie, habilite, desabilite ou exclua ações e liste os testes e as execuções afetados por elas.
  • Coletar evidências de testes — Reúna capturas de tela, vídeos, rastreamentos e anexos de execuções de CI ou crie links compartilháveis para rastreamentos.
  • Gerenciar webhooks e Jira — Liste, crie, atualize ou exclua webhooks do projeto e crie ou vincule issues do Jira a partir de testes de execuções.

Documentação

Currents MCP Server

Unit Tests

Dê aos seus agentes de programação com IA visibilidade total dos resultados dos testes de CI. O Currents MCP Server conecta ferramentas como Cursor e Claude diretamente ao seu painel do 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 editor.

  • Consulte execuções, arquivos de especificação 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 do projeto programaticamente
  • Permita que os agentes corrijam o que está quebrado usando resultados reais dos testes, sem suposições

Install MCP Server

Ferramentas

FerramentaDescrição
currents-list-actionsLista todas as ações de um projeto, com filtragem opcional.
currents-create-actionCria uma nova ação para um projeto.
currents-get-actionObtém uma única ação pelo ID.
currents-update-actionAtualiza uma ação existente.
currents-delete-actionExclui (arquiva) uma ação.
currents-enable-actionAtiva uma ação desativada.
currents-disable-actionDesativa uma ação ativa.
currents-list-affected-testsLista os testes afetados por ações (quarentena, ignorar, marcar) de um projeto dentro de um intervalo de datas.
currents-get-affected-test-executionsCom base em um teste: lista as execuções de um teste às quais uma ação foi aplicada, dentro de um intervalo de datas, com a execução, a branch e o commit de cada uma.
currents-get-action-executionsCom base em uma ação: lista as execuções de teste às quais uma regra foi aplicada, em todos os testes afetados, dentro de um intervalo de datas.
currents-get-projectsRecupera os projetos disponíveis na plataforma Currents.
currents-get-projectObtém um único projeto pelo ID.
currents-get-project-insightsObtém métricas agregadas de execuções e testes de um projeto dentro de um intervalo de datas.
currents-list-pull-requestsLista os cartões de pull request de um projeto (execuções agrupadas por meta.pr.id).
currents-list-project-termsLista termos de projeto paginados por cursor para um tipo (tag, branch, authorName etc.).
currents-create-jira-issueCria uma issue do Jira a partir de um teste de execução usando a integração Jira da organização.
currents-link-jira-issueVincula uma issue existente do Jira a um teste de execução usando a integração Jira da organização.
currents-list-jira-projectsLista os projetos do Jira disponíveis para a integração da organização.
currents-list-jira-issue-typesLista os tipos de issue e os campos personalizados do Jira para um projeto do Jira.
currents-get-runsRecupera uma lista de execuções de um projeto específico, com filtragem opcional.
currents-get-run-detailsRecupera uma execução: seu status, commit, branch, grupos e arquivos de especificação, cada um com seu instanceId, e quantos arquivos a execução tem por nível, tipo e origem (attachmentCounts).
currents-find-runEncontra uma execução por parâmetros de consulta.
currents-cancel-runCancela uma execução em andamento.
currents-reset-runRedefine os arquivos de especificação com falha em uma execução para permitir a reexecução.
currents-delete-runExclui uma execução e todos os dados associados.
currents-cancel-run-github-ciCancela uma execução pelo ID da execução do workflow do GitHub Actions e pelo número da tentativa.
currents-get-spec-instanceRecupera o resultado bruto da execução de um arquivo de especificação por instanceId: o estado e as tentativas de cada teste, além dos URLs dos artefatos.
currents-get-spec-files-performanceRecupera métricas de desempenho dos arquivos de especificação de um projeto específico dentro de um intervalo de datas.
currents-get-tests-performanceRecupera métricas agregadas de testes de um projeto específico dentro de um intervalo de datas.
currents-get-tests-signaturesGera uma assinatura de teste exclusiva com base no projeto, no caminho do arquivo de especificação e no título do teste.
currents-get-test-resultsRecupera resultados históricos de execução de testes para uma assinatura de teste específica.
currents-get-contextChame esta ferramenta primeiro para descobrir por que os testes falharam na CI ou para corrigi-los: retorna os erros, as etapas e os arquivos dos testes que falharam em uma execução, em um arquivo de especificação (instância) ou em um teste — o mesmo conteúdo de Fix no painel do Currents.
currents-get-errors-explorerObtém métricas agregadas de erros de um projeto dentro de um intervalo de datas.
currents-get-test-evidenceColeta artefatos de evidência (capturas de tela, vídeos, traces, anexos) produzidos pelos testes em uma execução de CI, com URLs de download assinados agrupados por teste.
currents-create-evidence-linksCria um link da API de trace compartilhável para as evidências de uma tentativa de teste, disponibilizadas a partir do trace do Playwright, e os URLs correspondentes: um resumo do trace em Markdown (o URL digest) do que a tentativa fez e do que falhou, uma sequência de imagens, uma gravação de tela animada, snapshots do DOM, solicitações de rede e anexos.
currents-create-sessionRegistra uma sessão do navegador que você conduziu como uma sessão do Currents, para que suas evidências possam ser lidas e compartilhadas.
currents-add-attachmentsAdiciona anexos a uma sessão de currents-create-session (envie sessionId) ou a uma execução de CI (envie runId): logs de um arquivo de especificação, de um teste ou da própria execução.
currents-list-webhooksLista todos os webhooks de um projeto.
currents-create-share-linkCria um link público para os resultados dos testes que qualquer pessoa pode abrir sem fazer login, até que ele expire. purpose "fix" fornece o contexto da falha para um agente que corrigirá os testes — o mesmo conteúdo de currents-get-context, incluindo os testes instáveis identificados como tal. purpose "report" lista todos os testes com suas tentativas e arquivos, para uma pessoa; para uma sessão, é a página da sessão: status, erro, anexos e trace.
currents-create-webhookCria um novo webhook para um projeto.
currents-get-webhookObtém um webhook pelo ID.
currents-update-webhookAtualiza um webhook existente.
currents-delete-webhookExclui um webhook.

Skills

Skills de agentes que ensinam fluxos de trabalho do Currents com várias etapas para agentes de IA.

SkillDescrição
browser-evidenceExperimental: comprove que uma alteração funciona em um navegador que você mesmo controlou, quando não houver um teste para executar.
collect-evidenceMostre que o trabalho implementado realmente funciona ou faça uma demonstração dele, com base em testes executados no CI via Currents — um link da API de trace cujo resumo do trace, filmstrip e snapshots de acessibilidade são exibidos em um comentário, além de capturas de tela, anexos e vídeos.
fix-failing-testsCorrija testes que falharam no CI usando os resultados registrados pelo Currents — erros, etapas, traces, capturas de tela e saída do console.

O servidor publica cada skill 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 skills apenas do disco ainda precisam de uma cópia — coloque o diretório da skill no local de skills do agente (por exemplo, .claude/skills/ para Claude Code).

Configuração

Chave de API

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

Uso com Cursor

  1. Acesse Cursor Settings > MCP > Enable
  2. 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 Currents MCP ao Claude Code

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

Adicione o seguinte para habilitar o Currents MCP 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"
      }
    }
  }
}

VS Code e GitHub Copilot

Instalar no VS Code adiciona o servidor hospedado. O VS Code abre uma página de login do Currents na primeira conexão; não é necessário inserir uma chave de API.

Para instalar o plugin, que adiciona as skills e também o servidor:

  • VS Code: abra vscode://chat-plugin/install?source=currents-dev/currents-mcp

  • Copilot CLI:

    copilot plugin marketplace add currents-dev/currents-mcp
    copilot plugin install currents@currents
    

Para adicionar apenas o servidor ao Copilot CLI:

copilot mcp add --transport http currents https://mcp.currents.dev/mcp

Endpoint MCP remoto (hospedado)

Além do transporte stdio local acima, o mesmo servidor pode ser executado como um endpoint HTTP Streamable hospedado (por exemplo, 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 solicitação deve incluir sua chave de API do Currents como um token Bearer, que é encaminhado à API do 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"
      }
    }
  }
}

Executar o servidor HTTP por conta própria:

# 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 usa HTTP simples; o TLS e o domínio público terminam no proxy reverso / balanceador de carga à frente do contêiner. Um endpoint GET /healthz é fornecido para verificações de disponibilidade.

⚠️ Aviso

Ao conectar ferramentas de IA (por exemplo, via MCP) ao Currents, você concede a elas acesso à sua chave de API, aos resultados dos testes e aos metadados do CI. É sua responsabilidade avaliar os agentes ou serviços de IA que usar e garantir que eles tratem seus dados com segurança.

Referências