Currents

offiziell

Ermöglicht KI-Agenten, die Behebung von Playwright-Testfehlern, die an Currents gemeldet wurden.

Was kann man mit Currents MCP machen?

  • CI-Fehler diagnostizieren — Rufe mit currents-get-context die Fehler, Schritte und Dateien hinter fehlgeschlagenen Tests in einem Lauf, einer Spec-Datei oder einem einzelnen Test ab.
  • Läufe und Ergebnisse prüfen — Liste und filtere Projektläufe und rufe anschließend Laufdetails, Ergebnisse von Spec-Instanzen und historische Testergebnisse anhand der Signatur ab.
  • Flaky und langsame Tests finden — Frage Leistungsmetriken für Tests und Spec-Dateien sowie aggregierte Fehlertrends über einen Zeitraum ab.
  • Quarantäneaktionen verwalten — Erstelle, aktiviere, deaktiviere oder lösche Aktionen und liste die Tests und Ausführungen auf, die davon betroffen waren.
  • Testnachweise sammeln — Sammle Screenshots, Videos, Traces und Anhänge aus CI-Läufen oder erstelle teilbare Trace-Links.
  • Webhooks und Jira verwalten — Liste, erstelle, aktualisiere oder lösche Projekt-Webhooks und erstelle oder verknüpfe Jira-Vorgänge aus Tests eines Laufs.

Dokumentation

Currents MCP Server

Unit Tests

Gib deinen KI-Coding-Agenten vollständige Einblicke in deine CI-Testergebnisse. Der Currents MCP Server verbindet Tools wie Cursor und Claude direkt mit deinem Currents-Dashboard, damit Agenten fehleranfällige Tests diagnostizieren, Fehlerquellen eingrenzen und auf Grundlage echter Ausführungsdaten handeln können – ohne deinen Editor zu verlassen.

  • CI-Läufe, Spezifikationsdateien und einzelne Testergebnisse abfragen
  • Fehlermuster und Leistungskennzahlen für deine Testsuite anzeigen
  • Quarantäneregeln, Webhooks und Projekteinstellungen programmatisch verwalten
  • Agenten ermöglichen, Fehler anhand tatsächlicher Testausgaben statt durch bloßes Raten zu beheben

Install MCP Server

Tools

ToolBeschreibung
currents-list-actionsAlle Aktionen für ein Projekt mit optionalen Filtern auflisten.
currents-create-actionEine neue Aktion für ein Projekt erstellen.
currents-get-actionEine einzelne Aktion anhand ihrer ID abrufen.
currents-update-actionEine bestehende Aktion aktualisieren.
currents-delete-actionEine Aktion löschen (archivieren).
currents-enable-actionEine deaktivierte Aktion aktivieren.
currents-disable-actionEine aktive Aktion deaktivieren.
currents-list-affected-testsTests auflisten, die innerhalb eines Datumsbereichs von Aktionen (Quarantäne, Überspringen, Tag) für ein Projekt betroffen sind.
currents-get-affected-test-executionsNach Test gruppiert: Ausführungen eines Tests auflisten, auf die eine Aktion innerhalb eines Datumsbereichs angewendet wurde, jeweils mit Run, Branch und Commit.
currents-get-action-executionsNach Aktion gruppiert: Testausführungen auflisten, auf die eine Regel innerhalb eines Datumsbereichs angewendet wurde, über alle betroffenen Tests hinweg.
currents-get-projectsVerfügbare Projekte auf der Currents-Plattform abrufen.
currents-get-projectEin einzelnes Projekt anhand seiner ID abrufen.
currents-get-project-insightsAggregierte Run- und Testmetriken für ein Projekt innerhalb eines Datumsbereichs abrufen.
currents-list-pull-requestsPull-Request-Karten für ein Projekt auflisten (Runs gruppiert nach meta.pr.id).
currents-list-project-termsCursor-paginierte Projektbegriffe für einen Typ auflisten (tag, branch, authorName usw.).
currents-create-jira-issueEin Jira-Issue aus einem Run-Test mithilfe der Jira-Integration der Organisation erstellen.
currents-link-jira-issueEin vorhandenes Jira-Issue mithilfe der Jira-Integration der Organisation mit einem Run-Test verknüpfen.
currents-list-jira-projectsFür die Organisationsintegration verfügbare Jira-Projekte auflisten.
currents-list-jira-issue-typesJira-Issue-Typen und benutzerdefinierte Felder für ein Jira-Projekt auflisten.
currents-get-runsEine Liste von Runs für ein bestimmtes Projekt mit optionalen Filtern abrufen.
currents-get-run-detailsEinen Run abrufen: Status, Commit, Branch, Gruppen und Spec-Dateien, jeweils mit ihrer instanceId, sowie die Anzahl der Dateien des Runs nach Ebene, Typ und Quelle (attachmentCounts).
currents-find-runEinen Run anhand von Abfrageparametern finden.
currents-cancel-runEinen laufenden Run abbrechen.
currents-reset-runFehlgeschlagene Spec-Dateien in einem Run zurücksetzen, damit sie erneut ausgeführt werden können.
currents-delete-runEinen Lauf und alle zugehörigen Daten löschen.
currents-cancel-run-github-ciEinen Lauf anhand der GitHub-Actions-Workflow-Lauf-ID und der Versuchsnummer abbrechen.
currents-get-spec-instanceRuft das Rohresultat der Ausführung einer Spec-Datei anhand von instanceId ab: Status und Versuche jedes Tests sowie die Artefakt-URLs.
currents-get-spec-files-performanceRuft Leistungsmetriken für Spec-Dateien eines bestimmten Projekts innerhalb eines Datumsbereichs ab.
currents-get-tests-performanceRuft aggregierte Testmetriken für ein bestimmtes Projekt innerhalb eines Datumsbereichs ab.
currents-get-tests-signaturesErstellt eine eindeutige Testsigatur anhand des Projekts, des Pfads zur Spec-Datei und des Testtitels.
currents-get-test-resultsRuft historische Testergebnisse für eine bestimmte Testsigatur ab.
currents-get-contextRufe dies zuerst auf, um herauszufinden, warum Tests in CI fehlgeschlagen sind, oder um sie zu beheben: Gibt die Fehler, Schritte und Dateien der fehlgeschlagenen Tests eines Laufs, einer Spec-Datei (Instanz) oder eines einzelnen Tests zurück – denselben Inhalt wie „Fix“ im Currents-Dashboard.
currents-get-errors-explorerRuft aggregierte Fehlermetriken für ein Projekt innerhalb eines Datumsbereichs ab.
currents-get-test-evidenceSammelt von Tests in einem CI-Lauf erzeugte Beweisartefakte (Screenshots, Videos, Traces, Anhänge) mit signierten Download-URLs, gruppiert nach Test.
currents-create-evidence-linksErstellt einen teilbaren Trace-API-Link zu den Belegen eines Testversuchs, der aus dessen Playwright-Trace bereitgestellt wird, sowie die zugehörigen URLs: eine Markdown-Trace-Zusammenfassung (die digest-URL) darüber, was der Versuch ausgeführt hat und was fehlgeschlagen ist, einen Filmstreifen, einen animierten Screencast, DOM-Snapshots, Netzwerkanfragen und Anhänge.
currents-create-sessionZeichnet eine von dir gesteuerte Browsersitzung als Currents-Sitzung auf, damit ihre Belege gelesen und geteilt werden können.
currents-add-attachmentsFügt einer Sitzung aus currents-create-session (sessionId senden) oder einem CI-Lauf (runId senden) Anhänge hinzu: Protokolle für eine Spec-Datei, einen Test oder den Lauf selbst.
currents-list-webhooksListet alle Webhooks für ein Projekt auf.
currents-create-share-linkErstellt einen öffentlichen Link zu Testergebnissen, den alle ohne Anmeldung öffnen können, bis er abläuft. Der Zweck „fix“ liefert den Fehlerkontext für einen Agenten, der die Tests beheben soll – denselben Inhalt wie currents-get-context, einschließlich instabiler Tests, die als instabil gekennzeichnet sind. Der Zweck „report“ listet für eine Person alle Tests mit ihren Versuchen und Dateien auf; bei einer Sitzung ist es die Sitzungsseite mit Status, Fehler, Anhängen und Trace.
currents-create-webhookErstellt einen neuen Webhook für ein Projekt.
currents-get-webhookRuft einen einzelnen Webhook anhand seiner ID ab.
currents-update-webhookAktualisiert einen vorhandenen Webhook.
currents-delete-webhookLöscht einen Webhook.

Skills

Agent-Skills, die KI-Agenten mehrstufige Currents-Workflows vermitteln.

SkillBeschreibung
browser-evidenceExperimentell: Beweise, dass eine Änderung in einem Browser funktioniert, den du selbst bedient hast, wenn kein Test ausgeführt werden kann.
collect-evidenceZeige anhand von Tests, die in CI über Currents ausgeführt wurden, dass deine Implementierung tatsächlich funktioniert, oder führe sie vor — mit einem Trace-API-Link, dessen Trace-Zusammenfassung, Filmstreifen und Barrierefreiheits-Snapshots in einem Kommentar angezeigt werden, sowie Screenshots, Anhängen und Videos.
fix-failing-testsBehebe Tests, die in CI fehlgeschlagen sind, anhand der von Currents aufgezeichneten Ergebnisse — Fehler, Schritte, Traces, Screenshots und Konsolenausgabe.

Der Server veröffentlicht jeden Skill als MCP-Ressource, sodass ein verbundener Agent sie ohne lokale Kopie auflisten und lesen kann:

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

Agenten, die Skills nur von der Festplatte laden, benötigen weiterhin eine Kopie — lege das Skill- Verzeichnis am Skills-Speicherort des Agenten ab (z. B. .claude/skills/ für Claude Code).

Einrichtung

API Key

Rufe einen Currents-API-Schlüssel ab, indem du den Anweisungen hier folgst.

Verwendung mit Cursor

  1. Gehe zu Cursor Settings > MCP > Enable
  2. Füge Folgendes zu deiner mcp.json hinzu.
{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Führe diesen Befehl aus, um Currents MCP zu Claude Code hinzuzufügen

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

Füge Folgendes hinzu, um Currents MCP in Claude Desktop zu aktivieren (bearbeite die Datei claude_desktop_config.json):

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

VS Code und GitHub Copilot

Die Installation in VS Code fügt den gehosteten Server hinzu. Beim ersten Verbindungsaufbau öffnet VS Code eine Currents-Anmeldeseite; ein API-Schlüssel muss nicht eingegeben werden.

So installierst du das Plugin, das sowohl die Skills als auch den Server hinzufügt:

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

  • Copilot CLI:

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

So fügst du nur den Server zu Copilot CLI hinzu:

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

Remote-MCP-Endpunkt (gehostet)

Zusätzlich zum oben beschriebenen lokalen stdio-Transport kann derselbe Server als gehosteter Streamable-HTTP-Endpunkt (z. B. https://mcp.currents.dev/mcp) für die Verwendung mit Remote- Connectors wie den Claude-Web-/Mobil-Apps ausgeführt werden.

Der gehostete Server führt keine eigene Authentifizierung durch. Jede Anfrage muss deinen Currents-API-Schlüssel als Bearer-Token enthalten, der an die Currents-API weitergeleitet wird:

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

Beispiel für eine Client-Konfiguration (Remote-Connector):

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

Den HTTP-Server selbst ausführen:

# 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

Der Node-Server verwendet einfaches HTTP; TLS und die öffentliche Domain enden am Reverse-Proxy / Load Balancer vor dem Container. Ein GET /healthz-Endpunkt steht für Liveness-Prüfungen zur Verfügung.

⚠️ Hinweis

Wenn du KI-Tools (z. B. über MCP) mit Currents verbindest, gewährst du ihnen Zugriff auf deinen API-Schlüssel, Testergebnisse und CI-Metadaten. Du bist dafür verantwortlich, die von dir verwendeten KI-Agenten oder -Dienste zu prüfen und sicherzustellen, dass sie deine Daten sicher verarbeiten.

Referenzen