From ec65afc154651574213828c1dc1807f0272243e6 Mon Sep 17 00:00:00 2001 From: estrada9166 Date: Fri, 6 Nov 2026 16:02:31 -0500 Subject: [PATCH 1/2] docs: list where Cloud MCP is published Add a "Install Cloud MCP from a marketplace listing" section to the Cloud MCP page covering the Cursor Directory, the Claude plugin directory, the VS Code Marketplace, and the official MCP Registry, with install steps for each client. Point the manual Cursor and VS Code setup sections at the one-click options. Co-Authored-By: Claude Opus 5.5 --- docs/cloud/integrations/cloud-mcp.mdx | 51 +++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/docs/cloud/integrations/cloud-mcp.mdx b/docs/cloud/integrations/cloud-mcp.mdx index e4c9829105..561122a7e0 100644 --- a/docs/cloud/integrations/cloud-mcp.mdx +++ b/docs/cloud/integrations/cloud-mcp.mdx @@ -87,8 +87,55 @@ The token access is scoped to your role and permissions in each MCP-enabled orga alt="Enable user's MPC personal access token" /> +### Install Cloud MCP from a marketplace listing + +Cypress publishes Cloud MCP to the marketplaces built into popular AI clients. Installing from a listing adds the server to your client with OAuth already configured, so you skip editing a config file. Your organization still needs the [integration enabled](#Enable-for-Organization). + +| Where Cypress is listed | What it installs | Works with | +| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | +| [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Cypress-io.vscode-cypress-cloud-mcp) | The Cypress Cloud MCP extension (`Cypress-io.vscode-cypress-cloud-mcp`) | GitHub Copilot and other agents in VS Code | +| [Claude plugin directory](https://claude.com/plugins/cypress) | The `cypress` plugin: Cloud MCP plus the [Cypress AI Skills](/app/tooling/ai-skills) | Claude Cowork and Claude Code | +| [Cursor Directory](https://cursor.directory/plugins/cypress) | The `cypress` plugin: Cloud MCP plus the Cypress AI Skills | Cursor | +| [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.cypress.mcp/cypress-cloud) | The `io.cypress.mcp/cypress-cloud` server entry | Clients and directories that read from the official MCP Registry | + +#### Install the VS Code extension + +1. In VS Code, open the **Extensions** view and search for `Cypress Cloud MCP`, or install it from the [VS Code Marketplace listing](https://marketplace.visualstudio.com/items?itemName=Cypress-io.vscode-cypress-cloud-mcp). +2. Select **Connect** in the welcome message, or run **Cypress Cloud MCP: Connect** from the Command Palette. +3. Select **Cypress Cloud** from the MCP server list and start it. +4. Confirm the trust and sign-in prompts, then sign in to Cypress Cloud in your browser. +5. Open Chat and select agent mode. + +The extension connects only to `https://mcp.cypress.io/mcp`, and VS Code manages the OAuth session. + +#### Install the Claude plugin + +The `cypress` plugin bundles Cloud MCP with the Cypress AI Skills, so one install gives Claude both your Cypress Cloud data and Cypress testing conventions. + +- **Claude Cowork:** open the [Cypress listing](https://claude.com/plugins/cypress) in the Claude plugin directory and install it. +- **Claude Code:** add the community marketplace, then install the plugin: + + ```bash + claude plugin marketplace add anthropics/claude-plugins-community + claude plugin install cypress@claude-community + ``` + +To sign in from Claude Code, run `/mcp`, select the Cypress Cloud server, and complete the Cypress Cloud sign-in in your browser. + +#### Install from the Cursor Directory + +The [Cypress listing](https://cursor.directory/plugins/cypress) in the Cursor Directory carries the same `cypress` plugin, with Cloud MCP and the Cypress AI Skills. + +1. Open the [Cypress listing](https://cursor.directory/plugins/cypress) and select the **MCP Servers** tab. +2. Select **Add to Cursor**. Cursor opens and adds the `cypress-cloud` server. +3. Confirm the install in Cursor. Cursor opens a browser window to sign in to Cypress Cloud on first use. + +To add the skills as well, copy them from the listing's **Skills** tab, or install them with the [Cypress AI Skills](/app/tooling/ai-skills) instructions. + ### Configure AI Assistant +If your client has no marketplace listing, or you want to authenticate with a personal access token, configure the connection yourself. + 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. The 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. @@ -221,6 +268,8 @@ See [Claude Code's documentation](https://code.claude.com/docs/en/mcp) for more }> +To install without editing a config file, use the [Cursor Directory listing](#Install-from-the-Cursor-Directory). + **OAuth (Recommended)** 1. Open Cursor @@ -264,6 +313,8 @@ See [Cursor's documentation](https://cursor.com/docs/mcp) for more details. }> +To install without editing a config file, use the [VS Code extension](#Install-the-VS-Code-extension). + You 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). **OAuth (Recommended)** From a948cc00468d28bbde397e9af01aa044013399eb Mon Sep 17 00:00:00 2001 From: estrada9166 Date: Tue, 10 Nov 2026 10:51:31 -0500 Subject: [PATCH 2/2] docs: add the Claude connector listing for Cloud MCP Add the Cypress Cloud connector in the Claude connector directory and explain how it differs from the Claude plugin: the connector adds Cloud MCP to your Claude account for Claude chat, while the plugin adds Cloud MCP and the Cypress AI Skills to Claude Code or Cowork. Alphabetize the listings table and give the install headings standalone names. Co-Authored-By: Claude Opus 5.5 --- docs/cloud/integrations/cloud-mcp.mdx | 44 ++++++++++++++++++--------- 1 file changed, 30 insertions(+), 14 deletions(-) diff --git a/docs/cloud/integrations/cloud-mcp.mdx b/docs/cloud/integrations/cloud-mcp.mdx index 561122a7e0..e426202f74 100644 --- a/docs/cloud/integrations/cloud-mcp.mdx +++ b/docs/cloud/integrations/cloud-mcp.mdx @@ -93,24 +93,28 @@ Cypress publishes Cloud MCP to the marketplaces built into popular AI clients. I | Where Cypress is listed | What it installs | Works with | | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | -| [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Cypress-io.vscode-cypress-cloud-mcp) | The Cypress Cloud MCP extension (`Cypress-io.vscode-cypress-cloud-mcp`) | GitHub Copilot and other agents in VS Code | -| [Claude plugin directory](https://claude.com/plugins/cypress) | The `cypress` plugin: Cloud MCP plus the [Cypress AI Skills](/app/tooling/ai-skills) | Claude Cowork and Claude Code | +| [Claude connector directory](https://claude.ai/directory/cypress-cloud) | The Cypress Cloud connector: Cloud MCP only | Claude on the web, desktop, and mobile | +| [Claude plugin directory](https://claude.com/plugins/cypress) | The `cypress` plugin: Cloud MCP plus the [Cypress AI Skills](/app/tooling/ai-skills) | Claude Code and Claude Cowork | | [Cursor Directory](https://cursor.directory/plugins/cypress) | The `cypress` plugin: Cloud MCP plus the Cypress AI Skills | Cursor | | [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.cypress.mcp/cypress-cloud) | The `io.cypress.mcp/cypress-cloud` server entry | Clients and directories that read from the official MCP Registry | +| [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Cypress-io.vscode-cypress-cloud-mcp) | The Cypress Cloud MCP extension (`Cypress-io.vscode-cypress-cloud-mcp`) | GitHub Copilot and other agents in VS Code | -#### Install the VS Code extension +#### Choose the Claude connector or the Claude plugin for Cloud MCP -1. In VS Code, open the **Extensions** view and search for `Cypress Cloud MCP`, or install it from the [VS Code Marketplace listing](https://marketplace.visualstudio.com/items?itemName=Cypress-io.vscode-cypress-cloud-mcp). -2. Select **Connect** in the welcome message, or run **Cypress Cloud MCP: Connect** from the Command Palette. -3. Select **Cypress Cloud** from the MCP server list and start it. -4. Confirm the trust and sign-in prompts, then sign in to Cypress Cloud in your browser. -5. Open Chat and select agent mode. +Cypress has two Claude listings. Both connect Claude to the same Cloud MCP server, so they return the same Cypress Cloud data. They differ in what else they install and where you use them: -The extension connects only to `https://mcp.cypress.io/mcp`, and VS Code manages the OAuth session. +- **The connector** adds Cloud MCP to your Claude account. Use it to ask Claude about your runs, failures, and flaky tests in Claude chat. There is nothing to install or update locally: the server is hosted by Cypress, and new tools appear the next time Claude connects. +- **The plugin** adds Cloud MCP and the Cypress AI Skills to Claude Code or Claude Cowork. The skills teach Claude how to write, explain, and debug Cypress tests, so use the plugin when Claude works in your test code as well as reading your Cloud data. + +Install one or the other for a given Claude app, not both, so Claude sees one Cypress Cloud server instead of two. -#### Install the Claude plugin +#### Add the Cypress Cloud connector to Claude + +1. Sign in to Claude and open the [Cypress Cloud listing](https://claude.ai/directory/cypress-cloud) in the connector directory. In Claude Desktop, you can also find it under **Customize** > **Connectors**. +2. Add the connector. +3. Sign in to Cypress Cloud in the browser window that opens. -The `cypress` plugin bundles Cloud MCP with the Cypress AI Skills, so one install gives Claude both your Cypress Cloud data and Cypress testing conventions. +#### Install the Cypress plugin in Claude Code or Cowork - **Claude Cowork:** open the [Cypress listing](https://claude.com/plugins/cypress) in the Claude plugin directory and install it. - **Claude Code:** add the community marketplace, then install the plugin: @@ -122,7 +126,7 @@ The `cypress` plugin bundles Cloud MCP with the Cypress AI Skills, so one instal To sign in from Claude Code, run `/mcp`, select the Cypress Cloud server, and complete the Cypress Cloud sign-in in your browser. -#### Install from the Cursor Directory +#### Install the Cypress plugin from the Cursor Directory The [Cypress listing](https://cursor.directory/plugins/cypress) in the Cursor Directory carries the same `cypress` plugin, with Cloud MCP and the Cypress AI Skills. @@ -132,6 +136,16 @@ The [Cypress listing](https://cursor.directory/plugins/cypress) in the Cursor Di To add the skills as well, copy them from the listing's **Skills** tab, or install them with the [Cypress AI Skills](/app/tooling/ai-skills) instructions. +#### Install the Cypress Cloud MCP extension for VS Code + +1. In VS Code, open the **Extensions** view and search for `Cypress Cloud MCP`, or install it from the [VS Code Marketplace listing](https://marketplace.visualstudio.com/items?itemName=Cypress-io.vscode-cypress-cloud-mcp). +2. Select **Connect** in the welcome message, or run **Cypress Cloud MCP: Connect** from the Command Palette. +3. Select **Cypress Cloud** from the MCP server list and start it. +4. Confirm the trust and sign-in prompts, then sign in to Cypress Cloud in your browser. +5. Open Chat and select agent mode. + +The extension connects only to `https://mcp.cypress.io/mcp`, and VS Code manages the OAuth session. + ### Configure AI Assistant If your client has no marketplace listing, or you want to authenticate with a personal access token, configure the connection yourself. @@ -184,6 +198,8 @@ See [Antigravity's documentation](https://antigravity.google/docs/mcp) for more }> +To connect without a custom connector, add the [Cypress Cloud connector](#Add-the-Cypress-Cloud-connector-to-Claude) from the Claude connector directory. + **OAuth (Recommended)** 1. Open Claude Desktop. @@ -268,7 +284,7 @@ See [Claude Code's documentation](https://code.claude.com/docs/en/mcp) for more }> -To install without editing a config file, use the [Cursor Directory listing](#Install-from-the-Cursor-Directory). +To install without editing a config file, use the [Cursor Directory listing](#Install-the-Cypress-plugin-from-the-Cursor-Directory). **OAuth (Recommended)** @@ -313,7 +329,7 @@ See [Cursor's documentation](https://cursor.com/docs/mcp) for more details. }> -To install without editing a config file, use the [VS Code extension](#Install-the-VS-Code-extension). +To install without editing a config file, use the [VS Code extension](#Install-the-Cypress-Cloud-MCP-extension-for-VS-Code). You 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).