Currents
officielPermettre 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
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
Outils
| Outil | Description |
|---|---|
currents-list-actions | Répertorie toutes les actions d’un projet, avec filtrage facultatif. |
currents-create-action | Crée une action pour un projet. |
currents-get-action | Récupère une action par son ID. |
currents-update-action | Met à jour une action existante. |
currents-delete-action | Supprime (archive) une action. |
currents-enable-action | Active une action désactivée. |
currents-disable-action | Désactive une action active. |
currents-list-affected-tests | Ré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-executions | Pour 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-executions | Pour 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-projects | Récupère les projets disponibles sur la plateforme Currents. |
currents-get-project | Récupère un projet par son ID. |
currents-get-project-insights | Ré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-requests | Répertorie les cartes de demandes de fusion d’un projet (runs regroupés par meta.pr.id). |
currents-list-project-terms | Répertorie les termes d’un projet, paginés par curseur, pour un type donné (tag, branch, authorName, etc.). |
currents-create-jira-issue | Crée un ticket Jira à partir d’un test d’un run à l’aide de l’intégration Jira de l’organisation. |
currents-link-jira-issue | Associe un ticket Jira existant à un test d’un run à l’aide de l’intégration Jira de l’organisation. |
currents-list-jira-projects | Répertorie les projets Jira disponibles pour l’intégration de l’organisation. |
currents-list-jira-issue-types | Répertorie les types de tickets et les champs personnalisés Jira d’un projet Jira. |
currents-get-runs | Récupère la liste des runs d’un projet donné, avec filtrage facultatif. |
currents-get-run-details | Ré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-run | Recherche un run à l’aide de paramètres de requête. |
currents-cancel-run | Annule un run en cours. |
currents-reset-run | Réinitialise les fichiers de spécification en échec d’un run pour permettre leur réexécution. |
currents-delete-run | Supprime une exécution et toutes les données associées. |
currents-cancel-run-github-ci | Annule une exécution à partir de l’ID d’exécution du workflow GitHub Actions et du numéro de tentative. |
currents-get-spec-instance | Ré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-performance | Ré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-performance | Récupère les métriques agrégées des tests d’un projet donné sur une période donnée. |
currents-get-tests-signatures | Gé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-results | Récupère l’historique des résultats d’exécution d’un test à partir d’une signature de test donnée. |
currents-get-context | Appelez 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-explorer | Récupère les métriques d’erreurs agrégées d’un projet sur une période donnée. |
currents-get-test-evidence | Collecte 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-links | Cré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-session | Enregistre 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-attachments | Ajoute 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-webhooks | Liste tous les webhooks d’un projet. |
currents-create-share-link | Cré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-webhook | Crée un webhook pour un projet. |
currents-get-webhook | Récupère un webhook à partir de son ID. |
currents-update-webhook | Met à jour un webhook existant. |
currents-delete-webhook | Supprime un webhook. |
Compétences
Compétences d’agent qui enseignent aux agents IA des workflows Currents en plusieurs étapes.
| Compétence | Description |
|---|---|
browser-evidence | Expé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-evidence | Montrer 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-tests | Corriger 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
- Accédez à Cursor Settings > MCP > Enable
- 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.