Currents
offiziellErmö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-contextdie 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
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
Tools
| Tool | Beschreibung |
|---|---|
currents-list-actions | Alle Aktionen für ein Projekt mit optionalen Filtern auflisten. |
currents-create-action | Eine neue Aktion für ein Projekt erstellen. |
currents-get-action | Eine einzelne Aktion anhand ihrer ID abrufen. |
currents-update-action | Eine bestehende Aktion aktualisieren. |
currents-delete-action | Eine Aktion löschen (archivieren). |
currents-enable-action | Eine deaktivierte Aktion aktivieren. |
currents-disable-action | Eine aktive Aktion deaktivieren. |
currents-list-affected-tests | Tests auflisten, die innerhalb eines Datumsbereichs von Aktionen (Quarantäne, Überspringen, Tag) für ein Projekt betroffen sind. |
currents-get-affected-test-executions | Nach 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-executions | Nach Aktion gruppiert: Testausführungen auflisten, auf die eine Regel innerhalb eines Datumsbereichs angewendet wurde, über alle betroffenen Tests hinweg. |
currents-get-projects | Verfügbare Projekte auf der Currents-Plattform abrufen. |
currents-get-project | Ein einzelnes Projekt anhand seiner ID abrufen. |
currents-get-project-insights | Aggregierte Run- und Testmetriken für ein Projekt innerhalb eines Datumsbereichs abrufen. |
currents-list-pull-requests | Pull-Request-Karten für ein Projekt auflisten (Runs gruppiert nach meta.pr.id). |
currents-list-project-terms | Cursor-paginierte Projektbegriffe für einen Typ auflisten (tag, branch, authorName usw.). |
currents-create-jira-issue | Ein Jira-Issue aus einem Run-Test mithilfe der Jira-Integration der Organisation erstellen. |
currents-link-jira-issue | Ein vorhandenes Jira-Issue mithilfe der Jira-Integration der Organisation mit einem Run-Test verknüpfen. |
currents-list-jira-projects | Für die Organisationsintegration verfügbare Jira-Projekte auflisten. |
currents-list-jira-issue-types | Jira-Issue-Typen und benutzerdefinierte Felder für ein Jira-Projekt auflisten. |
currents-get-runs | Eine Liste von Runs für ein bestimmtes Projekt mit optionalen Filtern abrufen. |
currents-get-run-details | Einen 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-run | Einen Run anhand von Abfrageparametern finden. |
currents-cancel-run | Einen laufenden Run abbrechen. |
currents-reset-run | Fehlgeschlagene Spec-Dateien in einem Run zurücksetzen, damit sie erneut ausgeführt werden können. |
currents-delete-run | Einen Lauf und alle zugehörigen Daten löschen. |
currents-cancel-run-github-ci | Einen Lauf anhand der GitHub-Actions-Workflow-Lauf-ID und der Versuchsnummer abbrechen. |
currents-get-spec-instance | Ruft 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-performance | Ruft Leistungsmetriken für Spec-Dateien eines bestimmten Projekts innerhalb eines Datumsbereichs ab. |
currents-get-tests-performance | Ruft aggregierte Testmetriken für ein bestimmtes Projekt innerhalb eines Datumsbereichs ab. |
currents-get-tests-signatures | Erstellt eine eindeutige Testsigatur anhand des Projekts, des Pfads zur Spec-Datei und des Testtitels. |
currents-get-test-results | Ruft historische Testergebnisse für eine bestimmte Testsigatur ab. |
currents-get-context | Rufe 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-explorer | Ruft aggregierte Fehlermetriken für ein Projekt innerhalb eines Datumsbereichs ab. |
currents-get-test-evidence | Sammelt von Tests in einem CI-Lauf erzeugte Beweisartefakte (Screenshots, Videos, Traces, Anhänge) mit signierten Download-URLs, gruppiert nach Test. |
currents-create-evidence-links | Erstellt 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-session | Zeichnet eine von dir gesteuerte Browsersitzung als Currents-Sitzung auf, damit ihre Belege gelesen und geteilt werden können. |
currents-add-attachments | Fü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-webhooks | Listet alle Webhooks für ein Projekt auf. |
currents-create-share-link | Erstellt 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-webhook | Erstellt einen neuen Webhook für ein Projekt. |
currents-get-webhook | Ruft einen einzelnen Webhook anhand seiner ID ab. |
currents-update-webhook | Aktualisiert einen vorhandenen Webhook. |
currents-delete-webhook | Löscht einen Webhook. |
Skills
Agent-Skills, die KI-Agenten mehrstufige Currents-Workflows vermitteln.
| Skill | Beschreibung |
|---|---|
browser-evidence | Experimentell: Beweise, dass eine Änderung in einem Browser funktioniert, den du selbst bedient hast, wenn kein Test ausgeführt werden kann. |
collect-evidence | Zeige 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-tests | Behebe 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
- Gehe zu Cursor Settings > MCP > Enable
- Füge Folgendes zu deiner
mcp.jsonhinzu.
{
"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.