Skip to main content

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).

​
Quick Install

To integrate Bright Data into Claude Code, simply copy this command to your terminal:
Use an API key with Admin permissions. Keys without Admin permissions may cause Claude Code to show a “Failed to connect” error in claude mcp list.

​
Self-hosted MCP

1

Prerequisites

Before you begin, ensure you have the following:
  • Claude Code is installed and configured
  • A Bright Data account (new users get free credit for testing, and then you can pay as you go)
  • A Bright Data Admin API key from the user settings page. The key must have Admin permissions to connect to the hosted Bright Data MCP server. 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 unlocker url parameter variable in your configuration
2

Basic Configuration

Add the Bright Data MCP server to your Claude Code configuration:
Replace YOUR_API_KEY with your actual API token from Bright Data.
3

Validation

Verify the integration by running:
You should see the following output confirming successful connection:

​
Troubleshooting

​
Why does claude mcp list show “Failed to connect”?

If claude mcp list fails to connect, confirm that the API key has Admin permissions. Generate a new Admin API key on the user settings page if needed, then remove and re-add the Bright Data MCP server configuration:
Run claude mcp list again to confirm that the brightdata server shows ✓ Connected.