NCA Social Media
Aktualisiert:
Autor:
Roland Golla
Gelber Schriftzug Cypress MCP auf Rohr, Cloud liefert Testdaten an Roboter

Was ist Cypress Cloud MCP?

Cypress Cloud MCP ist ein Remote Server nach dem Model Context Protocol, der KI Agenten direkten Zugriff auf Cypress Testergebnisse gibt. Der Agent fragt Runs, Fehlschläge, Flaky Tests und Test Replay Links selbst ab, statt dass du Stack Traces aus der Cloud in den Chat kopierst.
Der Server läuft unter https://mcp.cypress.io/mcp und spricht Streamable HTTP. Seit dem 20. Mai 2026 ist er allgemein verfügbar und in jedem Cypress Cloud Plan enthalten, auch im kostenlosen Starter Plan. Eine bestimmte Cypress App Version wird nicht vorausgesetzt.
Das Problem, das dahintersteckt, kennt jeder: Die Pipeline wird rot, du wechselst in die Cloud, suchst den Run, kopierst den Fehler, wechselst zurück in den Editor, erklärst deinem Agenten den Kontext. Cloud MCP schneidet diesen Weg ab. Der Agent holt sich die Daten selbst, während du im Code bleibst.

Inhalt

Cypress Cloud MCP mit NCA: Schnelle Hilfe vom Experten

Cypress mit Cypress Cloud läuft bei uns in Production, nicht als Demo. Roland Golla ist offizieller Cypress.io Ambassador und arbeitet seit über zwanzig Jahren an Testing und Refactoring. Diese Seite selbst wird mit Cypress getestet. Dazu kommen Claude Code und OpenCode im Terminal sowie lokale Modelle über Ollama. Wir kennen also beide Seiten der Verbindung: die Testdaten und den Agenten, der sie liest.
Passend dazu: die Vibe Coding Beratung für Teams, die KI Agenten sauber in den Entwicklungsalltag holen, das Vibe Coding Training mit OpenCode und lokalen Modellen, die Einordnung von OpenCode Features und Plugins, der GitHub MCP Server für Repositories und Pipelines, Web MCP als Grundlagenartikel zum Protokoll und die MCP Roadmap für alles, was sich am Standard noch ändert.
E2E Tests und KI Agenten zusammenbringen
Finde das passende Angebot für dein Projekt
Anfrage-Konfiguration
Starten Sie Ihre Anfrage
Projektart
Infos
Nachricht

Eliminierung technischer Schulden mit PHPStan, Rector PHP und PHPUnit. Über 20 Jahre Praxiserfahrung in skalierbaren Backends.

CORE EXPERTISE

Gesetzliche Konformität & Inklusion. Optimierung von Performance und Conversion durch radikal nutzerzentriertes, universelles Design.

BFSG COMPLIANT

Skalierbare KI-Systeme mit echtem Code Ownership. CI/CD, Backup-Strategien und Infrastruktur, die mit deinem Team wächst.

ENTERPRISE READY

Voraussetzungen: drei Schritte bis zur Verbindung

Cloud MCP ist bewusst als Opt in gebaut. Nichts läuft, solange nicht drei Dinge erfüllt sind.
1. Organisation freischalten. Ein Admin aktiviert die Cloud MCP Integration auf der Integrations Seite der Organisation in Cypress Cloud. Ohne diesen Schalter findet der Agent keine Daten, egal wie sauber die lokale Konfiguration ist. Das ist die häufigste Ursache, wenn der Agent behauptet, es gebe keine Runs.
2. Authentifizieren. Jeder Nutzer meldet sich einzeln an, entweder über OAuth oder mit einem Personal Access Token. OAuth ist der empfohlene Weg: Browser Login, Session hält dreißig Tage, kein Token zum Rotieren. Aktive Sessions stehen im Cypress Cloud Profil und lassen sich dort jederzeit widerrufen.
3. KI Client konfigurieren. Der Client muss Tools und Remote Server über HTTP unterstützen. Die Server URL ist für alle gleich.
Code: 
          
https://mcp.cypress.io/mcp
Der Zugriff ist an deine Rolle und deine Rechte in der jeweiligen Organisation gebunden. Der Agent sieht genau die Projekte, die du auch selbst sehen darfst, und er kann nur lesen. Testcode ändern oder Runs löschen geht über Cloud MCP nicht.

Cypress Cloud MCP in OpenCode einrichten

Die offizielle Cypress Doku listet Antigravity, Claude Desktop, Claude Code, Cursor, GitHub Copilot und die Codex CLI. OpenCode fehlt dort, obwohl es Remote MCP Server nativ unterstützt und keinen Umweg über mcp-remote braucht. Hier ist die Konfiguration.
Die Datei liegt global unter ~/.config/opencode/opencode.json oder pro Projekt als opencode.json im Projektwurzelverzeichnis. Global ist für Cloud MCP meist die bessere Wahl, weil du in mehreren Repositories gegen dieselbe Organisation debuggst.
Code: 
          
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cypress": {
      "type": "remote",
      "url": "https://mcp.cypress.io/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}
Danach einmalig im Terminal authentifizieren. OpenCode erkennt die 401 Antwort zwar selbst und startet den Flow beim ersten Zugriff, der manuelle Trigger ist aber verlässlicher.
Code: 
          
opencode mcp auth cypress
opencode mcp list
Der Browser öffnet sich, du meldest dich bei Cypress Cloud an, OpenCode legt die Tokens unter ~/.local/share/opencode/mcp-auth.json ab. mcp list zeigt danach alle Server samt Auth Status.
Wer lieber mit einem Personal Access Token arbeitet, setzt oauth auf false. Ohne diesen Schalter versucht OpenCode trotz vorhandenem Header noch die automatische OAuth Erkennung.
Code: 
          
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cypress": {
      "type": "remote",
      "url": "https://mcp.cypress.io/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:CYPRESS_MCP_TOKEN}"
      }
    }
  }
}
Das Token erzeugst du im Cypress Cloud Profil unter MCP personal access token. Es wird genau einmal angezeigt. Leg es als Umgebungsvariable ab, nie direkt in eine Datei, die im Repository landet.
Code: 
          
export CYPRESS_MCP_TOKEN=dein-token
Hängt der Flow, hilft der Debug Befehl. Er zeigt Auth Status, testet die HTTP Verbindung und fährt die OAuth Discovery einmal durch.
Code: 
          
opencode mcp debug cypress
opencode mcp logout cypress

Setup für Claude Code, Cursor und VS Code

Claude Code braucht keine Konfigurationsdatei, ein Befehl reicht. Der Scope entscheidet über die Reichweite: user gilt projektübergreifend, local nur im aktuellen Projekt, project schreibt eine .mcp.json ins Repository und teilt die Konfiguration mit dem Team.
Code: 
          
claude mcp add cypress-cloud \
  https://mcp.cypress.io/mcp \
  --transport http \
  --scope user
Cursor liest die Server aus ~/.cursor/mcp.json. Beim ersten Zugriff öffnet sich der Browser für die Anmeldung.
Code: 
          
{
  "mcpServers": {
    "cypress": {
      "url": "https://mcp.cypress.io/mcp"
    }
  }
}
In VS Code mit GitHub Copilot liegt die Konfiguration in .vscode/mcp.json und nutzt einen leicht anderen Schlüssel. Hier heißt der Block servers, nicht mcpServers, und der Typ muss explizit gesetzt werden.
Code: 
          
{
  "servers": {
    "cypress": {
      "type": "http",
      "url": "https://mcp.cypress.io/mcp"
    }
  }
}
Die Codex CLI legt ihre MCP Server in ~/.codex/config.toml ab und teilt die Datei mit der IDE Erweiterung. Nach dem Hinzufügen folgt ein eigener Login Schritt mit codex mcp login cypress-cloud.

Die Tools: was der Agent abfragen kann

Nach der Verbindung stehen elf Tools bereit. Du rufst sie nicht selbst auf, der Agent wählt sie anhand deines Prompts. Neue Tools werden bei jedem Verbindungsaufbau automatisch mitgeladen.
Ein Teil der Tools funktioniert in jedem Plan, auch im kostenlosen. Andere brauchen die passenden Daten im Hintergrund: Flaky Test Reporting hängt am Plan, Accessibility und UI Coverage an den jeweiligen Produkt Abos. Fehlt das Abo, liefert das Tool schlicht nichts.

Cypress Cloud MCP Tools im Überblick

Tool Was es liefert Verfügbarkeit
cypress_get_projects Alle Projekte der Organisation samt projectId Jeder Plan
cypress_get_runs Run Zusammenfassungen nach Projekt, Run URL oder Git Branch, mit Status und Testzahlen Jeder Plan
cypress_get_failed_tests Testname, Spec, Fehlermeldung, Stack Trace und Test Replay Link je Versuch Jeder Plan
cypress_get_flaky_tests Die flakigen Tests eines Runs Planabhängig
cypress_get_accessibility_report Verstöße nach Schweregrad, fehlschlagende Regeln und die fünf schlimmsten Views Cypress Accessibility
cypress_get_accessibility_views Alle Views des Reports, sortiert nach Anzahl der Regelverstöße Cypress Accessibility
cypress_get_accessibility_rule_failures Betroffene DOM Elemente je Regel mit CSS Selektor und Meldung Cypress Accessibility
cypress_get_ui_coverage_report Coverage Score, getestete und ungetestete Elemente, riskanteste Views UI Coverage
cypress_get_ui_coverage_views Alle Views nach ungetesteten Elementen sortiert UI Coverage
cypress_get_ui_coverage_elements Interaktive Elemente eines Runs, filterbar nach getestet und ungetestet UI Coverage
submit_mcp_feedback Feedback direkt aus dem Agenten an Cypress Jeder Plan

Richtig prompten: drei Regeln aus der Praxis

Ein MCP Server allein macht noch keinen guten Debug Loop. Entscheidend ist, wie du fragst.
Werkzeug explizit nennen. Der Begriff Cypress Cloud im Prompt sorgt dafür, dass der Agent die richtigen Tools greift statt im Repository zu raten. Bei vielen aktiven MCP Servern ist das kein Kosmetikpunkt, sondern der Unterschied zwischen Antwort und Halluzination.
Kontext mitgeben. Dieser Branch, dieser Commit, oder direkt die Run URL einfügen. Je enger der Anker, desto weniger sucht der Agent.
Den Workflow definieren. Nicht nur fragen, was kaputt ist, sondern was passieren soll. Ein Prompt, der bis zum Fix denkt, spart die zweite Runde.
Vier Muster, die im Alltag tragen:
Health Check: Hol dir aus Cypress Cloud den letzten Run auf diesem Branch und fass die Fehlschläge zusammen.
Deep Debug: Such die fehlschlagenden Tests zu dieser Run URL, lies Stack Trace und lokalen Code und schlag einen Fix vor.
Flake Audit: Liste die flakigen Tests der letzten fünf Runs und prüf die Fehlermeldungen auf gemeinsame Muster.
Accessibility Triage: Zieh den Accessibility Report des letzten Runs, gruppier kritische und schwere Verstöße nach Regel und nenn die am stärksten betroffenen Views.
Prompts, die funktionieren, gehören nicht in den Chat Verlauf, sondern als Custom Instruction oder Skill ins Team. Dazu passt unser Glossareintrag zu SKILL.md.

Barrierefreiheit: der unterschätzte Teil von Cloud MCP

Drei der elf Tools drehen sich um Accessibility. Wer Cypress Accessibility einsetzt, bekommt damit einen Weg, Verstöße im Editor abzufragen statt sie in der Cloud durchzuklicken.
Der Report liefert Verstöße nach Schweregrad und die fehlschlagenden Regeln mit Elementanzahl. Darunter lässt sich weiter aufklappen: alle betroffenen Views, sortiert nach Anzahl der Regelverstöße, und je Regel die konkreten DOM Elemente mit CSS Selektor und Meldung. Ein Agent kann daraus eine Arbeitsliste bauen, die nach Wirkung sortiert ist und nicht nach Zufall.
Für Teams mit BFSG Pflichten ist das ein realer Hebel. Die Verstöße bleiben dieselben, aber der Weg von der Meldung zum Fix wird kürzer. Wer noch keine automatisierten Prüfungen fährt, findet bei uns die Grundlagen zu Axe DevTools und Cypress Accessibility Testing, zum Google Lighthouse Accessibility Audit und zu barrierefreien Überschriftenstrukturen.
Eine Warnung gehört dazu: Automatisierte Prüfungen finden einen Teil der Barrieren, nicht alle. Ein Agent, der den Report abarbeitet, ersetzt keinen Test mit Screenreader und keine Bewertung durch Menschen. Er räumt das auf, was Maschinen sicher erkennen, und schafft Zeit für den Rest.

Grenzen, Kontext und Datenschutz

Cloud MCP ist stark, aber kein Selbstläufer. Vier Punkte, die man vorher wissen sollte.
Das Limit. Hundert Tool Requests pro Stunde, in jedem Plan. Für interaktives Debugging reicht das locker. Wer einen Agenten über Nacht durch hunderte Runs schicken will, läuft dagegen.
Der Kontext. Elf Tools plus Beschreibungen belegen dauerhaft Platz im Context Window. Bei vielen aktiven MCP Servern summiert sich das. In OpenCode lässt sich das sauber lösen: global abschalten und nur für einen Debug Agenten aktivieren.
Code: 
          
{
  "tools": { "cypress_*": false },
  "agent": {
    "test-debug": {
      "tools": { "cypress_*": true }
    }
  }
}
Der rote CI Job. Ein fehlgeschlagener Pipeline Schritt heißt nicht, dass kein Run aufgezeichnet wurde. Das rote Ergebnis spiegelt nur den Exit Code. Solange Cypress den Run gemeldet hat, liegt er in der Cloud. Zeig dem Agenten Branch, Commit, Run Nummer oder Run URL, statt anzunehmen, es gäbe nichts zu finden. Die Run URL steht übrigens am Ende der Cypress Ausgabe, nicht am Anfang.
Die Daten. Cypress Cloud ist ein US Anbieter, die Testdaten liegen dort bereits. Cloud MCP ändert daran nichts, es öffnet nur einen Lesekanal auf denselben Bestand. Cypress bekommt die Eingaben des Tool Calls, nicht deinen Chat Verlauf und nicht den Kontext deines Agenten, und trainiert nach eigener Aussage keine Modelle darauf. Wer das komplett auf eigener Infrastruktur will, betreibt Cypress ohne Cloud und verliert dafür Test Replay, Flake Management und genau diesen MCP Server. Diesen Trade off sollte man bewusst treffen, nicht nebenbei.
Die Verbindung selbst bleibt lesend. Cloud MCP kann Testcode nicht ändern und Runs nicht löschen. Wer die Integration in der Organisation deaktiviert, sperrt sofort alle Nutzer aus, unabhängig davon, ob sie über OAuth oder Token verbunden waren.

Cloud MCP oder Cloud CLI: was wann passt

Cypress bietet zwei Wege an dieselben Daten. Beide sind in jedem Plan ohne Aufpreis enthalten, und viele Teams nutzen beide parallel.
Cloud MCP ist der Remote Server, den dein KI Client anspricht. Der Agent wählt die Tools selbst, passend zum Prompt. Das ist der richtige Weg fürs dialogische Debuggen im Editor.
Die Cloud CLI heißt cy-cloud, gibt JSON zurück und kommt direkt an Test Replay Daten. Sie passt für Skripte, eigene Tooling Ketten und für Agenten, die ohnehin über die Shell arbeiten. Wer im Terminal debuggt, fährt mit beiden zusammen am besten.

The moment you connect, your AI assistant stops guessing and starts knowing.

Emily Wisniewski, Cypress.io – Cypress Blog

Unsere Erfahrung mit Cypress und KI Agenten

Cypress mit Cypress Cloud ist bei uns kein Nebenschauplatz. Es ist die Absicherung für alles, was mit KI Unterstützung entsteht. Genau da liegt der Punkt: Je schneller Code geschrieben wird, desto wichtiger wird der Test, der ihn prüft. Wer Vise Coding mit Guardrails ernst nimmt, braucht E2E Tests, die in CI laufen und deren Ergebnisse jemand liest. Ein Agent, der diese Ergebnisse selbst abholt, schließt den Kreis.
In der Praxis heißt das: Der Agent schreibt einen Fix, die Pipeline läuft, der Agent liest sein eigenes Ergebnis und korrigiert nach. Ohne Cloud MCP hängt in dieser Kette immer ein Mensch, der Fehlermeldungen hin und her kopiert. Mit Cloud MCP bleibt der Mensch für die Entscheidung zuständig, nicht für den Transport.
Vertiefend passen dazu unsere Artikel zu KI Modellen für Entwickler im Vergleich, zum GitLab CLI als MCP Server, zu MCP RBAC für die Rechtevergabe an Agenten und zu Governed Agent Loops, wenn Agenten planbar arbeiten sollen statt einfach zu laufen.
CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.

NCA Vibe Coding Consulting

Roland Golla ist Entwickler aus Leidenschaft – seit über 20 Jahren. Er hat hunderte Projekte begleitet, von Legacy-Refactoring bis KI-Integration. Bei Vibe Coding verbindet er das Beste aus beiden Welten: Die Geschwindigkeit von KI-generiertem Code mit der Qualität professioneller Softwareentwicklung. Kein Bullshit, keine Agentur-Floskeln – direkte Hilfe von jemandem, der selbst täglich im Code steckt.

E-Mail Kontakt

Häufige Fragen zu Cypress Cloud MCP

Die Fragen, die uns zu Cloud MCP am häufigsten begegnen, kurz und direkt beantwortet.

Was kostet Cypress Cloud MCP 2026?

Nichts zusätzlich. Cloud MCP ist in jedem Cypress Cloud Plan enthalten, auch im kostenlosen Starter Plan. Voraussetzung ist nur, dass du deine Runs überhaupt in die Cloud aufzeichnest. Einzelne Tools brauchen allerdings die passenden Daten im Hintergrund: Flaky Test Reporting hängt am Plan, die Accessibility und UI Coverage Tools an den jeweiligen Produkt Abos.

Welche KI Clients unterstützen Cypress Cloud MCP 2026?

Jeder Client, der Remote MCP Server über HTTP und Tools unterstützt. Die offizielle Doku beschreibt Antigravity, Claude Desktop, Claude Code, Cursor, GitHub Copilot in VS Code, die Copilot CLI und die Codex CLI. OpenCode fehlt dort, funktioniert aber problemlos mit type remote und der Server URL, wie in dieser Anleitung beschrieben.

Wie richte ich Cypress Cloud MCP in OpenCode ein 2026?

Trag den Server in opencode.json unter mcp ein, mit type remote, der URL https://mcp.cypress.io/mcp und einem leeren oauth Objekt. Danach einmal opencode mcp auth cypress im Terminal ausführen. Der Browser öffnet sich für den Login, die Tokens landen lokal in mcp-auth.json. Mit opencode mcp list prüfst du, ob der Server verbunden ist.

Ist Cypress Cloud MCP DSGVO konform 2026?

Cypress Cloud ist ein US Anbieter, daran ändert Cloud MCP nichts. Die Testdaten liegen ohnehin dort, der MCP Server öffnet nur einen lesenden Zugang darauf. Cypress erhält die Eingaben des Tool Calls, nicht den Chat Verlauf, und trainiert nach eigener Aussage keine Modelle mit diesen Daten. Wer volle Datenhoheit braucht, verzichtet auf die Cloud und damit auch auf Cloud MCP.

Welche Tools bietet Cypress Cloud MCP 2026?

Elf Stück. Projekte auflisten, Runs abfragen, fehlgeschlagene Tests mit Stack Trace und Test Replay Link holen, flakige Tests identifizieren, dazu je drei Tools für Accessibility Reports und für UI Coverage sowie ein Feedback Tool. Du rufst keines davon selbst auf, der Agent wählt anhand deines Prompts aus.

Warum findet mein Agent keinen Run?

Meistens fehlt die Freischaltung in der Organisation. Ein Admin muss die Cloud MCP Integration in Cypress Cloud aktivieren. Zweithäufigste Ursache: Der Branchname in CI weicht von dem ab, den du dem Agenten nennst. Und drittens heißt ein roter CI Job nicht, dass kein Run existiert. Zeig dem Agenten die Run URL direkt.

OAuth oder Personal Access Token: was ist besser?

OAuth, wenn dein Client es kann. Kein Token zum Rotieren, keines, das versehentlich im Repository landet, und die Session hält dreißig Tage mit automatischer Erneuerung. Ein Token brauchst du nur, wenn der Client keinen browserbasierten Login unterstützt. Dann gehört es in eine Umgebungsvariable, niemals direkt in die Konfigurationsdatei.

Wie viele Anfragen sind pro Stunde erlaubt?

Hundert Tool Requests pro Stunde, in allen Plänen gleich. Für interaktives Debuggen reicht das deutlich. Eng wird es bei automatisierten Läufen, die viele Runs am Stück durcharbeiten. Wer mehr braucht, wendet sich an den Cypress Support. Zusätzlich gelten die üblichen Aufbewahrungsfristen deines Plans für die Testdaten.

Kann Cloud MCP meine Tests ändern?

Nein. Der Zugriff ist ausschließlich lesend und auf Datenabfrage ausgelegt. Testcode ändern oder Runs löschen ist nicht möglich. Zusätzlich gilt dein eigener Rechterahmen: Der Agent sieht genau die Projekte, auf die du in der Organisation Zugriff hast, nicht mehr.

Was unterscheidet Cloud MCP von der Cloud CLI?

Cloud MCP ist ein Remote Server für KI Clients, der Agent wählt die Tools selbst. Die Cloud CLI heißt cy-cloud, liefert JSON im Terminal und kommt direkt an Test Replay Daten. MCP passt zum Debuggen im Dialog, die CLI zu Skripten und Automatisierung. Beide sind kostenlos, viele Teams nutzen beide.

Wie wechsle ich vom Token zurück zu OAuth?

Entfern den Authorization Header beziehungsweise die Token Variable aus der Konfiguration deines Clients. In OpenCode setzt du oauth zusätzlich von false auf ein leeres Objekt. Nach dem Speichern und Neuverbinden erkennt der Client, dass kein Token vorliegt, und startet den Browser Login automatisch.

Brauche ich eine bestimmte Cypress Version?

Nein, eine Mindestversion der Cypress App gibt es nicht. Entscheidend ist allein, dass deine Runs in Cypress Cloud aufgezeichnet werden und die Integration für die Organisation freigeschaltet ist. Cloud MCP liest die Daten, die dort ohnehin liegen, und greift nicht in den lokalen Testlauf ein.