Currents

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 do 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, marcar) de um projeto dentro de um intervalo de datas.
currents-get-affected-test-executions	Obtém detalhes de execução de um teste afetado específico (por assinatura) dentro de um intervalo de datas.
currents-get-affected-executions	Lista execuções de testes onde uma ação/regra específica foi aplicada, 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 de um projeto dentro de um intervalo de datas.
currents-list-pull-requests	Lista 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 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 de 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 nova execuçã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 GitHub Actions e número da 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 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 ú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	Obtém contexto de falha de teste para depuração com IA no nível de execução, instância ou teste.
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, rastreamentos, anexos) produzidos por testes em uma execução de CI, com URLs de download assinadas agrupadas por teste.
currents-list-webhooks	Lista todos os webhooks de um projeto.
currents-create-webhook	Cria um novo webhook para um projeto.
currents-get-webhook	Obtém um único webhook por ID.
currents-update-webhook	Atualiza um webhook existente.
currents-delete-webhook	Exclui um webhook.

Habilidades

Habilidades de agente que ensinam agentes de IA fluxos de trabalho multi-etapas do Currents.

Habilidade	Descrição
collect-evidence	Mostre que o trabalho implementado funciona, ou demonstre-o, usando artefatos de teste de CI — capturas de tela antes/depois, anexos de texto, vídeos, rastreamentos.

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 de API

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

Uso com Cursor

1. Vá para Configurações do Cursor > MCP > Ativar
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 MCP 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 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 solicitação deve conter sua chave de API do Currents como um token Bearer, que é repassada para a API do Currents:

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

Exemplo de configuração de 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 integridade.

⚠️ Aviso

Ao conectar ferramentas de IA (ex.: via MCP) ao Currents, você está concedendo a elas acesso à sua chave de 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.

Referências

• Currents
• Documentação do Currents
• Guia de Contribuição
• Lançamento e Publicação
• Licença