• LOGS
  • VISUALS
  • TRIAGE
  • HUMAN

How to debug failed test instances with your AI

Connect Cypress Cloud to your agent to stop hunting for failure details. Once connected, your AI handles the heavy lifting of gathering evidence for every broken spec.

Ask AI about this page

Short answer

How can I debug failed Cypress tests using AI?

Your agent uses the Cypress Cloud connection to grab the exact error messages, screenshots, and video URLs for any failed spec. You get a direct line to the failure data without manual searching. Here is how the process works.

Debugging outcomes

Where your failure data lands.

The AI organizes failure information into actionable categories.

LOGS

Error message retrieval

The agent pulls the specific stack trace and error text for a failed run. You get the exact reason the test died immediately.

VISUALS

Media evidence

Your AI finds the direct links to screenshots and videos of the failure. You can view the exact moment the UI broke.

TRIAGE

Failure identification

The agent identifies which specific spec instances failed within a run. This helps you isolate flaky tests from real regressions.

HUMAN

Manual code fixes

The AI provides the data, but you still need to open your IDE to apply the fix. The agent won't rewrite your test code for you.

The workflow

What your AI does when a test fails.

Instead of you clicking through the Cypress dashboard, your agent performs the lookup for you.

  1. Locate failures

    The agent scans your recent runs to find which tests didn't pass.

    get_tests

  2. Fetch instance data

    Once a failure is identified, the agent pulls the specific details for that exact test run.

    get_instance

  3. Extract evidence

    The agent pulls the error logs and media links from the instance data.

    get_instance

  4. Present findings

    The agent delivers the error text and video URLs directly in your chat interface.

    get_instanceget_tests

Try it

Copy these to start.

Use these prompts to trigger the debugging process.

Starting points

These are starting points. Swap out the specific run IDs or spec names with your actual data.

Cypress Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_IKhVCeL6avFJPY6iQ838105q3zZBtwMa7WMfyaRI/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Cypress capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "cypress-cloud-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_IKhVCeL6avFJPY6iQ838105q3zZBtwMa7WMfyaRI/mcp"
    }
  }
}
Copy into chat04

  • Show me the error messages for the failed tests in my last Cypress run.

  • Find the video URL and screenshot for the failed 'login_spec.js' instance.

  • List all the failed spec instances from the most recent run in my Cypress Cloud project.

  • Why did the 'checkout_flow' test fail in the last run? Get the error details.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Cypress Cloud once, then ask.

One connection gives your agent access to your test data. Your credentials stay encrypted and secure on our end.

Connect Cypress Cloud to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix my broken tests automatically?

    No. The AI retrieves the error logs and media so you can see what happened, but you must perform the code changes yourself.

  • 02

    Can the AI delete failed test runs from Cypress Cloud?

    No. The tools only allow the agent to read data from your instances and tests. It cannot modify or delete anything in your account.

  • 03

    Does the AI need my Cypress Cloud password?

    No. You connect via the Vinkius platform, which manages the connection securely without exposing your raw credentials to the agent.

  • 04

    Can I ask for videos of specific tests?

    Yes, if the test run captured a video, the agent can retrieve the URL for you.

  • 05

    Can the AI run new tests?

    No. This connector is for retrieving data from existing runs, not for triggering new test executions.

  • More questions about Cypress Cloud? See everything the Cypress Cloud Connector can do

Connect Cypress to Claude, Cursor, ChatGPT & more