{
  "doc": {
    "id": "cloud/integrations/cloud-mcp",
    "title": "Cypress Cloud MCP: Agentic debugging",
    "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": "fbc9225067c51c52ee13224e3b702cf8a025ec12",
    "updated_at": "2026-08-14T12:36:26.878Z",
    "headings": [
      {
        "id": "cloud/integrations/cloud-mcp#cloud-mcp-agentic-debugging",
        "text": "Cloud MCP: Agentic Debugging",
        "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#authenticate",
        "text": "Authenticate",
        "level": 3
      },
      {
        "id": "cloud/integrations/cloud-mcp#oauth-recommended",
        "text": "OAuth (Recommended)",
        "level": 4
      },
      {
        "id": "cloud/integrations/cloud-mcp#personal-access-token",
        "text": "Personal Access Token",
        "level": 4
      },
      {
        "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#the-ui-coverage-triage",
        "text": "The UI Coverage Triage",
        "level": 3
      },
      {
        "id": "cloud/integrations/cloud-mcp#faqs",
        "text": "FAQs",
        "level": 2
      },
      {
        "id": "cloud/integrations/cloud-mcp#cloud-mcp-vs-the-cloud-cli",
        "text": "Cloud MCP vs the Cloud CLI",
        "level": 3
      },
      {
        "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
      }
    ]
  },
  "chunks": [
    {
      "id": "cloud/integrations/cloud-mcp#how-it-works",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "How it Works",
      "heading_level": 2,
      "content_markdown": "## How it Works\n\nThe [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard that enables AI models to safely access external data and tools.\n\nThink 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.\n\n1.  **The Host:** Your AI client (like Cursor, Claude Desktop, or VS Code).\n2.  **The Server:** A remote service hosted by Cypress that retrieves Cloud data for the AI.\n3.  **The Connection:** A secure pipe authenticated via OAuth (recommended) or a personal access token.\n",
      "section": "cloud",
      "anchors": [
        "how-it-works"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 144
    },
    {
      "id": "cloud/integrations/cloud-mcp#configuring-the-cloud-mcp",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Configuring the Cloud MCP",
      "heading_level": 2,
      "content_markdown": "## Configuring the Cloud MCP\n\nTo use the Cloud MCP:\n\n1.  **Enable integration:** An admin will need to enable the integration for your organization\n2.  **Authenticate:** Each user authenticates with Cypress Cloud — via OAuth (recommended) or a personal access token\n3.  **Configure AI:** Each user will need to add the remote MCP configuration to their preferred AI client\n\n### Enable for Organization\n\nEnable the Cloud MCP integration for your organization from the **Integrations** page for your organization.\n\nEach user who wants to use Cloud MCP must then authenticate — using OAuth or a personal access token.\n\n### Authenticate\n\nThere are two options for authenticating the Cloud MCP server with your Cloud account: oauth (recommended) and a personal access token (PAT).\n\n#### OAuth (Recommended)\n\nOAuth is the recommended authentication method for Cloud MCP. It uses a browser-based sign-in flow, so no manual token generation or rotation is needed — your AI client manages the session automatically.\n\nWhen you configure your AI client with the Cloud MCP server URL (`https://mcp.cypress.io/mcp`) and your client supports OAuth, it will:\n\n1.  Detect that the server requires authentication via OAuth discovery.\n2.  Open a browser window and redirect you to the Cypress Cloud sign-in page.\n3.  After you sign in, the client stores the session securely and reconnects automatically for 30 days.\n\nOAuth sessions are scoped to your Cypress Cloud user account and respect your existing role and permissions in each MCP-enabled organization. No token expiry management is required on your part.\n\nYour active OAuth sessions are visible on your **[Manage Profile](https://cloud.cypress.io/profile)** page. You can revoke any session from there at any time.\n\nIf your AI client does not support OAuth, use a [personal access token](#Personal-Access-Token) instead.\n\n#### Personal Access Token\n\nA personal access token (PAT) can used to securely connect with Cypress Cloud through the Cloud MCP server. You create and manage your PAT from your Cypress Cloud profile.\n\n1.  Sign in to [Cypress Cloud](https://cloud.cypress.io).\n2.  In the upper-left corner of any page, click your organization picture.\n3.  Select **[Manage Profile](https://cloud.cypress.io/profile)**.\n4.  Under **MCP personal access token**, click **Generate token**.\n5.  Select an expiration for the token and click **Continue**.\n6.  Your token is generated. Copy it immediately — it is only shown once.\n\nThe token access is scoped to your role and permissions in each MCP-enabled organization. Use your PAT in place of OAuth when your AI client does not support browser-based authentication flows.\n\n### Configure AI Assistant\n\nConfigure 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.\n\nThe remote URL is: `https://mcp.cypress.io/mcp`. Clients that support OAuth will handle authentication automatically via a browser sign-in. For clients that do not support OAuth, set the authorization header with `Bearer YOUR_MCP_TOKEN` using your personal access token.\n\nAntigravity\n\n**OAuth (Recommended)**\n\n1.  Open the MCP store via the \"...\" dropdown at the top of the editor's agent panel.\n2.  Click on **Manage MCP Servers**\n3.  Click on **View raw config**\n4.  Modify the `mcp_config.json` with your custom MCP server configuration.\n    \n    ```\n    {  \"mcpServers\": {    \"cypress-cloud\": {      \"serverUrl\": \"https://mcp.cypress.io/mcp\"    }  }}\n    ```\n    \n5.  Save `mcp_config.json` and click Refresh. Antigravity will prompt you to sign in to Cypress Cloud via your browser.\n\n**Personal Access Token (Alternative)**\n\n1.  Follow steps 1–3 above.\n2.  Modify the `mcp_config.json` to include your token:\n    \n    ```\n    {  \"mcpServers\": {    \"cypress-cloud\": {      \"serverUrl\": \"https://mcp.cypress.io/mcp\",      \"headers\": {        \"Authorization\": \"Bearer YOUR_MCP_TOKEN\"      }    }  }}\n    ```\n    \n3.  Replace `YOUR_MCP_TOKEN` with your personal access token.\n4.  Save `mcp_config.json` and click Refresh.\n\nSee [Antigravity's documentation](https://antigravity.google/docs/mcp) for more details.\n\nClaude Desktop\n\n**OAuth (Recommended)**\n\n1.  Open Claude Desktop.\n2.  Click Customize\n3.  Click Connectors\n4.  Click the + icon and select 'Add custom connector'\n5.  Add the connector name, i.e `cypress-cloud`\n6.  Add remote MCP url `https://mcp.cypress.io/mcp`\n7.  Click add\n8.  Click connect to authn\n\n**Personal Access Token (Alternative)**\n\n1.  Open Claude Desktop.\n2.  Go to Settings > Developer > Edit Config.\n3.  Add the following to your `claude_desktop_config.json`:\n    \n    ```\n    {  \"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\"      }    }  }}\n    ```\n    \n4.  Replace `YOUR_MCP_TOKEN` with your personal access token.\n5.  Restart Claude Desktop after saving. You should see a tools indicator in the chat input.\n\nSee [Claude's documentation](https://code.claude.com/docs/en/mcp) for more details. Note: `mcp-remote` requires Node.js v20+ in the path to run successfully.\n\nClaude Code (CLI)\n\n**OAuth (Recommended)**\n\n1.  Add the Cloud MCP server:\n    \n    ```\n    claude mcp add cypress-cloud \\  https://mcp.cypress.io/mcp \\  --transport http\n    ```\n    \n2.  Start claude session `claude`\n    \n3.  Prompt `mcp cypress`\n    \n4.  Claude Code will open a browser window to sign in to Cypress Cloud\n    \n\n**Personal Access Token (Alternative)**\n\n1.  Add the Cloud MCP server with your token:\n    \n    ```\n    claude mcp add cypress-cloud \\  https://mcp.cypress.io/mcp \\  --transport http \\  --header \"Authorization: Bearer YOUR_MCP_TOKEN\"\n    ```\n    \n2.  Replace `YOUR_MCP_TOKEN` with your personal access token.\n    \n\n**Note:** CLI Scope options are\n\n*   `--scope user` — available across all projects (recommended)\n*   `--scope local` — current project only (default)\n*   `--scope project` — shared via `.mcp.json` in project root\n\nSee [Claude Code's documentation](https://code.claude.com/docs/en/mcp) for more details.\n\nCursor\n\n**OAuth (Recommended)**\n\n1.  Open Cursor\n2.  Open the \"Settings\" menu and select \"Cursor Settings\"\n3.  Select \"Tools & MCPs\"\n4.  Select \"New MCP Server\"\n5.  Add the following to your `~/.cursor/mcp.json`:\n    \n    ```\n    {  \"mcpServers\": {    \"cypress\": {      \"url\": \"https://mcp.cypress.io/mcp\"    }  }}\n    ```\n    \n6.  Save the file and restart Cursor. Cursor will open a browser window to sign in to Cypress Cloud on first use.\n\n**Personal Access Token (Alternative)**\n\n1.  Follow steps 1–4 above.\n2.  Add the following to your `~/.cursor/mcp.json`:\n    \n    ```\n    {  \"mcpServers\": {    \"cypress\": {      \"url\": \"https://mcp.cypress.io/mcp\",      \"headers\": {        \"Authorization\": \"Bearer YOUR_MCP_TOKEN\"      }    }  }}\n    ```\n    \n3.  Replace `YOUR_MCP_TOKEN` with your personal access token.\n4.  Save the file and restart Cursor.\n\nSee [Cursor's documentation](https://cursor.com/docs/mcp) for more details.\n\nGitHub Copilot in VS Code\n\nYou can install the Cloud MCP server in your user profile or a specific workspace. See [VS Code's MCP installation options](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).\n\n**OAuth (Recommended)**\n\n1.  Add the following to your `.vscode/mcp.json`:\n    \n    ```\n    {  \"servers\": {    \"cypress\": {      \"type\": \"http\",      \"url\": \"https://mcp.cypress.io/mcp\"    }  }}\n    ```\n    \n2.  VS Code will handle authentication via a browser-based Cypress Cloud sign-in when the server is first used.\n\n**Personal Access Token (Alternative)**\n\n1.  Add the following to your `.vscode/mcp.json`:\n    \n    ```\n    {  \"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    }  ]}\n    ```\n    \n2.  VS Code will prompt for your PAT via the `CYPRESS_MCP_TOKEN` input when connecting.\n\nSee [VS Code's documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) for more details.\n\nGitHub Copilot CLI\n\nGitHub Copilot CLI uses a personal access token for Cloud MCP authentication.\n\n1.  Add the following to your global config (`~/.copilot/mcp-config.json`) or project config (`.copilot/mcp-config.json`):\n    \n    ```\n    {  \"mcpServers\": {    \"Cypress Cloud\": {      \"type\": \"http\",      \"url\": \"https://mcp.cypress.io/mcp\",      \"headers\": {        \"Authorization\": \"Bearer ${CYPRESS_MCP_TOKEN}\"      }    }  }}\n    ```\n    \n2.  Set the environment variable before launching the CLI, replacing `YOUR_MCP_TOKEN` with your personal access token.\n    *   macOS/Linux: `export CYPRESS_MCP_TOKEN=YOUR_MCP_TOKEN`\n    *   Windows (Powershell): `$env:CYPRESS_MCP_TOKEN=\"YOUR_MCP_TOKEN\"`\n3.  Verify the connection. Run `/mcp` show inside the Copilot CLI to confirm the server is loaded and the variable is resolved.\n\nSee [GitHub Copilot's documentation](https://docs.github.com/en/copilot/how-tos/copilot-cli/use-copilot-cli-agents/overview) for more details.\n\nOpenAI Codex CLI\n\nCodex stores MCP configuration in `~/.codex/config.toml`, which is shared between the CLI and Codex IDE extension.\n\n**OAuth (Recommended)**\n\n1.  Add the Cloud MCP server:\n    \n    ```\n    codex mcp add cypress-cloud --url https://mcp.cypress.io/mcp\n    ```\n    \n2.  Start the OAuth flow:\n    \n    ```\n    codex mcp login cypress-cloud\n    ```\n    \n3.  Sign in to Cypress Cloud in the browser window that opens.\n    \n4.  Start a new Codex session. In the CLI, run `/mcp` to confirm the `cypress-cloud` server is connected.\n    \n\nYou can also add the server manually to `~/.codex/config.toml` and then run `codex mcp login cypress-cloud`:\n\n```\n[mcp_servers.cypress-cloud]url = \"https://mcp.cypress.io/mcp\"\n```\n\n**Personal Access Token (Alternative)**\n\n1.  Add the following to `~/.codex/config.toml`:\n    \n    ```\n    [mcp_servers.cypress-cloud]url = \"https://mcp.cypress.io/mcp\"bearer_token_env_var = \"CYPRESS_MCP_TOKEN\"\n    ```\n    \n2.  Set your token in your environment, replacing `YOUR_MCP_TOKEN` with your personal access token:\n    *   macOS/Linux: `export CYPRESS_MCP_TOKEN=YOUR_MCP_TOKEN`\n    *   Windows (Powershell): `$env:CYPRESS_MCP_TOKEN=\"YOUR_MCP_TOKEN\"`\n\nSee [Codex's documentation](https://developers.openai.com/codex/mcp) for more details.\n\nIf you use an AI client not listed here, refer to its documentation for configuring a remote MCP connection.\n",
      "section": "cloud",
      "anchors": [
        "configuring-the-cloud-mcp"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 1831
    },
    {
      "id": "cloud/integrations/cloud-mcp#enable-for-organization",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Enable for Organization",
      "heading_level": 3,
      "content_markdown": "### Enable for Organization\n\nEnable the Cloud MCP integration for your organization from the **Integrations** page for your organization.\n\nEach user who wants to use Cloud MCP must then authenticate — using OAuth or a personal access token.\n",
      "section": "cloud",
      "anchors": [
        "enable-for-organization"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 51
    },
    {
      "id": "cloud/integrations/cloud-mcp#authenticate",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Authenticate",
      "heading_level": 3,
      "content_markdown": "### Authenticate\n\nThere are two options for authenticating the Cloud MCP server with your Cloud account: oauth (recommended) and a personal access token (PAT).\n\n#### OAuth (Recommended)\n\nOAuth is the recommended authentication method for Cloud MCP. It uses a browser-based sign-in flow, so no manual token generation or rotation is needed — your AI client manages the session automatically.\n\nWhen you configure your AI client with the Cloud MCP server URL (`https://mcp.cypress.io/mcp`) and your client supports OAuth, it will:\n\n1.  Detect that the server requires authentication via OAuth discovery.\n2.  Open a browser window and redirect you to the Cypress Cloud sign-in page.\n3.  After you sign in, the client stores the session securely and reconnects automatically for 30 days.\n\nOAuth sessions are scoped to your Cypress Cloud user account and respect your existing role and permissions in each MCP-enabled organization. No token expiry management is required on your part.\n\nYour active OAuth sessions are visible on your **[Manage Profile](https://cloud.cypress.io/profile)** page. You can revoke any session from there at any time.\n\nIf your AI client does not support OAuth, use a [personal access token](#Personal-Access-Token) instead.\n\n#### Personal Access Token\n\nA personal access token (PAT) can used to securely connect with Cypress Cloud through the Cloud MCP server. You create and manage your PAT from your Cypress Cloud profile.\n\n1.  Sign in to [Cypress Cloud](https://cloud.cypress.io).\n2.  In the upper-left corner of any page, click your organization picture.\n3.  Select **[Manage Profile](https://cloud.cypress.io/profile)**.\n4.  Under **MCP personal access token**, click **Generate token**.\n5.  Select an expiration for the token and click **Continue**.\n6.  Your token is generated. Copy it immediately — it is only shown once.\n\nThe token access is scoped to your role and permissions in each MCP-enabled organization. Use your PAT in place of OAuth when your AI client does not support browser-based authentication flows.\n",
      "section": "cloud",
      "anchors": [
        "authenticate"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 405
    },
    {
      "id": "cloud/integrations/cloud-mcp#oauth-recommended",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "OAuth (Recommended)",
      "heading_level": 4,
      "content_markdown": "#### OAuth (Recommended)\n\nOAuth is the recommended authentication method for Cloud MCP. It uses a browser-based sign-in flow, so no manual token generation or rotation is needed — your AI client manages the session automatically.\n\nWhen you configure your AI client with the Cloud MCP server URL (`https://mcp.cypress.io/mcp`) and your client supports OAuth, it will:\n\n1.  Detect that the server requires authentication via OAuth discovery.\n2.  Open a browser window and redirect you to the Cypress Cloud sign-in page.\n3.  After you sign in, the client stores the session securely and reconnects automatically for 30 days.\n\nOAuth sessions are scoped to your Cypress Cloud user account and respect your existing role and permissions in each MCP-enabled organization. No token expiry management is required on your part.\n\nYour active OAuth sessions are visible on your **[Manage Profile](https://cloud.cypress.io/profile)** page. You can revoke any session from there at any time.\n\nIf your AI client does not support OAuth, use a [personal access token](#Personal-Access-Token) instead.\n",
      "section": "cloud",
      "anchors": [
        "oauth-recommended"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 215
    },
    {
      "id": "cloud/integrations/cloud-mcp#personal-access-token",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Personal Access Token",
      "heading_level": 4,
      "content_markdown": "#### Personal Access Token\n\nA personal access token (PAT) can used to securely connect with Cypress Cloud through the Cloud MCP server. You create and manage your PAT from your Cypress Cloud profile.\n\n1.  Sign in to [Cypress Cloud](https://cloud.cypress.io).\n2.  In the upper-left corner of any page, click your organization picture.\n3.  Select **[Manage Profile](https://cloud.cypress.io/profile)**.\n4.  Under **MCP personal access token**, click **Generate token**.\n5.  Select an expiration for the token and click **Continue**.\n6.  Your token is generated. Copy it immediately — it is only shown once.\n\nThe token access is scoped to your role and permissions in each MCP-enabled organization. Use your PAT in place of OAuth when your AI client does not support browser-based authentication flows.\n",
      "section": "cloud",
      "anchors": [
        "personal-access-token"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 159
    },
    {
      "id": "cloud/integrations/cloud-mcp#configure-ai-assistant",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Configure AI Assistant",
      "heading_level": 3,
      "content_markdown": "### Configure AI Assistant\n\nConfigure 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.\n\nThe remote URL is: `https://mcp.cypress.io/mcp`. Clients that support OAuth will handle authentication automatically via a browser sign-in. For clients that do not support OAuth, set the authorization header with `Bearer YOUR_MCP_TOKEN` using your personal access token.\n\nAntigravity\n\n**OAuth (Recommended)**\n\n1.  Open the MCP store via the \"...\" dropdown at the top of the editor's agent panel.\n2.  Click on **Manage MCP Servers**\n3.  Click on **View raw config**\n4.  Modify the `mcp_config.json` with your custom MCP server configuration.\n    \n    ```\n    {  \"mcpServers\": {    \"cypress-cloud\": {      \"serverUrl\": \"https://mcp.cypress.io/mcp\"    }  }}\n    ```\n    \n5.  Save `mcp_config.json` and click Refresh. Antigravity will prompt you to sign in to Cypress Cloud via your browser.\n\n**Personal Access Token (Alternative)**\n\n1.  Follow steps 1–3 above.\n2.  Modify the `mcp_config.json` to include your token:\n    \n    ```\n    {  \"mcpServers\": {    \"cypress-cloud\": {      \"serverUrl\": \"https://mcp.cypress.io/mcp\",      \"headers\": {        \"Authorization\": \"Bearer YOUR_MCP_TOKEN\"      }    }  }}\n    ```\n    \n3.  Replace `YOUR_MCP_TOKEN` with your personal access token.\n4.  Save `mcp_config.json` and click Refresh.\n\nSee [Antigravity's documentation](https://antigravity.google/docs/mcp) for more details.\n\nClaude Desktop\n\n**OAuth (Recommended)**\n\n1.  Open Claude Desktop.\n2.  Click Customize\n3.  Click Connectors\n4.  Click the + icon and select 'Add custom connector'\n5.  Add the connector name, i.e `cypress-cloud`\n6.  Add remote MCP url `https://mcp.cypress.io/mcp`\n7.  Click add\n8.  Click connect to authn\n\n**Personal Access Token (Alternative)**\n\n1.  Open Claude Desktop.\n2.  Go to Settings > Developer > Edit Config.\n3.  Add the following to your `claude_desktop_config.json`:\n    \n    ```\n    {  \"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\"      }    }  }}\n    ```\n    \n4.  Replace `YOUR_MCP_TOKEN` with your personal access token.\n5.  Restart Claude Desktop after saving. You should see a tools indicator in the chat input.\n\nSee [Claude's documentation](https://code.claude.com/docs/en/mcp) for more details. Note: `mcp-remote` requires Node.js v20+ in the path to run successfully.\n\nClaude Code (CLI)\n\n**OAuth (Recommended)**\n\n1.  Add the Cloud MCP server:\n    \n    ```\n    claude mcp add cypress-cloud \\  https://mcp.cypress.io/mcp \\  --transport http\n    ```\n    \n2.  Start claude session `claude`\n    \n3.  Prompt `mcp cypress`\n    \n4.  Claude Code will open a browser window to sign in to Cypress Cloud\n    \n\n**Personal Access Token (Alternative)**\n\n1.  Add the Cloud MCP server with your token:\n    \n    ```\n    claude mcp add cypress-cloud \\  https://mcp.cypress.io/mcp \\  --transport http \\  --header \"Authorization: Bearer YOUR_MCP_TOKEN\"\n    ```\n    \n2.  Replace `YOUR_MCP_TOKEN` with your personal access token.\n    \n\n**Note:** CLI Scope options are\n\n*   `--scope user` — available across all projects (recommended)\n*   `--scope local` — current project only (default)\n*   `--scope project` — shared via `.mcp.json` in project root\n\nSee [Claude Code's documentation](https://code.claude.com/docs/en/mcp) for more details.\n\nCursor\n\n**OAuth (Recommended)**\n\n1.  Open Cursor\n2.  Open the \"Settings\" menu and select \"Cursor Settings\"\n3.  Select \"Tools & MCPs\"\n4.  Select \"New MCP Server\"\n5.  Add the following to your `~/.cursor/mcp.json`:\n    \n    ```\n    {  \"mcpServers\": {    \"cypress\": {      \"url\": \"https://mcp.cypress.io/mcp\"    }  }}\n    ```\n    \n6.  Save the file and restart Cursor. Cursor will open a browser window to sign in to Cypress Cloud on first use.\n\n**Personal Access Token (Alternative)**\n\n1.  Follow steps 1–4 above.\n2.  Add the following to your `~/.cursor/mcp.json`:\n    \n    ```\n    {  \"mcpServers\": {    \"cypress\": {      \"url\": \"https://mcp.cypress.io/mcp\",      \"headers\": {        \"Authorization\": \"Bearer YOUR_MCP_TOKEN\"      }    }  }}\n    ```\n    \n3.  Replace `YOUR_MCP_TOKEN` with your personal access token.\n4.  Save the file and restart Cursor.\n\nSee [Cursor's documentation](https://cursor.com/docs/mcp) for more details.\n\nGitHub Copilot in VS Code\n\nYou can install the Cloud MCP server in your user profile or a specific workspace. See [VS Code's MCP installation options](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).\n\n**OAuth (Recommended)**\n\n1.  Add the following to your `.vscode/mcp.json`:\n    \n    ```\n    {  \"servers\": {    \"cypress\": {      \"type\": \"http\",      \"url\": \"https://mcp.cypress.io/mcp\"    }  }}\n    ```\n    \n2.  VS Code will handle authentication via a browser-based Cypress Cloud sign-in when the server is first used.\n\n**Personal Access Token (Alternative)**\n\n1.  Add the following to your `.vscode/mcp.json`:\n    \n    ```\n    {  \"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    }  ]}\n    ```\n    \n2.  VS Code will prompt for your PAT via the `CYPRESS_MCP_TOKEN` input when connecting.\n\nSee [VS Code's documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) for more details.\n\nGitHub Copilot CLI\n\nGitHub Copilot CLI uses a personal access token for Cloud MCP authentication.\n\n1.  Add the following to your global config (`~/.copilot/mcp-config.json`) or project config (`.copilot/mcp-config.json`):\n    \n    ```\n    {  \"mcpServers\": {    \"Cypress Cloud\": {      \"type\": \"http\",      \"url\": \"https://mcp.cypress.io/mcp\",      \"headers\": {        \"Authorization\": \"Bearer ${CYPRESS_MCP_TOKEN}\"      }    }  }}\n    ```\n    \n2.  Set the environment variable before launching the CLI, replacing `YOUR_MCP_TOKEN` with your personal access token.\n    *   macOS/Linux: `export CYPRESS_MCP_TOKEN=YOUR_MCP_TOKEN`\n    *   Windows (Powershell): `$env:CYPRESS_MCP_TOKEN=\"YOUR_MCP_TOKEN\"`\n3.  Verify the connection. Run `/mcp` show inside the Copilot CLI to confirm the server is loaded and the variable is resolved.\n\nSee [GitHub Copilot's documentation](https://docs.github.com/en/copilot/how-tos/copilot-cli/use-copilot-cli-agents/overview) for more details.\n\nOpenAI Codex CLI\n\nCodex stores MCP configuration in `~/.codex/config.toml`, which is shared between the CLI and Codex IDE extension.\n\n**OAuth (Recommended)**\n\n1.  Add the Cloud MCP server:\n    \n    ```\n    codex mcp add cypress-cloud --url https://mcp.cypress.io/mcp\n    ```\n    \n2.  Start the OAuth flow:\n    \n    ```\n    codex mcp login cypress-cloud\n    ```\n    \n3.  Sign in to Cypress Cloud in the browser window that opens.\n    \n4.  Start a new Codex session. In the CLI, run `/mcp` to confirm the `cypress-cloud` server is connected.\n    \n\nYou can also add the server manually to `~/.codex/config.toml` and then run `codex mcp login cypress-cloud`:\n\n```\n[mcp_servers.cypress-cloud]url = \"https://mcp.cypress.io/mcp\"\n```\n\n**Personal Access Token (Alternative)**\n\n1.  Add the following to `~/.codex/config.toml`:\n    \n    ```\n    [mcp_servers.cypress-cloud]url = \"https://mcp.cypress.io/mcp\"bearer_token_env_var = \"CYPRESS_MCP_TOKEN\"\n    ```\n    \n2.  Set your token in your environment, replacing `YOUR_MCP_TOKEN` with your personal access token:\n    *   macOS/Linux: `export CYPRESS_MCP_TOKEN=YOUR_MCP_TOKEN`\n    *   Windows (Powershell): `$env:CYPRESS_MCP_TOKEN=\"YOUR_MCP_TOKEN\"`\n\nSee [Codex's documentation](https://developers.openai.com/codex/mcp) for more details.\n\nIf you use an AI client not listed here, refer to its documentation for configuring a remote MCP connection.\n",
      "section": "cloud",
      "anchors": [
        "configure-ai-assistant"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 1296
    },
    {
      "id": "cloud/integrations/cloud-mcp#available-tools",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Available tools",
      "heading_level": 2,
      "content_markdown": "## Available tools\n\nOnce connected, your AI agent can autonomously use the following tools. You don't call these manually; the agent selects them based on your prompt.\n\nEach time the Cloud MCP connection is established, any new tools become immediately available.\n\nSome 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.\n\n| Tool | Capability | Best Use Case |\n| --- | --- | --- |\n| `cypress_get_projects` | Lists all projects in your Org. | Helping the agent find the correct `projectId` for subsequent queries. |\n| `cypress_get_runs` | 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. | \"Check the status of the last CI run on main\" |\n| `cypress_get_failed_tests` | Retrieves attempt details: test name, spec, attempt error and stack trace, and a Test Replay link for quick debugging. Does not return test artifacts. | \"Analyze why the checkout test failed in the latest run.\" |\n| `cypress_get_flaky_tests` | Identifies the flaky tests in a run. | \"Are these failures regressions or known flakiness?\" |\n| `cypress_get_accessibility_report` | 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. | \"Summarize accessibility violations for the latest run on this branch.\" |\n| `cypress_get_accessibility_views` | 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. | \"Which pages have the most accessibility failures in this run?\" |\n| `cypress_get_accessibility_rule_failures` | Returns paginated failing DOM elements for a specific accessibility rule, with CSS selector, view, and failure message. Optionally scope to a specific view. | \"Show me all color-contrast failures on the checkout page.\" |\n| `cypress_get_ui_coverage_report` | Returns a high-level UI Coverage report for a run: overall coverage score, tested and untested element and link counts, and the top 5 riskiest views sorted by most untested interactive elements. | \"Summarize UI Coverage for the latest run on this branch.\" |\n| `cypress_get_ui_coverage_views` | Returns paginated views from a UI Coverage report, sorted by most untested elements and links. Use to browse all views beyond the top 5 in the report summary. | \"Which pages have the most untested elements in this run?\" |\n| `cypress_get_ui_coverage_elements` | Returns paginated interactive elements for a run. Filter by tested or untested, and optionally scope to a specific view by name. | \"Show me the untested elements on the checkout page in this run.\" |\n| `submit_mcp_feedback` | Shares feedback with Cypress directly from your agentic environment. | \"Report a bug or request a new MCP feature.\" |\n",
      "section": "cloud",
      "anchors": [
        "available-tools"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 660
    },
    {
      "id": "cloud/integrations/cloud-mcp#writing-effective-prompts",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Writing effective prompts",
      "heading_level": 2,
      "content_markdown": "## Writing effective prompts\n\nTo get the most out of Cloud MCP, follow these three principles:\n\n*   **Trigger Explicitly:** Use the phrase \"Cypress Cloud\" to ensure the agent looks for the correct MCP tools.\n*   **Provide Context:** Mention \"this branch,\" \"this commit,\" or paste a Run URL directly.\n*   **Define the Workflow:** Don't just ask what failed; ask the agent to fix it.\n",
      "section": "cloud",
      "anchors": [
        "writing-effective-prompts"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 84
    },
    {
      "id": "cloud/integrations/cloud-mcp#example-prompts",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Example Prompts",
      "heading_level": 2,
      "content_markdown": "## Example Prompts\n\n**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.\n\n### The Health Check\n\nGet a high-level summary of any failures in the latest run on your branch.\n\nCheck Cypress Cloud for the latest run on this branch. Give me a high-level summary of any failures.\n\n### The Deep Debug\n\nInvestigate each failing test and propose a fix for the regression.\n\nFind 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.\n\n### The Flake Audit\n\nSurface flaky tests across recent runs and look for common patterns.\n\nList all flaky tests from the last 5 runs in Cypress Cloud. Are there any common patterns in the error messages?\n\n### The Accessibility Triage\n\nSummarize accessibility violations for the latest run, grouped by rule and view.\n\nPull 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.\n\nFor a deeper exploration of working with Cloud MCP's accessibility tools, read our guide [Cypress Accessibility - Work with AI agents](/llm/markdown/accessibility/work-with-ai-agents.md).\n\n### The UI Coverage Triage\n\nReview UI Coverage for the latest run and drill into the riskiest view.\n\nUsing Cypress Cloud, pull the UI Coverage report for the latest run on this branch. Tell me the overall coverage score, list the views with the most untested elements, and show me the specific untested elements on the riskiest view.\n\nFor more patterns, example prompts, and governance ideas when using UI Coverage with agents, read [Cypress UI Coverage - Work with AI agents](/llm/markdown/ui-coverage/work-with-ai-agents.md).\n",
      "section": "cloud",
      "anchors": [
        "example-prompts"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 391
    },
    {
      "id": "cloud/integrations/cloud-mcp#the-health-check",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "The Health Check",
      "heading_level": 3,
      "content_markdown": "### The Health Check\n\nGet a high-level summary of any failures in the latest run on your branch.\n\nCheck Cypress Cloud for the latest run on this branch. Give me a high-level summary of any failures.\n",
      "section": "cloud",
      "anchors": [
        "the-health-check"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 48
    },
    {
      "id": "cloud/integrations/cloud-mcp#the-deep-debug",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "The Deep Debug",
      "heading_level": 3,
      "content_markdown": "### The Deep Debug\n\nInvestigate each failing test and propose a fix for the regression.\n\nFind 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.\n",
      "section": "cloud",
      "anchors": [
        "the-deep-debug"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 56
    },
    {
      "id": "cloud/integrations/cloud-mcp#the-flake-audit",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "The Flake Audit",
      "heading_level": 3,
      "content_markdown": "### The Flake Audit\n\nSurface flaky tests across recent runs and look for common patterns.\n\nList all flaky tests from the last 5 runs in Cypress Cloud. Are there any common patterns in the error messages?\n",
      "section": "cloud",
      "anchors": [
        "the-flake-audit"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 48
    },
    {
      "id": "cloud/integrations/cloud-mcp#the-accessibility-triage",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "The Accessibility Triage",
      "heading_level": 3,
      "content_markdown": "### The Accessibility Triage\n\nSummarize accessibility violations for the latest run, grouped by rule and view.\n\nPull 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.\n\nFor a deeper exploration of working with Cloud MCP's accessibility tools, read our guide [Cypress Accessibility - Work with AI agents](/llm/markdown/accessibility/work-with-ai-agents.md).\n",
      "section": "cloud",
      "anchors": [
        "the-accessibility-triage"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 89
    },
    {
      "id": "cloud/integrations/cloud-mcp#the-ui-coverage-triage",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "The UI Coverage Triage",
      "heading_level": 3,
      "content_markdown": "### The UI Coverage Triage\n\nReview UI Coverage for the latest run and drill into the riskiest view.\n\nUsing Cypress Cloud, pull the UI Coverage report for the latest run on this branch. Tell me the overall coverage score, list the views with the most untested elements, and show me the specific untested elements on the riskiest view.\n\nFor more patterns, example prompts, and governance ideas when using UI Coverage with agents, read [Cypress UI Coverage - Work with AI agents](/llm/markdown/ui-coverage/work-with-ai-agents.md).\n",
      "section": "cloud",
      "anchors": [
        "the-ui-coverage-triage"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 108
    },
    {
      "id": "cloud/integrations/cloud-mcp#faqs",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "FAQs",
      "heading_level": 2,
      "content_markdown": "## FAQs\n\n### Cloud MCP vs the Cloud CLI\n\nCloud MCP and the [Cloud CLI](/llm/markdown/cloud/integrations/cloud-cli.md) both give programmatic access to your Cypress Cloud data. They solve related problems in different ways:\n\n*   **Cloud MCP** is a remote server your AI client connects to. The agent selects Cypress tools automatically based on your prompt, which makes it the best fit for conversational, in-editor debugging.\n*   **The Cloud CLI** (`cy-cloud`) is a command-line tool for humans, scripts, and agents that run shell commands. It returns JSON and provides direct access to Test Replay data, which makes it the best fit for deeper triage from the terminal, automation, custom tooling, and agents that run shell commands.\n\nMany teams use both. If your assistant speaks MCP, connect it to Cloud MCP. If it works through a terminal, or you are scripting, reach for the Cloud CLI. Use both when running agents in your terminal.\n\nBoth are available on every Cypress Cloud plan at no additional cost. See the [Cloud CLI documentation](/llm/markdown/cloud/integrations/cloud-cli.md) for its setup and command reference.\n\n### Troubleshooting\n\n**Agent can't find your run:**\n\n*   Verify the organization has the Cloud MCP integration enabled in Cypress Cloud.\n*   Ensure your Git branch name in CI matches the branch name you're telling the agent.\n*   A failed CI job doesn't mean no run was recorded. A red CI conclusion only reflects the job's exit code. As long as Cypress recorded the run, it's in Cypress Cloud and the agent can query it, so point the agent at the run by branch, commit, run number, or Run URL instead of assuming a failed job left nothing to find.\n*   If you pair Cloud MCP with a CI or GitHub MCP that reads job logs, the recorded Run URL prints near the _end_ of the Cypress CLI output. Have the agent read the tail of the log so it doesn't miss the link.\n\n**Connection errors:**\n\n*   If using OAuth: ensure your browser can reach [https://cloud.cypress.io](https://cloud.cypress.io) to complete sign-in. If the browser window doesn't open, try removing and re-adding the server config in your AI client.\n*   If using a personal access token: verify your PAT hasn't expired (check Manage Profile).\n*   Check firewall and proxy settings to ensure [https://mcp.cypress.io](https://mcp.cypress.io) is allowlisted.\n\n**Switching from a personal access token to OAuth:**\n\nIf you previously configured Cloud MCP with a PAT and want to switch to OAuth:\n\n1.  Remove the `Authorization` header (or token environment variable) from your AI client's MCP config.\n2.  Save the config and reconnect. Your client will detect that no token is present and trigger the OAuth browser sign-in flow automatically.\n\n### Pricing & Availability\n\nCloud 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.\n\nNo minimum Cypress App version is required to get started.\n\nCloud MCP reached generally available on May 20th, 2026.\n\n### Usage Limits\n\nCurrent limits include 100 tool requests per hour for all plans.\n\nCloud MCP data availability matches existing test recording limits and data retention policies for your plan.\n\nIf you need to increase your limits, contact support at [support@cypress.io](mailto:support@cypress.io).\n\n### Security & Privacy\n\nCloud MCP is an API for AI agents. When your AI assistant needs information about your Cypress test runs, it calls Cloud MCP the same way any application calls an API — it sends a request, and Cypress returns data.\n\n**What Cypress can and cannot see:**\n\n*   **Cypress cannot see your AI conversation:** Cypress has no access to your AI assistant's context window, chat history, or anything it generates. The only thing Cypress receives are the inputs to a tool call — for example, `getRuns(projectId: 100, runNumber: 45, limit: 10)`.\n*   **Cypress does not train on your data:** Test results, stack traces, and replay links returned through Cloud MCP are used only to fulfill the request. Your data is never used to train or improve any LLM.\n*   **You control the connection:** Cloud MCP is opt-in. Enabling it means your AI assistant can request Cypress data and enabling the integration does not give Cypress any visibility into your AI's context, conversation, or outputs.\n\n**How access is controlled:**\n\n*   **Read-only:** Cloud MCP is designed for data retrieval and debugging. It cannot modify your test code or delete runs.\n*   **User-scoped:** Your AI assistant can only access the projects and data your Cypress Cloud user has permission to see. It operates within the same access boundaries as you do.\n*   **Locally managed:** You control when the server is active by managing the configuration in your local AI client.\n\nCloud MCP implements the standard MCP authorization specification with OAuth 2.0 and uses streamable HTTP transport. It falls under our [AI security practices →](https://on.cypress.io/ai-security)\n\n### Remove the integration\n\nRemove the Cloud MCP integration at any time by going to the **Integrations** page for your organization and selecting **Disable** in the Cypress MCP section.\n\nDisabling the integration immediately revokes access for all users in that organization, regardless of whether they authenticated via OAuth or a personal access token.\n",
      "section": "cloud",
      "anchors": [
        "faqs"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 1125
    },
    {
      "id": "cloud/integrations/cloud-mcp#cloud-mcp-vs-the-cloud-cli",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Cloud MCP vs the Cloud CLI",
      "heading_level": 3,
      "content_markdown": "### Cloud MCP vs the Cloud CLI\n\nCloud MCP and the [Cloud CLI](/llm/markdown/cloud/integrations/cloud-cli.md) both give programmatic access to your Cypress Cloud data. They solve related problems in different ways:\n\n*   **Cloud MCP** is a remote server your AI client connects to. The agent selects Cypress tools automatically based on your prompt, which makes it the best fit for conversational, in-editor debugging.\n*   **The Cloud CLI** (`cy-cloud`) is a command-line tool for humans, scripts, and agents that run shell commands. It returns JSON and provides direct access to Test Replay data, which makes it the best fit for deeper triage from the terminal, automation, custom tooling, and agents that run shell commands.\n\nMany teams use both. If your assistant speaks MCP, connect it to Cloud MCP. If it works through a terminal, or you are scripting, reach for the Cloud CLI. Use both when running agents in your terminal.\n\nBoth are available on every Cypress Cloud plan at no additional cost. See the [Cloud CLI documentation](/llm/markdown/cloud/integrations/cloud-cli.md) for its setup and command reference.\n",
      "section": "cloud",
      "anchors": [
        "cloud-mcp-vs-the-cloud-cli"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 228
    },
    {
      "id": "cloud/integrations/cloud-mcp#troubleshooting",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Troubleshooting",
      "heading_level": 3,
      "content_markdown": "### Troubleshooting\n\n**Agent can't find your run:**\n\n*   Verify the organization has the Cloud MCP integration enabled in Cypress Cloud.\n*   Ensure your Git branch name in CI matches the branch name you're telling the agent.\n*   A failed CI job doesn't mean no run was recorded. A red CI conclusion only reflects the job's exit code. As long as Cypress recorded the run, it's in Cypress Cloud and the agent can query it, so point the agent at the run by branch, commit, run number, or Run URL instead of assuming a failed job left nothing to find.\n*   If you pair Cloud MCP with a CI or GitHub MCP that reads job logs, the recorded Run URL prints near the _end_ of the Cypress CLI output. Have the agent read the tail of the log so it doesn't miss the link.\n\n**Connection errors:**\n\n*   If using OAuth: ensure your browser can reach [https://cloud.cypress.io](https://cloud.cypress.io) to complete sign-in. If the browser window doesn't open, try removing and re-adding the server config in your AI client.\n*   If using a personal access token: verify your PAT hasn't expired (check Manage Profile).\n*   Check firewall and proxy settings to ensure [https://mcp.cypress.io](https://mcp.cypress.io) is allowlisted.\n\n**Switching from a personal access token to OAuth:**\n\nIf you previously configured Cloud MCP with a PAT and want to switch to OAuth:\n\n1.  Remove the `Authorization` header (or token environment variable) from your AI client's MCP config.\n2.  Save the config and reconnect. Your client will detect that no token is present and trigger the OAuth browser sign-in flow automatically.\n",
      "section": "cloud",
      "anchors": [
        "troubleshooting"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 349
    },
    {
      "id": "cloud/integrations/cloud-mcp#pricing-availability",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Pricing & Availability",
      "heading_level": 3,
      "content_markdown": "### Pricing & Availability\n\nCloud 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.\n\nNo minimum Cypress App version is required to get started.\n\nCloud MCP reached generally available on May 20th, 2026.\n",
      "section": "cloud",
      "anchors": [
        "pricing-availability"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 68
    },
    {
      "id": "cloud/integrations/cloud-mcp#usage-limits",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Usage Limits",
      "heading_level": 3,
      "content_markdown": "### Usage Limits\n\nCurrent limits include 100 tool requests per hour for all plans.\n\nCloud MCP data availability matches existing test recording limits and data retention policies for your plan.\n\nIf you need to increase your limits, contact support at [support@cypress.io](mailto:support@cypress.io).\n",
      "section": "cloud",
      "anchors": [
        "usage-limits"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 55
    },
    {
      "id": "cloud/integrations/cloud-mcp#security-privacy",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Security & Privacy",
      "heading_level": 3,
      "content_markdown": "### Security & Privacy\n\nCloud MCP is an API for AI agents. When your AI assistant needs information about your Cypress test runs, it calls Cloud MCP the same way any application calls an API — it sends a request, and Cypress returns data.\n\n**What Cypress can and cannot see:**\n\n*   **Cypress cannot see your AI conversation:** Cypress has no access to your AI assistant's context window, chat history, or anything it generates. The only thing Cypress receives are the inputs to a tool call — for example, `getRuns(projectId: 100, runNumber: 45, limit: 10)`.\n*   **Cypress does not train on your data:** Test results, stack traces, and replay links returned through Cloud MCP are used only to fulfill the request. Your data is never used to train or improve any LLM.\n*   **You control the connection:** Cloud MCP is opt-in. Enabling it means your AI assistant can request Cypress data and enabling the integration does not give Cypress any visibility into your AI's context, conversation, or outputs.\n\n**How access is controlled:**\n\n*   **Read-only:** Cloud MCP is designed for data retrieval and debugging. It cannot modify your test code or delete runs.\n*   **User-scoped:** Your AI assistant can only access the projects and data your Cypress Cloud user has permission to see. It operates within the same access boundaries as you do.\n*   **Locally managed:** You control when the server is active by managing the configuration in your local AI client.\n\nCloud MCP implements the standard MCP authorization specification with OAuth 2.0 and uses streamable HTTP transport. It falls under our [AI security practices →](https://on.cypress.io/ai-security)\n",
      "section": "cloud",
      "anchors": [
        "security-privacy"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 352
    },
    {
      "id": "cloud/integrations/cloud-mcp#remove-the-integration",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Remove the integration",
      "heading_level": 3,
      "content_markdown": "### Remove the integration\n\nRemove the Cloud MCP integration at any time by going to the **Integrations** page for your organization and selecting **Disable** in the Cypress MCP section.\n\nDisabling the integration immediately revokes access for all users in that organization, regardless of whether they authenticated via OAuth or a personal access token.\n",
      "section": "cloud",
      "anchors": [
        "remove-the-integration"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 71
    },
    {
      "id": "cloud/integrations/cloud-mcp#send-feedback",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Send feedback",
      "heading_level": 2,
      "content_markdown": "## Send feedback\n\nYou can share feedback directly through your agent:\n\nShare feedback, use cases, or issues with Cypress from your agent.\n\nSend Cypress the following feedback: \\[Your message here\\]\n\nAlternatively, use [this feedback form](https://share.hsforms.com/2NWNpyi5KSZmG4x0geIXgBg3a4za) to share any feedback, use cases, or issues encountered with your prompts and queries.\n",
      "section": "cloud",
      "anchors": [
        "send-feedback"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 65
    },
    {
      "id": "cloud/integrations/cloud-mcp#also-see",
      "doc_id": "cloud/integrations/cloud-mcp",
      "heading": "Also See",
      "heading_level": 2,
      "content_markdown": "## Also See\n\n*   [Cloud CLI](/llm/markdown/cloud/integrations/cloud-cli.md)\n*   [Recording Cloud Runs](/llm/markdown/cloud/features/recorded-runs.md)\n*   [Cypress AI](/llm/markdown/cloud/features/cypress-ai-features.md)\n*   [cy.prompt()](/llm/markdown/api/commands/prompt.md)\n*   [Cypress Accessibility - Work with AI agents](/llm/markdown/accessibility/work-with-ai-agents.md)\n*   [Cypress UI Coverage - Work with AI agents](/llm/markdown/ui-coverage/work-with-ai-agents.md)\n",
      "section": "cloud",
      "anchors": [
        "also-see"
      ],
      "path": "/llm/json/chunked/cloud/integrations/cloud-mcp.json",
      "token_estimate": 43
    }
  ]
}