​
Running the MCP Server

  1. Get your Browserbase API key and project ID from the Browserbase Dashboard. Go over the Dashboard’s Settings tab:

API Key

Then copy your API Key and Project ID directly from the input.

  1. Set up your Claude Client configuration to use the server. Set the BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID environment variables.

Using STDIO via NPM:

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["@browserbasehq/mcp"],
      "env": {
        "BROWSERBASE_API_KEY": "<YOUR_BROWSERBASE_API_KEY>",
        "BROWSERBASE_PROJECT_ID": "<YOUR_BROWSERBASE_PROJECT_ID>",
      }
    }
  }
}

Using SSE (Remote Server):

To run using SSE, you’ll need to clone the repo and port the server from your local machine.

# Clone the repo
git clone https://github.com/browserbase/mcp-server-browserbase

# Install dependencies
cd browserbase 
npm install

# Build the project
npm run build

Then run the server using the following command:

node cli.js --port 8931

Make sure you’re in the browserbase directory when running the command.

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8931/sse"],
      "env": {
        "BROWSERBASE_API_KEY": "<YOUR_BROWSERBASE_API_KEY>",
        "BROWSERBASE_PROJECT_ID": "<YOUR_BROWSERBASE_PROJECT_ID>",
      }
    }
  }
}
  1. Restart/refresh your Claude Client app and you should see the tools available clicking the 🔨 icon.

It’s as easy as that, get started using our MCP Server by asking Claude to navigate to any page and see your Browserbase Browser in action on the dashboard.

​
Further Reading

For more in-depth coverage, usage patterns, or troubleshooting: