Claude Desktop integration

Building an AI startup?

You might be eligible for our Startup Program. Get fully funded access to the infrastructure you’re reading about right now (up to $20K value).

Getting Started Video:

Hosted MCP

Get your API token

Go to Bright Data user settings
Copy your API token (it looks like: 2dceb1aa0***************************)

Configure your MCP server

Open Claude Desktop
Go to: Settings → Developer → Edit Config
Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE"
      ]
    }
  }
}

Replace YOUR_API_TOKEN_HERE with your actual API token from Step 1
Save and restart Claude Desktop

Test it works

Ask your AI: “Can you search Google for ‘weather today’?”
Claude will ask for permission - click “Allow”
You should see results!

Monitor usage

View your API usage at My Zones in your Bright Data dashboard
Your free tier includes 5,000 requests per month

Self-hosted MCP

Prerequisites

Before you begin, ensure you have the following:

Node.js is installed and up to date
A Bright Data account (new users get free credit for testing, and then you can pay as you go)
An API key from the user settings page (New users receive an API key in the welcome email.)

If you prefer to use a different zone name, you can specify it with the WEB_UNLOCKER_ZONE environment variable in your configuration

Basic Configuration

Go to Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json to include the following:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<insert your api key from https://brightdata.com/cp/setting/users>"     
      }
    }
  }
}

Advanced Configuration

If you want to use advanced features like rate limiting or custom zones, you can add more environment variables:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<insert your api key from https://brightdata.com/cp/setting/users>",
        "WEB_UNLOCKER_ZONE": "<Optional - if you want to use a specific name for web_unlocker, the name goes here. If not - REMOVE this field>",
        "BROWSER_ZONE": "<Optional - if you want to use a specific name for browser_api, the name goes here. If not - REMOVE this field>",
        "RATE_LIMIT": "<Optional - rate limit format, possible values: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s. If not in use - REMOVE this field>",
        "PRO_MODE": "<Optional - set to true to enable all 60+ tools>",
        "GROUPS": "<Optional - comma-separated tool groups, e.g., browser,ecommerce,social>",
        "TOOLS": "<Optional - comma-separated individual tool names to enable>"
      }
    }
  }
}

Introduction

Quick Start

For AI Agents

Use Cases

Integrations

Building an AI startup?

Hosted MCP

Self-hosted MCP

Building an AI startup?

​Hosted MCP

​Self-hosted MCP

Hosted MCP

Self-hosted MCP