Currents

officiel

Permettre aux agents IA de corriger les échecs de tests Playwright signalés à Currents.

Que pouvez-vous faire avec Currents MCP ?

  • Diagnostiquer les échecs de CI — Récupérez les erreurs, les étapes et les fichiers associés aux tests échoués d’une exécution, d’un fichier de spécification ou d’un test unique avec currents-get-context.
  • Examiner les exécutions et les résultats — Listez et filtrez les exécutions du projet, puis récupérez les détails d’une exécution, les résultats des instances de spécification et les résultats historiques des tests par signature.
  • Repérer les tests instables et lents — Consultez les métriques de performance des tests et des fichiers de spécification, ainsi que les tendances agrégées des erreurs sur une période donnée.
  • Gérer les actions de mise en quarantaine — Créez, activez, désactivez ou supprimez des actions, et listez les tests et les exécutions concernés.
  • Collecter les éléments de preuve des tests — Récupérez les captures d’écran, les vidéos, les traces et les pièces jointes des exécutions CI, ou créez des liens de trace partageables.
  • Gérer les webhooks et Jira — Listez, créez, mettez à jour ou supprimez les webhooks du projet, et créez ou associez des tickets Jira à partir des tests d’une exécution.

Documentation

Currents MCP Server

Unit Tests

Donnez à vos agents de codage IA une visibilité complète sur les résultats de vos tests CI. Le serveur MCP Currents connecte directement des outils comme Cursor et Claude à votre tableau de bord Currents, afin que les agents puissent diagnostiquer les tests instables, identifier précisément les échecs et agir à partir de données d’exécution réelles, sans quitter votre éditeur.

  • Interroger les exécutions, les fichiers de spécification et les résultats de tests individuels de la CI
  • Faire ressortir les tendances d’erreurs et les métriques de performance dans l’ensemble de votre suite de tests
  • Gérer par programmation les règles de mise en quarantaine, les webhooks et les paramètres du projet
  • Permettre aux agents de corriger les problèmes à partir des résultats réels des tests, et non de suppositions

Install MCP Server

Outils

OutilDescription
currents-list-actionsRépertorie toutes les actions d’un projet, avec filtrage facultatif.
currents-create-actionCrée une action pour un projet.
currents-get-actionRécupère une action par son ID.
currents-update-actionMet à jour une action existante.
currents-delete-actionSupprime (archive) une action.
currents-enable-actionActive une action désactivée.
currents-disable-actionDésactive une action active.
currents-list-affected-testsRépertorie les tests affectés par des actions (mise en quarantaine, exclusion, ajout d’étiquette) pour un projet sur une période donnée.
currents-get-affected-test-executionsPour un test donné, répertorie ses exécutions auxquelles une action a été appliquée sur une période donnée, avec le run, la branche et le commit de chacune.
currents-get-action-executionsPour une action donnée, répertorie les exécutions de tests auxquelles une règle a été appliquée, parmi tous les tests concernés, sur une période donnée.
currents-get-projectsRécupère les projets disponibles sur la plateforme Currents.
currents-get-projectRécupère un projet par son ID.
currents-get-project-insightsRécupère les métriques agrégées des runs et des tests d’un projet sur une période donnée.
currents-list-pull-requestsRépertorie les cartes de demandes de fusion d’un projet (runs regroupés par meta.pr.id).
currents-list-project-termsRépertorie les termes d’un projet, paginés par curseur, pour un type donné (tag, branch, authorName, etc.).
currents-create-jira-issueCrée un ticket Jira à partir d’un test d’un run à l’aide de l’intégration Jira de l’organisation.
currents-link-jira-issueAssocie un ticket Jira existant à un test d’un run à l’aide de l’intégration Jira de l’organisation.
currents-list-jira-projectsRépertorie les projets Jira disponibles pour l’intégration de l’organisation.
currents-list-jira-issue-typesRépertorie les types de tickets et les champs personnalisés Jira d’un projet Jira.
currents-get-runsRécupère la liste des runs d’un projet donné, avec filtrage facultatif.
currents-get-run-detailsRécupère un run : son état, son commit, sa branche, ses groupes et ses fichiers de spécification, chacun avec son instanceId, ainsi que le nombre de fichiers du run par niveau, type et source (attachmentCounts).
currents-find-runRecherche un run à l’aide de paramètres de requête.
currents-cancel-runAnnule un run en cours.
currents-reset-runRéinitialise les fichiers de spécification en échec d’un run pour permettre leur réexécution.
currents-delete-runSupprime une exécution et toutes les données associées.
currents-cancel-run-github-ciAnnule une exécution à partir de l’ID d’exécution du workflow GitHub Actions et du numéro de tentative.
currents-get-spec-instanceRécupère le résultat brut de l’exécution d’un fichier de spécification à partir de son instanceId : l’état et les tentatives de chaque test, ainsi que les URL des artefacts.
currents-get-spec-files-performanceRécupère les métriques de performance des fichiers de spécification d’un projet donné sur une période donnée.
currents-get-tests-performanceRécupère les métriques agrégées des tests d’un projet donné sur une période donnée.
currents-get-tests-signaturesGénère une signature de test unique à partir du projet, du chemin du fichier de spécification et du titre du test.
currents-get-test-resultsRécupère l’historique des résultats d’exécution d’un test à partir d’une signature de test donnée.
currents-get-contextAppelez cette fonction en premier pour comprendre pourquoi des tests ont échoué en CI ou pour les corriger : elle renvoie les erreurs, les étapes et les fichiers des tests ayant échoué lors d’une exécution, d’un fichier de spécification (instance) ou d’un test — le même contenu que Fix dans le tableau de bord Currents.
currents-get-errors-explorerRécupère les métriques d’erreurs agrégées d’un projet sur une période donnée.
currents-get-test-evidenceCollecte les artefacts de preuve (captures d’écran, vidéos, traces, pièces jointes) produits par les tests lors d’une exécution CI, avec des URL de téléchargement signées regroupées par test.
currents-create-evidence-linksCrée un lien API de trace partageable vers les preuves d’une tentative de test, fournies par sa trace Playwright, ainsi que les URL correspondantes : un résumé de trace au format Markdown (l’URL digest) décrivant les actions de la tentative et son échec, une pellicule, un screencast animé, des instantanés du DOM, des requêtes réseau et des pièces jointes.
currents-create-sessionEnregistre une session de navigateur que vous avez pilotée en tant que session Currents, afin que ses preuves puissent être consultées et partagées.
currents-add-attachmentsAjoute des pièces jointes à une session créée avec currents-create-session (envoyez sessionId) ou à une exécution CI (envoyez runId) : journaux d’un fichier de spécification, d’un test ou de l’exécution elle-même.
currents-list-webhooksListe tous les webhooks d’un projet.
currents-create-share-linkCrée un lien public vers les résultats des tests, accessible à tous sans connexion jusqu’à son expiration. Le paramètre purpose "fix" fournit le contexte de l’échec à un agent chargé de corriger les tests — le même contenu que currents-get-context, avec les tests instables inclus et signalés comme tels. Le paramètre purpose "report" répertorie chaque test avec ses tentatives et ses fichiers, à l’intention d’une personne ; pour une session, il s’agit de la page de session : état, erreur, pièces jointes et trace.
currents-create-webhookCrée un webhook pour un projet.
currents-get-webhookRécupère un webhook à partir de son ID.
currents-update-webhookMet à jour un webhook existant.
currents-delete-webhookSupprime un webhook.

Compétences

Compétences d’agent qui enseignent aux agents IA des workflows Currents en plusieurs étapes.

CompétenceDescription
browser-evidenceExpérimental : prouver qu’une modification fonctionne dans un navigateur que vous avez piloté vous-même, lorsqu’il n’y a aucun test à exécuter.
collect-evidenceMontrer que le travail que vous avez implémenté fonctionne réellement, ou en faire une démonstration, à partir des tests exécutés dans CI via Currents — un lien vers l’API de trace dont le résumé de trace, la pellicule et les instantanés d’accessibilité sont consultables dans un commentaire, ainsi que des captures d’écran, des pièces jointes et des vidéos.
fix-failing-testsCorriger les tests qui ont échoué dans CI à l’aide des résultats enregistrés par Currents — erreurs, étapes, traces, captures d’écran et sortie de la console.

Le serveur publie chaque compétence en tant que ressource MCP, afin qu’un agent connecté puisse les répertorier et les lire sans copie locale :

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

Les agents qui chargent les compétences uniquement depuis le disque ont tout de même besoin d’une copie — placez le répertoire de la compétence dans l’emplacement des compétences de l’agent (par ex. .claude/skills/ pour Claude Code).

Configuration

Clé API

Obtenez une clé API Currents en suivant les instructions ici.

Utilisation avec Cursor

  1. Accédez à Cursor Settings > MCP > Enable
  2. Ajoutez ce qui suit à votre mcp.json.
{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Exécutez cette commande pour ajouter Currents MCP à Claude Code

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

Ajoutez ce qui suit pour activer Currents MCP sur Claude Desktop (modifiez le fichier claude_desktop_config.json) :

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

VS Code et GitHub Copilot

Installer dans VS Code ajoute le serveur hébergé. Lors de sa première connexion, VS Code ouvre une page de connexion Currents ; aucune clé API n’est à saisir.

Pour installer le plugin, qui ajoute les compétences ainsi que le serveur :

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

  • Copilot CLI :

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

Pour ajouter uniquement le serveur à Copilot CLI :

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

Point de terminaison MCP distant (hébergé)

En plus du transport stdio local ci-dessus, le même serveur peut fonctionner comme point de terminaison HTTP Streamable hébergé (par ex. https://mcp.currents.dev/mcp) pour être utilisé avec des connecteurs distants tels que les applications web et mobiles Claude.

Le serveur hébergé n’effectue aucune authentification de son propre chef. Chaque requête doit inclure votre clé API Currents en tant que jeton Bearer, qui est transmis à l’API Currents :

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

Exemple de configuration client (connecteur distant) :

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

Exécuter vous-même le serveur HTTP :

# 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

Le serveur Node utilise HTTP en clair ; le proxy inverse / l’équilibreur de charge situé devant le conteneur gère TLS et le domaine public. Un point de terminaison GET /healthz est fourni pour les contrôles de disponibilité.

⚠️ Avis

En connectant des outils d’IA (par ex. via MCP) à Currents, vous leur accordez l’accès à votre clé API, aux résultats des tests et aux métadonnées CI. Il vous incombe de vérifier les agents ou services d’IA que vous utilisez et de vous assurer qu’ils traitent vos données de manière sécurisée.

Références