{ "doc": { "id": "cloud/integrations/cloud-mcp", "title": "Cloud MCP | Cypress Documentation", "description": "Give AI coding assistants real-time access to your Cypress test results.", "section": "cloud", "source_path": "/llm/markdown/cloud/integrations/cloud-mcp.md", "version": "6a908a532b1fca4ed18538a4c1c5a9bc7f24f403", "updated_at": "2026-05-01T19:25:18.656Z", "headings": [ { "id": "cloud/integrations/cloud-mcp#cloud-mcp-agentic-debugging-beta", "text": "Cloud MCP: Agentic Debugging Beta", "level": 1 }, { "id": "cloud/integrations/cloud-mcp#how-it-works", "text": "How it Works", "level": 2 }, { "id": "cloud/integrations/cloud-mcp#configuring-the-cloud-mcp", "text": "Configuring the Cloud MCP", "level": 2 }, { "id": "cloud/integrations/cloud-mcp#enable-for-organization", "text": "Enable for Organization", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#generate-personal-access-token", "text": "Generate personal access token", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#configure-ai-assistant", "text": "Configure AI Assistant", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#available-tools", "text": "Available tools", "level": 2 }, { "id": "cloud/integrations/cloud-mcp#writing-effective-prompts", "text": "Writing effective prompts", "level": 2 }, { "id": "cloud/integrations/cloud-mcp#example-prompts", "text": "Example Prompts", "level": 2 }, { "id": "cloud/integrations/cloud-mcp#the-health-check", "text": "The Health Check", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#the-deep-debug", "text": "The Deep Debug", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#the-flake-audit", "text": "The Flake Audit", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#the-accessibility-triage", "text": "The Accessibility Triage", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#faqs", "text": "FAQs", "level": 2 }, { "id": "cloud/integrations/cloud-mcp#troubleshooting", "text": "Troubleshooting", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#pricing-availability", "text": "Pricing & Availability", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#usage-limits", "text": "Usage Limits", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#security-privacy", "text": "Security & Privacy", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#remove-the-integration", "text": "Remove the integration", "level": 3 }, { "id": "cloud/integrations/cloud-mcp#send-feedback", "text": "Send feedback", "level": 2 }, { "id": "cloud/integrations/cloud-mcp#also-see", "text": "Also See", "level": 2 } ] }, "content": { "type": "root", "children": [ { "type": "heading", "depth": 1, "children": [ { "type": "text", "value": "Cloud MCP: Agentic Debugging Beta" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Cypress Cloud's Model Context Protocol (MCP) server connects your AI coding assistants directly to Cypress Cloud, giving them a window into your application's health and stability." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "By eliminating the context gap between CI and your editor, you remove the manual triage that makes testing a bottleneck. Cloud MCP gives your AI agent real-time access to your test results. It allows agents to query run statuses, identify flaky tests, and retrieve failure details—including Test Replay links—directly within your agentic workflow." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "How it Works" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "The " }, { "type": "link", "title": null, "url": "https://modelcontextprotocol.io/", "children": [ { "type": "text", "value": "Model Context Protocol (MCP)" } ] }, { "type": "text", "value": " is an open standard that enables AI models to safely access external data and tools." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Think of MCP as the \"USB port\" for AI. Just as a USB port allows any peripheral to connect to any computer, MCP allows your AI assistant (the Host) to plug into Cypress Cloud (the Server) to fetch real-time context." } ] }, { "type": "list", "ordered": true, "start": 1, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "The Host: Your AI client (like Cursor, Claude Desktop, or VS Code)." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "The Server: A remote service hosted by Cypress that retrieves Cloud data for the AI." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "The Connection: A secure pipe authenticated by your personal access token." } ] } ] } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Configuring the Cloud MCP" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "To use the Cloud MCP:" } ] }, { "type": "list", "ordered": true, "start": 1, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Enable integration: An admin will need to enable the integration for your organization" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Generate personal access token: Each user will need to create a personal access token to authenticate with Cloud MCP" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Configure AI: Each user will need to add the remote MCP configuration to their preferred AI client" } ] } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Enable for Organization" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Enable the Cloud MCP integration for your organization from the Integrations page for your organization." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Each user who wants to use Cloud MCP must then generate a personal access token to authenticate." } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Generate personal access token" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "A personal access token (PAT) is used to securely connect with Cypress Cloud through the Cloud MCP server. You create and manage your PAT from your Cypress Cloud profile." } ] }, { "type": "list", "ordered": true, "start": 1, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Sign in to " }, { "type": "link", "title": null, "url": "https://cloud.cypress.io", "children": [ { "type": "text", "value": "Cypress Cloud" } ] }, { "type": "text", "value": "." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "In the upper-left corner of any page, click your organization picture." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Select " }, { "type": "link", "title": null, "url": "https://cloud.cypress.io/profile", "children": [ { "type": "text", "value": "Manage Profile" } ] }, { "type": "text", "value": "." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Under MCP personal access token, click Generate token." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Select an expiration for the token and click Continue." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Your token is generated. Copy it immediately — it is only shown once." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "The token access is scoped to your role and permissions in each MCP-enabled organization" } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Configure AI Assistant" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Configure your agent or AI client to connect to Cloud MCP. Cloud MCP is a remote server hosted by Cypress, so your client must support tools and remote server (HTTP) connections." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "The remote url is: `https://mcp.cypress.io/mcp`. Set the authorization header with `Bearer CYPRESS_MCP_PAT`." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Antigravity" } ] }, { "type": "list", "ordered": true, "start": 1, "spread": true, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Open the MCP store via the \"...\" dropdown at the top of the editor's agent panel." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Click on Manage MCP Servers" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Click on View raw config" } ] } ] }, { "type": "listItem", "spread": true, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modify the `mcp_config.json` with your custom MCP server configuration." } ] }, { "type": "code", "lang": null, "meta": null, "value": "{ \"mcpServers\": { \"cypress-cloud\": { \"serverUrl\": \"https://mcp.cypress.io/mcp\", \"headers\": { \"Authorization\": \"Bearer YOUR_MCP_TOKEN\" } } }}" } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Replace `YOUR_MCP_TOKEN` with your personal access token." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Save `mcp_config.json` and click Refresh" } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "See " }, { "type": "link", "title": null, "url": "https://antigravity.google/docs/mcp", "children": [ { "type": "text", "value": "Antigravity's documentation" } ] }, { "type": "text", "value": " for more details." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Claude Desktop" } ] }, { "type": "list", "ordered": true, "start": 1, "spread": true, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Open Claude Desktop." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Go to Settings > Developer > Edit Config." } ] } ] }, { "type": "listItem", "spread": true, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Add the following to your `claude_desktop_config.json`:" } ] }, { "type": "code", "lang": null, "meta": null, "value": "{ \"mcpServers\": { \"Cypress Cloud\": { \"command\": \"npx\", \"args\": [ \"-y\", \"mcp-remote@latest\", \"https://mcp.cypress.io/mcp\", \"--header\", \"Authorization: Bearer ${CYPRESS_MCP_TOKEN}\" ], \"env\": { \"CYPRESS_MCP_TOKEN\": \"YOUR_MCP_TOKEN\" } } }}" } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Replace `YOUR_MCP_TOKEN` with your personal access token." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Restart Claude Desktop after saving. You should see a tools indicator in the chat input." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "See " }, { "type": "link", "title": null, "url": "https://code.claude.com/docs/en/mcp", "children": [ { "type": "text", "value": "Claude's documentation" } ] }, { "type": "text", "value": " for more details. Note: `mcp-remote` requires Node.js v20+ in the path to run successfully." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Claude Code (CLI)" } ] }, { "type": "list", "ordered": true, "start": 1, "spread": true, "children": [ { "type": "listItem", "spread": true, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Add the Cloud MCP like:" } ] }, { "type": "code", "lang": null, "meta": null, "value": "claude mcp add cypress-cloud \\ https://mcp.cypress.io/mcp \\ --transport http \\ --header \"Authorization: Bearer YOUR_MCP_TOKEN\"" } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Replace `YOUR_MCP_TOKEN` with your personal access token." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Note: CLI Scope options are" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "`--scope user` — available across all projects (recommended)" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "`--scope local` — current project only (default)" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "`--scope project` — shared via `.mcp.json` in project root" } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "See " }, { "type": "link", "title": null, "url": "https://code.claude.com/docs/en/mcp", "children": [ { "type": "text", "value": "Claude Code's documentation" } ] }, { "type": "text", "value": " for more details." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Cursor" } ] }, { "type": "list", "ordered": true, "start": 1, "spread": true, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Open Cursor" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Open the \"Settings\" menu and select \"Cursor Settings\"" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Select \"Tools & MCPs\"" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Select \"New MCP Sever\"" } ] } ] }, { "type": "listItem", "spread": true, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Add the following to your `~/.cursor/mcp.json`:" } ] }, { "type": "code", "lang": null, "meta": null, "value": "{ \"mcpServers\": { \"cypress\": { \"url\": \"https://mcp.cypress.io/mcp\", \"headers\": { \"Authorization\": \"Bearer YOUR_MCP_TOKEN\" } } }}" } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Replace `YOUR_MCP_TOKEN` with your personal access token." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Save the file and restart Cursor." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "See " }, { "type": "link", "title": null, "url": "https://cursor.com/docs/mcp", "children": [ { "type": "text", "value": "Cursor's documentation" } ] }, { "type": "text", "value": " for more details." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "GitHub Copilot in VS Code" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "You can install the Cloud MCP server in your user profile or a specific workspace. See " }, { "type": "link", "title": null, "url": "https://code.visualstudio.com/docs/copilot/customization/mcp-servers", "children": [ { "type": "text", "value": "VS Code's MCP installation options" } ] }, { "type": "text", "value": "." } ] }, { "type": "list", "ordered": true, "start": 1, "spread": true, "children": [ { "type": "listItem", "spread": true, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Add the following to your `.vscode/mcp.json`:" } ] }, { "type": "code", "lang": null, "meta": null, "value": "{ \"servers\": { \"cypress\": { \"type\": \"http\", \"url\": \"https://mcp.cypress.io/mcp\", \"headers\": { \"Authorization\": \"Bearer ${input:CYPRESS_MCP_TOKEN}\" } } }, \"inputs\": [ { \"type\": \"promptString\", \"id\": \"CYPRESS_MCP_TOKEN\", \"description\": \"Enter your Cypress MCP personal access token\", \"password\": true } ]}" } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "VS Code will prompt for your PAT via the `CYPRESS_MCP_TOKEN` input when connecting." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "See " }, { "type": "link", "title": null, "url": "https://code.visualstudio.com/docs/copilot/customization/mcp-servers", "children": [ { "type": "text", "value": "VS Code's documentation" } ] }, { "type": "text", "value": " for more details." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "GitHub Copilot CLI" } ] }, { "type": "list", "ordered": true, "start": 1, "spread": true, "children": [ { "type": "listItem", "spread": true, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Add the following to your global config (`~/.copilot/mcp-config.json`) or project config (`.copilot/mcp-config.json`):" } ] }, { "type": "code", "lang": null, "meta": null, "value": "{ \"mcpServers\": { \"Cypress Cloud\": { \"type\": \"http\", \"url\": \"https://mcp.cypress.io/mcp\", \"headers\": { \"Authorization\": \"Bearer ${CYPRESS_MCP_TOKEN}\" } } }}" } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Set the Environment Variable: Before launching the CLI, ensure the token is exported in your terminal, replacing `YOUR_MCP_TOKEN` with your personal access token." } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "macOS/Linux: `export CYPRESS_MCP_TOKEN=YOUR_MCP_TOKEN`" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Windows (Powershell): `$env:CYPRESS_MCP_TOKEN=\"YOUR_MCP_TOKEN\"`" } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Verify the connection. Run `/mcp` show inside the Copilot CLI to confirm the server is loaded and the variable is resolved." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "See " }, { "type": "link", "title": null, "url": "https://docs.github.com/en/copilot/how-tos/copilot-cli/use-copilot-cli-agents/overview", "children": [ { "type": "text", "value": "GitHub Copilot's documentation" } ] }, { "type": "text", "value": " for more details." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "OpenAI Codex CLI" } ] }, { "type": "list", "ordered": true, "start": 1, "spread": true, "children": [ { "type": "listItem", "spread": true, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Add the following to `~/.codex/config.toml` (shared between CLI and Codex IDE extension):" } ] }, { "type": "code", "lang": null, "meta": null, "value": "[mcp_servers.cypress-cloud]url = \"https://mcp.cypress.io/mcp\"bearer_token_env_var = \"CYPRESS_MCP_TOKEN\"" } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Set your token in your environment:" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "macOS/Linux: `export CYPRESS_MCP_TOKEN=YOUR_MCP_TOKEN`" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Windows (Powershell): `$env:CYPRESS_MCP_TOKEN=\"YOUR_MCP_TOKEN\"`" } ] } ] } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "See " }, { "type": "link", "title": null, "url": "https://developers.openai.com/codex/mcp", "children": [ { "type": "text", "value": "Codex's documentation" } ] }, { "type": "text", "value": " for more details." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "If you use an AI client not listed here, refer to its documentation for configuring a remote MCP connection." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Available tools" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Once connected, your AI agent can autonomously use the following tools. You don't call these manually; the agent selects them based on your prompt." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Each time the Cloud MCP connection is established, any new tools become immediately available." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Some tools are relevant for all Cypress Cloud plans (including free), but some others are for plan-specific data like flaky test reporting, or product-specific data like Cypress Accessibility violation details. These are only available if your organization has subscriptions for the plans and products that would provide the underlying data." } ] }, { "type": "table", "align": [ null, null, null ], "children": [ { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Tool" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Capability" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Best Use Case" } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "`cypress_get_projects`" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Lists all projects in your Org." } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Helping the agent find the correct `projectId` for subsequent queries." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "`cypress_get_runs`" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Returns run summaries for a project, run URL, or git branch. Summaries include project name, run number, status, run URL, tags, and test status counts." } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "\"Check the status of the last CI run on main\"" } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "`cypress_get_failed_test_details`" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Retrieves attempt details: test name, spec, attempt error and stack trace, and a Test Replay link for quick debugging. Does not return test artifacts." } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "\"Analyze why the checkout test failed in the latest run.\"" } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "`cypress_get_flaky_tests`" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Identifies the flaky tests in a run." } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "\"Are these failures regressions or known flakiness?\"" } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "`cypress_get_accessibility_report`" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Returns a high-level accessibility report for a run: violation counts by severity, failing rules with element counts, and the top 5 views sorted by failure count." } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "\"Summarize accessibility violations for the latest run on this branch.\"" } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "`cypress_get_accessibility_views`" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Returns paginated views from an accessibility report, sorted by number of failing rules. Use to browse all views beyond the top 5 in the report summary." } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "\"Which pages have the most accessibility failures in this run?\"" } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "`cypress_get_accessibility_rule_failures`" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Returns paginated failing DOM elements for a specific accessibility rule, with CSS selector, view, and failure message. Optionally scope to a specific view." } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "\"Show me all color-contrast failures on the checkout page.\"" } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "`cypress_feedback`" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Shares feedback with Cypress directly from your agentic environment." } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "\"Report a bug or request a new MCP feature.\"" } ] } ] } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Writing effective prompts" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "To get the most out of Cloud MCP, follow these three principles:" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Trigger Explicitly: Use the phrase \"Cypress Cloud\" to ensure the agent looks for the correct MCP tools." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Provide Context: Mention \"this branch,\" \"this commit,\" or paste a Run URL directly." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Define the Workflow: Don't just ask what failed; ask the agent to fix it." } ] } ] } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Example Prompts" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Pro-Tip: If you find a workflow that works well, save it as a Custom Instruction or Skill in your AI client to standardize debugging for your entire team." } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "The Health Check" } ] }, { "type": "blockquote", "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "\"Check Cypress Cloud for the latest run on this branch. Give me a high-level summary of any failures.\"" } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "The Deep Debug" } ] }, { "type": "blockquote", "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "\"Find the failing tests for [Run URL]. For each failure, look at the stack trace, check my local code, and propose a fix to stop the regression.\"" } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "The Flake Audit" } ] }, { "type": "blockquote", "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "\"List all flaky tests from the last 5 runs in Cypress Cloud. Are there any common patterns in the error messages?\"" } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "The Accessibility Triage" } ] }, { "type": "blockquote", "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "\"Pull the Cypress Cloud Accessibility report for the latest run on this branch. List any critical or serious violations grouped by rule, and tell me which views are most impacted.\"" } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "For more a deeper exploration of working with Cloud MCP's accessibility tools, read our guide " }, { "type": "link", "title": null, "url": "/llm/markdown/accessibility/work-with-ai-agents.md", "children": [ { "type": "text", "value": "Cypress Accessibility - Work with AI agents" } ] }, { "type": "text", "value": "." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "FAQs" } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Troubleshooting" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Agent can't find your run:" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Verify the organization has the Cloud MCP integration enabled in Cypress Cloud." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Ensure your Git branch name in CI matches the branch name you're telling the AI." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Connection errors:" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Verify your PAT hasn't expired (check Manage Profile)." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Check firewall and proxy settings to ensure " }, { "type": "link", "title": null, "url": "https://mcp.cypress.io", "children": [ { "type": "text", "value": "https://mcp.cypress.io" } ] }, { "type": "text", "value": " is allowlisted." } ] } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Pricing & Availability" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Cloud MCP is available for free to all Cypress Cloud plans, including the Starter plan. We believe AI-assisted debugging should be accessible to every developer building with Cypress." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "No minimum Cypress App version is required to get started." } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Usage Limits" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Current limits include 100 tool requests per hour for all plans." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Cloud MCP data availability matches existing test recording limits and data retention policies for your plan." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "If you need to increase your limits, contact support at " }, { "type": "link", "title": null, "url": "mailto:support@cypress.io", "children": [ { "type": "text", "value": "support@cypress.io" } ] }, { "type": "text", "value": "." } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Security & Privacy" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Read-Only Access: The Cloud MCP server is designed for data retrieval and debugging. It cannot modify your test code or delete runs." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "User-Scoped: The AI only sees the projects and data that your specific Cypress Cloud user has permission to access. Whether you're part of a specific team or just have access to certain projects, your AI assistant stays within those same boundaries." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Local Control: You control exactly when the server is active by managing the configuration in your local AI client." } ] } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Remove the integration" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Remove the Cloud MCP integration at any time by going to the Integrations page for your organization and selecting Disable in the Cypress MCP section." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Disabling the integration immediately prevents any users who have previously generated a PAT from accessing data for that organization." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Send feedback" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "You can share feedback directly through your agent:" } ] }, { "type": "blockquote", "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "\"Send Cypress the following feedback: [Your message here]\"" } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Alternatively, use " }, { "type": "link", "title": null, "url": "https://share.hsforms.com/2NWNpyi5KSZmG4x0geIXgBg3a4za", "children": [ { "type": "text", "value": "this feedback form" } ] }, { "type": "text", "value": " to share any feedback, use cases, or issues encountered with your prompts and queries." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Also See" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "link", "title": null, "url": "/llm/markdown/cloud/features/recorded-runs.md", "children": [ { "type": "text", "value": "Recording Cloud Runs" } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "link", "title": null, "url": "/llm/markdown/cloud/features/cypress-ai-features.md", "children": [ { "type": "text", "value": "Cypress AI" } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "link", "title": null, "url": "/llm/markdown/api/commands/prompt.md", "children": [ { "type": "text", "value": "cy.prompt()" } ] } ] } ] } ] } ] }, "token_estimate": 2571 }