Currents
oficialPermite 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
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
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 pelo ID. |
currents-update-action | Atualiza uma ação existente. |
currents-delete-action | Exclui (arquiva) uma ação. |
currents-enable-action | Ativa uma ação desativada. |
currents-disable-action | Desativa uma ação ativa. |
currents-list-affected-tests | Lista os testes afetados por ações (quarentena, ignorar, marcar) de um projeto dentro de um intervalo de datas. |
currents-get-affected-test-executions | Com 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-executions | Com 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-projects | Recupera os projetos disponíveis na plataforma Currents. |
currents-get-project | Obtém um único projeto pelo ID. |
currents-get-project-insights | Obtém métricas agregadas de execuções e testes de um projeto dentro de um intervalo de datas. |
currents-list-pull-requests | Lista os cartões de pull request de 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 uma issue do Jira a partir de um teste de execução usando a integração Jira da organização. |
currents-link-jira-issue | Vincula uma issue existente do Jira a um teste de execução usando a integração Jira da organização. |
currents-list-jira-projects | Lista os projetos do Jira disponíveis para a integração da organização. |
currents-list-jira-issue-types | Lista os tipos de issue e os campos personalizados do Jira para um projeto do Jira. |
currents-get-runs | Recupera uma lista de execuções de um projeto específico, com filtragem opcional. |
currents-get-run-details | Recupera 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-run | Encontra uma execução por parâmetros de consulta. |
currents-cancel-run | Cancela uma execução em andamento. |
currents-reset-run | Redefine os arquivos de especificação com falha em uma execução para permitir a 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 da execução do workflow do GitHub Actions e pelo número da tentativa. |
currents-get-spec-instance | Recupera 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-performance | Recupera métricas de desempenho dos arquivos de especificação de um projeto específico dentro de um intervalo de datas. |
currents-get-tests-performance | Recupera métricas agregadas de testes de um projeto específico dentro de um intervalo de datas. |
currents-get-tests-signatures | Gera 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-results | Recupera resultados históricos de execução de testes para uma assinatura de teste específica. |
currents-get-context | Chame 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-explorer | Obtém métricas agregadas de erros de um projeto dentro de um intervalo de datas. |
currents-get-test-evidence | Coleta 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-links | Cria 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-session | Registra 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-attachments | Adiciona 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-webhooks | Lista todos os webhooks de um projeto. |
currents-create-share-link | Cria 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-webhook | Cria um novo webhook para um projeto. |
currents-get-webhook | Obtém um webhook pelo ID. |
currents-update-webhook | Atualiza um webhook existente. |
currents-delete-webhook | Exclui um webhook. |
Skills
Skills de agentes que ensinam fluxos de trabalho do Currents com várias etapas para agentes de IA.
| Skill | Descrição |
|---|---|
browser-evidence | Experimental: comprove que uma alteração funciona em um navegador que você mesmo controlou, quando não houver um teste para executar. |
collect-evidence | Mostre 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-tests | Corrija 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
- Acesse Cursor Settings > MCP > Enable
- 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.