Cypress Cloud MCP — Claude Code MCP server: setup guide
Connects your coding agent to Cypress Cloud to pull test run outcomes and accessibility summaries. Helpful when debugging failed test suites directly in your editor.
claude mcp add --transport http cypress-cloud https://mcp.cypress.io/mcpWhat Cypress Cloud MCP does
Coding agents cannot inspect remote CI results on their own. Cypress Cloud MCP connects Claude Code and supported IDEs to your testing cloud through the remote endpoint https://mcp.cypress.io/mcp. Your assistant reads test execution health and failure details without context switching.
Setup runs over an HTTP transport. Authentication uses OAuth by default, though you can configure a Personal Access Token in your agent's .mcp.json file. Headless terminal workflows fail on browser authentication unless you supply this token beforehand.
What it helps with
- fetch test run outcomes and error traces directly in the editor
- check build stability without opening a web browser
- inspect component accessibility reports from recent runs
- diagnose broken tests using fresh Cypress Cloud logs
Example prompts for the agent
- Show the latest failing tests from Cypress Cloud and their errors
- Check the build health of our latest run on branch
main - Retrieve the accessibility summary from the most recent test run
How to install Cypress Cloud MCP
Platform CLI: remote server
claude mcp add --transport http cypress-cloud https://mcp.cypress.io/mcpPlatform CLI: remote server
codex mcp add cypress-cloud-mcp --url https://mcp.cypress.io/mcpConfig file
{
"mcpServers": {
"cypress-cloud-mcp": {
"url": "https://mcp.cypress.io/mcp"
}
}
}Config file
{
"servers": {
"cypress-cloud-mcp": {
"type": "http",
"url": "https://mcp.cypress.io/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http cypress-cloud-mcp https://mcp.cypress.io/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Cypress Cloud MCP
How to install Cypress Cloud MCP in Claude Code?
Run claude mcp add --transport http cypress-cloud https://mcp.cypress.io/mcp in your terminal.
What does Cypress Cloud MCP do?
It provides your AI assistant with direct access to Cypress Cloud test results, failure logs, and accessibility audit data.
How do I authenticate without OAuth?
You can replace the default OAuth flow by adding a Personal Access Token (PAT) directly to your agent's .mcp.json configuration file.
