跳转到主要内容

正在构建 AI 初创公司？

您可能符合我们的初创计划资格。获得本文所介绍基础设施的全额资助访问权限（最高价值 $20,000）。
将 Bright Data MCP 服务器添加到 OpenAI Codex CLI，让您的编码代理无需担心被封锁即可搜索、抓取和浏览实时网络。Codex 从 ~/.codex/config.toml 读取 MCP 服务器定义，您可以直接编辑该文件，或使用 codex mcp add 命令进行更新。

​
先决条件

  • 已安装并登录 Codex CLI
  • 已安装并更新 Node.js（仅自托管服务器需要）
  • 拥有 Bright Data 账户（新用户可获得免费测试额度，之后可按需付费）
  • 从 用户设置页面 获取 API 密钥（新用户将在欢迎邮件中收到 API 密钥）

​
托管 MCP

托管服务器无需本地安装。将以下表添加到 ~/.codex/config.toml，并将 <your-api-token> 替换为您的 Bright Data API 密钥： 
[mcp_servers.brightdata]
url = "https://mcp.brightdata.com/mcp?token=<your-api-token>"
[mcp_servers.<id>] 表使用 url 定义可流式传输的 HTTP 服务器。Bright Data 托管 MCP 通过 token 查询参数接受 API 密钥，因此无需单独的认证头。
如果您希望使用不同的 zone 名称，可通过 unlocker URL 参数指定，例如 ...?token=<your-api-token>&unlocker=<your-zone>。

​
自托管 MCP

自托管服务器通过 npx 在本地运行，并从环境变量读取您的 API 密钥。
1

使用 CLI 添加服务器

在终端中运行以下命令。-- 分隔符告诉 Codex 环境标志在哪里结束、服务器命令从哪里开始：
codex mcp add brightdata --env API_TOKEN=<your-api-token> -- npx -y @brightdata/mcp
2

或直接编辑 config.toml

或者，将以下表添加到 ~/.codex/config.toml：
[mcp_servers.brightdata]
command = "npx"
args = ["-y", "@brightdata/mcp"]

[mcp_servers.brightdata.env]
API_TOKEN = "<your-api-token>"

​
验证

通过列出已配置的 MCP 服务器来验证集成： 
codex mcp list
您应在输出中看到 brightdata，确认服务器已配置。启动 Codex 会话并让它抓取一个实时网页，以确认工具正常响应。