Running the MCP Server

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

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: