Get your setup working faster. Join our Discord for optimisation tips from elite testers.

Remote MCP server

Connect your AI assistant to BrowserStack without local installation using the BrowserStack remote MCP server.

The BrowserStack remote MCP server provides the capabilities of a standard MCP server without local installation or setup. It connects your AI assistant to our real device cloud. The remote MCP server uses OAuth to authenticate securely with BrowserStack’s system. This standards-based approach eliminates manual credential handling and reduces the risk of exposure.

Key benefits

The remote MCP server gives you the following benefits:

Access BrowserStack tools and AI agents without setup.
Access BrowserStack in firewall-restricted enterprise networks without local installation.
Securely integrate with AI assistants, such as GitHub Copilot or Claude, through OAuth without passing credentials.
Access BrowserStack tools, such as Test Management, Test Reporting and Analytics, Accessibility, Live, and Automate, on chatbots such as Claude and ChatGPT.

Install and set up the remote MCP server

You can configure the remote MCP server in one of the following ways:

Globally, making it available across all your projects.
Project-specific, for a single project.

Global installation

A global installation enables the MCP server for your user account in a specific client. You can install the server in your preferred client using a one-click installation, a manual setup, or your agent.

One-click installation

Use the following links to add the remote MCP server to your client:

Client	One-click link	Requirement
VS Code	Install in VS Code	Requires VS Code. Download VS Code.
Cursor	Install in Cursor	Requires Cursor. Download Cursor.
Claude	Follow the Claude tab in Manual installation.	Works in Claude on web, Desktop, and mobile. Download Claude.
ChatGPT	Install in ChatGPT	Requires a paid ChatGPT plan.

VS Code and Cursor must be installed. After the client opens, select Install, and then sign in to BrowserStack.

Manual installation

Choose your client to see the setup steps.

GitHub Copilot
Cline

Click the Tools icon on your GitHub Copilot chat window. A tools menu appears at the top of your IDE.

Tools icon in the GitHub Copilot chat window

Select Add MCP server from the list.

Add MCP Server option in the Tools menu

Select the HTTP option.

HTTP option selected for MCP server configuration

Paste the remote MCP server URL: https://mcp.browserstack.com/mcp.

Remote MCP server URL input field

Enter the server ID as browserstack.

Server ID input field with browserstack entered

In VS Code, click Start MCP Server, and then click Allow on the pop-up to authenticate using OAuth.

OAuth authentication dialog for BrowserStack MCP server

Follow these steps to add the remote server in Cursor:

Open ~/.cursor/mcp.json. Create the file if it doesn’t exist.
Add the server:

Copy

After you save the file, go to Cursor Settings > MCP, select Needs login next to BrowserStack, and sign in.

Claude on web, Desktop, and mobile

On the Free, Pro, and Max plans, add the connector yourself. On the Team and Enterprise plans, an Owner adds it once in Organization settings > Connectors > Add > Custom > Web, and then each member clicks Connect.

To add the connector, follow these steps:

Go to Customize > Connectors and click Add custom connector.
Enter BrowserStack as the name and https://mcp.browserstack.com/mcp as the URL. Click Add.
Click Connect and sign in to BrowserStack.
In a chat, open + > Connectors and turn on BrowserStack.

Claude Code

Run the following command to add the server for your user account:

Copy

Then run /mcp in a Claude Code session, select BrowserStack, and sign in.

GitHub Copilot works in several editors. For VS Code, follow the VS Code > GitHub Copilot tab.

GitHub Copilot CLI

In a copilot session, run /mcp add, enter browserstack as the name, and select HTTP with the URL https://mcp.browserstack.com/mcp.

Or add the server to ~/.copilot/mcp-config.json:

Copy

JetBrains IDEs

Open Copilot Chat, switch to Agent mode, click the tools icon, and select Add More Tools. This opens mcp.json.

Add the server:

Copy

Visual Studio

Create %USERPROFILE%\.mcp.json for all solutions, or .mcp.json in the solution folder for one solution. Add the same servers JSON as JetBrains, and then open Copilot Chat in Agent mode.

Option A: BrowserStack app

Open the BrowserStack app in ChatGPT, add it, and sign in to BrowserStack.

Option B: Add the server with developer mode

You need a Plus, Pro, Business, Enterprise, or Edu plan. On Business, Enterprise, and Edu plans, a workspace admin might need to allow developer mode first.

To add the server, follow these steps:

Open Settings > Apps & Connectors > Advanced settings and turn on Developer mode.
In Apps & Connectors, click Create.
Enter BrowserStack as the name and https://mcp.browserstack.com/mcp as the MCP server URL, and select OAuth as the authentication. Click Create.
Sign in to BrowserStack when prompted.
In a chat, open + > Developer mode and select BrowserStack.

Let your agent do the setup

Most AI coding agents can install, authenticate, and configure the server themselves. Copy and paste this prompt into your agent:

Copy

Add the server with your client’s own command

Many MCP clients have their own command or settings screen for adding a server. Use the following table to find the command or configuration for your client:

Client	Command or configuration
Claude Code	Run `claude mcp add --scope user --transport http browserstack https://mcp.browserstack.com/mcp`, and then run `/mcp` in a session to authenticate.
Codex	Run `codex mcp add browserstack --url https://mcp.browserstack.com/mcp`, and then run `codex mcp login browserstack` to sign in.
Claude (web and Desktop)	Go to Customize > Connectors > Add custom connector, with the URL `https://mcp.browserstack.com/mcp`.
ChatGPT	Go to Settings > Apps & Connectors > Create, with Developer mode on and the URL `https://mcp.browserstack.com/mcp`.
VS Code with GitHub Copilot	`code --add-mcp '{"name":"browserstack","type":"http","url":"https://mcp.browserstack.com/mcp"}'`
Cursor	Add `{"mcpServers":{"browserstack":{"url":"https://mcp.browserstack.com/mcp"}}}` to `~/.cursor/mcp.json`, and then select Needs login in Cursor Settings > MCP.
Gemini CLI	Run `gemini mcp add --scope user --transport http browserstack https://mcp.browserstack.com/mcp`, and then run `/mcp auth browserstack` in a Gemini session to sign in.
Windsurf	Go to Cascade > MCP servers > Add Server > Add custom server, with `serverUrl` set to `https://mcp.browserstack.com/mcp`.
Cline	Go to Manage MCP Servers > Remote Servers, enter the name `browserstack` and the URL `https://mcp.browserstack.com/mcp`, and then click Add Server.
Kiro	In the Command Palette, run Kiro: Open user MCP config (JSON), and then add `{"mcpServers":{"browserstack":{"url":"https://mcp.browserstack.com/mcp"}}}` to `~/.kiro/settings/mcp.json`.
Smithery	Open the BrowserStack MCP server on Smithery, select your client, and follow the install command shown.
Any other MCP client	Use the server URL `https://mcp.browserstack.com/mcp`.

Project-specific installation

A project-specific installation enables the MCP server for your project root folder using a configuration file stored in the project. Choose your client below.

The following steps use VS Code with GitHub Copilot:

Locate or create the configuration folder: In your project’s root directory, find or create a folder named .vscode.
Create mcp.json: Inside the .vscode folder, create a new file named mcp.json.
Add configuration: Paste the following JSON content into the mcp.json file:

Copy

The following steps use Cursor as the IDE:

In the project root, create .cursor/mcp.json.
Paste the following:

Copy

After you save the file, go to Cursor Settings > MCP, select Needs login, and sign in.

Claude Code reads project servers from .mcp.json in the project root. Add the server with the CLI:

Copy

Or create .mcp.json yourself:

Copy

Run /mcp in a Claude Code session to sign in.

For VS Code, use the VS Code tab. For Visual Studio, add .mcp.json to the solution folder:

Copy

Open Copilot Chat in Agent mode and check that the BrowserStack tools are listed under the tools icon.

Did this page help you?

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked

This page has exactly what I am looking for
This content & code samples are accurate and up-to-date
The content on this page is easy to understand
Other (please tell us more below)

Any additional feedback?

Thank you for your valuable feedback

Is this page helping you?

Yes

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked

This page has exactly what I am looking for
This content & code samples are accurate and up-to-date
The content on this page is easy to understand
Other (please tell us more below)

Any additional feedback?

Thank you for your valuable feedback!