Web search, page scraping, structured data extraction and remote browser automation over the public web via Bright Data.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add bright-data --env API_TOKEN='<API_TOKEN>' --env WEB_UNLOCKER_ZONE='<WEB_UNLOCKER_ZONE>' --env BROWSER_AUTH='<BROWSER_AUTH>' --env BROWSER_ZONE='<BROWSER_ZONE>' -- npx -y @brightdata/mcp~/.codex/config.toml
[mcp_servers.bright-data]
command = "npx"
args = ["-y", "@brightdata/mcp"]
env = { API_TOKEN = "<API_TOKEN>", WEB_UNLOCKER_ZONE = "<WEB_UNLOCKER_ZONE>", BROWSER_AUTH = "<BROWSER_AUTH>", BROWSER_ZONE = "<BROWSER_ZONE>" }
# codex mcp add bright-data --env API_TOKEN='<API_TOKEN>' --env WEB_UNLOCKER_ZONE='<WEB_UNLOCKER_ZONE>' --env BROWSER_AUTH='<BROWSER_AUTH>' --env BROWSER_ZONE='<BROWSER_ZONE>' -- npx -y @brightdata/mcp~/.cursor/mcp.json
{
"mcpServers": {
"bright-data": {
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<API_TOKEN>",
"WEB_UNLOCKER_ZONE": "<WEB_UNLOCKER_ZONE>",
"BROWSER_AUTH": "<BROWSER_AUTH>",
"BROWSER_ZONE": "<BROWSER_ZONE>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"bright-data": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<API_TOKEN>",
"WEB_UNLOCKER_ZONE": "<WEB_UNLOCKER_ZONE>",
"BROWSER_AUTH": "<BROWSER_AUTH>",
"BROWSER_ZONE": "<BROWSER_ZONE>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"bright-data": {
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<API_TOKEN>",
"WEB_UNLOCKER_ZONE": "<WEB_UNLOCKER_ZONE>",
"BROWSER_AUTH": "<BROWSER_AUTH>",
"BROWSER_ZONE": "<BROWSER_ZONE>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"bright-data": {
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<API_TOKEN>",
"WEB_UNLOCKER_ZONE": "<WEB_UNLOCKER_ZONE>",
"BROWSER_AUTH": "<BROWSER_AUTH>",
"BROWSER_ZONE": "<BROWSER_ZONE>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"bright-data": {
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<API_TOKEN>",
"WEB_UNLOCKER_ZONE": "<WEB_UNLOCKER_ZONE>",
"BROWSER_AUTH": "<BROWSER_AUTH>",
"BROWSER_ZONE": "<BROWSER_ZONE>"
}
}
}
}Environment variables
API_TOKENWEB_UNLOCKER_ZONEBROWSER_AUTHBROWSER_ZONE
Replace the placeholders with your own credentials and keep them out of version control.