Currents

Serveur MCP Currents

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

• Interrogez les exécutions, les fichiers de spécification et les résultats de tests individuels depuis la CI
• Mettez en évidence les tendances d'erreurs et les métriques de performance de votre suite de tests
• Gérez les règles de quarantaine, les webhooks et les paramètres de projet par programmation
• Laissez les agents corriger ce qui est cassé en utilisant la sortie réelle des tests, pas des suppositions

Outils

Outil	Description
currents-list-actions	Liste toutes les actions d'un projet avec filtrage optionnel.
currents-create-action	Crée une nouvelle action pour un projet.
currents-get-action	Récupère une action unique par son identifiant.
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	Liste les tests affectés par des actions (quarantaine, saut, étiquette) pour un projet dans une plage de dates.
currents-get-affected-test-executions	Clé sur un test : liste les exécutions d'un test auxquelles une action a été appliquée, dans une plage de dates, avec l'exécution, la branche et le commit de chacune.
currents-get-action-executions	Clé sur une action : liste les exécutions de test auxquelles une règle a été appliquée, sur chaque test touché, dans une plage de dates.
currents-get-projects	Récupère les projets disponibles sur la plateforme Currents.
currents-get-project	Récupère un projet unique par son identifiant.
currents-get-project-insights	Récupère les métriques agrégées d'exécutions et de tests pour un projet dans une plage de dates.
currents-list-pull-requests	Liste les cartes de demandes de tirage pour un projet (exécutions groupées par meta.pr.id).
currents-list-project-terms	Liste les termes de projet paginés par curseur pour un type (étiquette, branche, nom d'auteur, etc.).
currents-create-jira-issue	Crée un ticket Jira à partir d'un test d'exécution en utilisant l'intégration Jira de l'organisation.
currents-link-jira-issue	Lie un ticket Jira existant à un test d'exécution en utilisant l'intégration Jira de l'organisation.
currents-list-jira-projects	Liste les projets Jira disponibles pour l'intégration de l'organisation.
currents-list-jira-issue-types	Liste les types de tickets et les champs personnalisés Jira pour un projet Jira.
currents-get-runs	Récupère une liste d'exécutions pour un projet spécifique avec filtrage optionnel.
currents-get-run-details	Récupère les détails d'une exécution de test spécifique.
currents-find-run	Trouve une exécution par paramètres de requête.
currents-cancel-run	Annule une exécution en cours.
currents-reset-run	Réinitialise les fichiers de spécification échoués dans une exécution pour permettre une nouvelle 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 par l'identifiant d'exécution de workflow GitHub Actions et le numéro de tentative.
currents-get-spec-instance	Récupère les données de débogage d'une exécution spécifique d'un fichier de spécification de test par instanceId.
currents-get-spec-files-performance	Récupère les métriques de performance des fichiers de spécification pour un projet spécifique dans une plage de dates.
currents-get-tests-performance	Récupère les métriques de test agrégées pour un projet spécifique dans une plage de dates.
currents-get-tests-signatures	Génère une signature de test unique basée sur le projet, le chemin du fichier de spécification et le titre du test.
currents-get-test-results	Récupère les résultats d'exécution de tests historiques pour une signature de test spécifique.
currents-get-context	À utiliser pour corriger les tests ayant échoué en CI : renvoie les erreurs, les étapes et les fichiers des tests échoués d'une exécution, d'un fichier de spec (instance) ou d'un test — le même contenu que Fix dans le tableau de bord Currents.
currents-get-errors-explorer	Obtenez des métriques d'erreur agrégées pour un projet dans une plage de dates.
currents-get-test-evidence	Collectez les artefacts de preuve (captures d'écran, vidéos, traces, pièces jointes) produits par les tests dans une exécution CI, avec des URL de téléchargement signées regroupées par test.
currents-create-evidence-links	Créez un lien partageable vers les preuves d'une tentative de test, servi à partir de sa trace Playwright, et les URL associées : un résumé Markdown de ce que la tentative a fait et de ce qui a échoué, une pellicule, un screencast animé, des instantanés DOM, des requêtes réseau et des pièces jointes.
currents-create-session	Enregistrez une session de navigateur que vous avez pilotée comme une exécution Currents, afin que ses preuves puissent être lues et partagées comme celles d'une exécution CI.
currents-list-webhooks	Liste tous les webhooks d'un projet.
currents-create-share-link	Créez un lien public vers les résultats de tests que n'importe qui peut ouvrir sans se connecter, jusqu'à son expiration. L'objectif "fix" est le contexte d'échec, pour un agent qui corrigera les tests — le même contenu que currents-get-context, avec les tests flaky inclus et marqués comme flaky. L'objectif "report" liste chaque test avec ses tentatives et ses fichiers, pour une personne.
currents-create-webhook	Créez un nouveau webhook pour un projet.
currents-get-webhook	Obtenez un webhook unique par ID.
currents-update-webhook	Mettez à jour un webhook existant.
currents-delete-webhook	Supprimez un webhook.

Compétences

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

Compétence	Description
browser-evidence	Expérimental.
collect-evidence	Montrer que le travail que vous avez implémenté fonctionne réellement, ou le démontrer, à partir de tests exécutés en CI via Currents — un lien de trace dont le digest, le filmstrip et les instantanés d'accessibilité se lisent dans un commentaire, plus des captures d'écran, des pièces jointes et des vidéos.
fix-failing-tests	Corriger les tests qui ont échoué en CI, en utilisant les résultats enregistrés par Currents — erreurs, étapes, traces, captures d'écran et sortie console.

Le serveur publie chaque compétence en tant que ressource MCP, de sorte qu'un agent connecté peut les lister 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 toujours besoin d'une copie — placez le répertoire des compétences dans l'emplacement des compétences de l'agent (par exemple .claude/skills/ pour Claude Code).

Configuration

Clé API

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

Utilisation avec Cursor

1. Allez dans 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"
      }
    }
  }
}

Point de terminaison MCP distant (hébergé)

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

Le serveur hébergé n'effectue aucune authentification propre. Chaque requête doit porter votre clé API Currents en tant que jeton Bearer, qui est transmise à 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écution du serveur HTTP vous-même :

# 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 parle HTTP simple ; TLS et le domaine public se terminent au niveau du proxy inverse / équilibreur de charge devant le conteneur. Un point de terminaison GET /healthz est fourni pour les vérifications de vivacité.

⚠️ Avis

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

Références

• Currents
• Documentation Currents
• Guide de contribution
• Publication et diffusion
• Licence