面向 AI 代理的 Arcade 与 Bright Data Web MCP

在本文中，你将了解：

Arcade 是什么、它提供的功能以及它解决的问题。
由于 Arcade 中现有的 Bright Data 集成而可用的工具。
如何在生产就绪的 AI 代理中使用 Arcade 来利用这些工具，包括在 Claude Desktop 和 Claude Code 中。

让我们开始吧！

Arcade 简介

了解 Arcade 带来了什么，以及为什么它相比将 AI 代理直接连接到 MCP 服务器具有优势。

什么是 Arcade？

Arcade 是一个基于云的 MCP 运行时，支持开发可用于生产环境的安全 AI 代理。

具体来说，它提供了 AI 模型与外部系统之间的基础设施层，通过自定义工具和 MCP 服务器进行连接。它通过处理身份验证、授权和工具执行来实现这一点。这样，AI 代理就可以以可扩展且安全的方式与应用（例如 Gmail、Slack 等）以及 AI 数据提供商（例如 Bright Data、Hugging Face 等）进行交互。

Arcade 最相关的一些功能包括：

安全认证：内置 OAuth 和用户委托权限，消除令牌管理的复杂性。
预构建连接器：为 GitHub、Slack、Gmail、Jira 等常用工具提供开箱即用的集成。
代理开发 SDK：构建自定义工具并将代理连接到任何 API 或数据源。
工具编排：一个运行时，可在多步骤工作流中选择并执行合适的工具。
多租户支持：专为需要按用户授权的大规模应用而设计。
部署灵活性：可在云端、VPC、本地或隔离网络环境中运行。

在官方文档中了解更多。

它为何存在以及它解决了哪些问题

正如你可能已经知道的，AI 代理在推理方面很强。然而，它们的知识仅限于它们训练所用的静态数据集。因此，它们缺乏对最新事件的上下文，也无法原生地与外部世界交互。

换句话说，AI 代理被困在“只读模式”中。为了克服这些限制，可信的代理式应用依赖外部数据访问以及与第三方应用的集成（例如，通过 MCP 或基于直接 API 的集成）。这使 AI 代理能够访问敏感数据（邮件、日历、CRM 记录）并代表用户执行操作。然而，这也正是问题开始出现的地方……

原因在于，将 AI 代理直接连接到 MCP 服务器或 API 需要处理 OAuth 流程、令牌存储、刷新逻辑、权限范围以及用户级访问控制。所有这些都很复杂、容易出错且难以保障安全。一旦你超越原型阶段，它很快就会成为主要瓶颈。

Arcade 通过提供可扩展的 MCP 运行时来解决这一点，该运行时负责认证和授权。它包含一个内置系统来管理 OAuth 2.0、API 密钥和用户令牌，确保代理能够以正确的权限安全地访问并操作外部服务。它还处理基于范围的授权，在需要时提示用户，并对代理可执行的操作实施细粒度控制。

与将代理直接连接到 MCP 服务器相比，Arcade 提供了多项优势：

无需为认证头疼：OAuth 流程、令牌刷新和权限均由系统完全管理。
用户级安全：代理使用委托权限执行操作，而不是共享凭据。
规模化可靠性：标准化的工具执行，减少集成边缘情况。
更快开发：开发者可以专注于代理逻辑而非基础设施。

简而言之，Arcade 旨在将 AI 代理从脆弱的原型转变为安全、生产就绪的系统。

Arcade 中可用的开发选项

下面是你在 AI 代理中使用 Arcade 的三种主要方式：

依赖预构建的 Arcade MCP 服务器：在 Arcade web 应用中可用的预构建 MCP 服务器中配置一个或多个（数十个）。然后，通过统一的 MCP Gateway 接口，将已配置的工具通过你的 IDE（例如 VS Code、Cursor）或 AI 应用（例如 Claude Desktop）暴露出来。
使用 Arcade MCP 服务器构建自定义工具：使用 arcade_mcp_server 包创建并部署你自己的 MCP 服务器。它提供了一个安全框架，而 Arcade CLI 可帮助脚手架搭建、配置并部署实现稳健集成所需的一切。
与代理框架和 MCP 客户端集成：使用 Arcade 的 SDK 连接 CrewAI、LangChain、OpenAI Agents 等框架。这使你无需从零构建基础设施，就能在 AI 应用中获得安全、可靠的工具调用能力。

Bright Data 与 Arcade 的集成

如前所述，AI 代理的两大主要限制是：

缺乏最新知识。
无法与外部世界交互（通常意味着无法与 web 交互）。

Bright Data 是领先的 web 数据平台，它提供 AI 就绪工具来专门应对这些挑战（以及更多）。

特别是，Bright Data 已作为 Arcade MCP 服务器正式提供：

该集成为大规模 web 搜索、爬虫和抓取提供企业级基础设施，并避免被封锁。Bright Data 以高性能实现对网页和结构化数据的可靠提取，达到 99.99% 的正常运行时间和 99.95% 的成功率。它由一个覆盖 195 个国家/地区、拥有超过 4 亿 IP 的代理网络提供支持，支持无限扩展。

通过 Arcade Bright Data MCP 服务器暴露的工具包括：

Brightdata.ScrapeAsMarkdown：使用 Bright Data 的网络解锁器 API 抓取网页并以 Markdown 格式返回内容（适合 LLM 摄取）。
Brightdata.SearchEngine：通过搜索引擎 API 使用高级参数在 Google、Bing 或 Yandex 上执行搜索。
Brightdata.WebDataFeed：通过 Bright Data 的网页爬虫工具 API 从 LinkedIn、Amazon、Instagram 等平台提取结构化数据。

这些工具共同为你的 AI 代理提供了搜索 web 并以AI 优化格式检索数据的能力。

通过 Arcade MCP 使用 Bright Data Web 数据检索工具：分步指南

通过其预构建的 MCP 服务器集成 Arcade 是最快且最简单的入门方式。因此，本教程部分聚焦于该方法。如果你希望将 Arcade Bright Data MCP 与 LangChain、CrewAI 或类似工具集成，请参考官方文档中的详细指南。

在开始之前，请记住 Arcade MCP Gateways 支持两种认证模式：

Arcade Auth：用户通过 OAuth 使用其 Arcade 账户进行认证。非常适合开发、测试和内部使用。
Arcade Headers：最终用户通过 Authorization 和 Arcade-User-ID 头进行认证，而不是直接通过 Arcade。更适合生产环境。

集成步骤取决于所选的认证模式。为展示两种方法，以下各节将展示如何连接 Bright Data Arcade MCP：

通过 Arcade Auth 连接到 Claude Desktop。
通过 Arcade Headers 连接到 Claude Code。

请注意，Claude Desktop 和 Claude Code 只是示例，你可以使用任何兼容 MCP 的解决方案！

通用步骤

无论你使用 Arcade Auth 还是 Arcade Headers 进行认证，都有一些对两种方法都通用的初始步骤。让我们从这些开始！

步骤 #1：开始使用 Arcade

如果你还没有这样做，请创建一个 Arcade 账户，或直接登录。登录后，进入你的账户控制面板，你应该会看到类似如下内容：

花点时间熟悉 UI 并探索可用选项。你的目标是创建一个 Arcade MCP Gateway。该机制允许你在 Arcade 平台中连接多个 MCP 服务器，并通过单一 MCP 接口将它们暴露出来，然后你可以将其连接到你的代理、应用或 IDE。

访问 “MCP gateways” 页面并点击 “Create MCP Gateway” 按钮：

使用如下内容填写 MCP Gateway 创建表单：

Name: Bright Data MCP.
Description: 一个用于连接 Bright Data 的 web 搜索、抓取和数据 feed 工具的 MCP gateway.
Instructions for the LLM: 每当你需要搜索 web、为特定站点（例如 LinkedIn、Instagram、Amazon）检索结构化数据 feed，或从任何网页提取数据时，请使用此 MCP gateway。
Slug: bright-data-mcp.
Authentication: Arcade Auth（我们将在专门章节中将其切换为 Arcade Headers）。
Allowed tools: 点击 “Select Tools”，搜索 “bright data”，勾选 Bright Data 工具，然后点击 “Use 3 Tools”。

现在你应该会看到如下内容：

注意 Arcade 正在警告你缺少两个必需设置：

brightdata_api_key.
brightdata_zone.

这两个 secret 是将 Arcade 连接到 Bright Data 所需的。别担心，我们将在接下来的步骤中处理它们。现在，仍然通过点击 “Create MCP Gateway” 按钮来创建 MCP gateway。

随后你会在表格中看到 “Bright Data MCP” 作为新条目列出：

太棒了！你由 Arcade 驱动并连接到 Bright Data 的 MCP gateway 现在已准备就绪。

步骤 #2：设置你的 Bright Data 账户

如前所述，Arcade Bright Data MCP 需要你配置这两个 secret：

BRIGHTDATA_API_KEY：你的 Bright Data API key。
BRIGHTDATA_ZONE：你的 Bright Data 网络解锁器区域名称。

这两个 secret 用于连接到 Bright Data 基于 API 的解决方案（网络解锁器、搜索引擎 API 和网页爬虫工具 API），它们为暴露的三个工具提供支持。

按照以下说明获取这两个 secret！

如果你没有 Bright Data 账户，创建一个新账户。否则，登录。接着，进入你的控制面板，前往 “Proxies & Scraping” 页面，并查看 “My Zones” 表：

如果已存在一个网络解锁器 API 区域（例如 web_unlocker），你可以进入 Bright Data API 创建步骤。

如果缺失，请滚动到 “Unblocker API” 卡片并点击 “Create 区域” 来创建一个：

仔细按照向导操作并为你的区域适当命名。有关详细说明，请参考官方设置指南。

最后，生成你的 Bright Data API key 并安全存储。

就是这样！你现在拥有将 Bright Data 连接到 Arcade 所需的两个 secret。

步骤 #3：在 Arcade MCP 中设置 Bright Data secret

现在你已经拥有所需的 secret，请在 Arcade 中设置它们。在你的账户控制面板中，进入 “Secrets” 页面并点击 “Add Secret” 按钮：

按如下方式填写 “Add New Secret” 表单：

ID: BRIGHTDATA_API_KEY
Value: <YOUR_BRIGHT_DATA_API_KEY>（替换为你之前获取的值）。

然后，点击 “Create Secret” 确认。

对第二个 secret 重复该过程：

ID: BRIGHTDATA_ZONE
Value: 你的 Bright Data 网络解锁器 API 区域（例如 web_unlocker 或你分配的名称）。

添加后，你的 Secrets 表应如下所示：

通过进入 “MCP Gateways” 页面、在 “Bright Data MCP” 条目上点击 “Edit” 并向下滚动，验证 Arcade 是否识别这些 secret。之前的警告消息现在应该消失了：

太棒了！你的 Arcade MCP Gateway 现在已完全配置好，并准备好暴露 Bright Data 工具。

在 Claude Desktop 中通过 Arcade Auth 连接到 Bright Data Arcade MCP

现在你将学习如何使用通过 Arcade Auth 的认证，将之前配置的 Bright Data Arcade MCP 连接到 Claude Desktop。为使本教程简洁，我们将假设你已经在本地安装并设置好 Claude Desktop。

请记住，下面的部分旨在演示通过 Arcade Auth 的 Arcade 方式实现 Bright Data 集成。有关连接其他 MCP 兼容解决方案的指导，请查看Arcade 文档。

注意：如果你想通过 MCP 将 Bright Data 直接集成到 Claude Desktop 中，请查看文档。

前提条件

要通过 Arcade Auth 将 Arcade 集成到 Claude Desktop 中，你必须创建一个自定义连接器。此功能仅对 Pro、Max、Team 和 Enterprise 用户可用。因此，你需要一个付费计划的 Claude 账户。

步骤 #4：添加一个新的自定义连接器

打开 Claude Desktop，点击左下角的用户头像，然后选择 “Settings” 选项：

在 “Settings” 页面中，进入 “Connectors” 选项卡并点击 “Add custom connector” 按钮：

太好了！你现在可以定义 Arcade 连接器了。

步骤 #5：配置 Arcade 连接器

将打开一个模态对话框以自定义你的新连接器。按如下方式填写：

Name: Arcade.
URL: https://api.arcade.dev/mcp/bright-data-mcp。（更一般地：https://api.arcade.dev/mcp/<YOUR_BRIGHT_DATA_MCP_GATEWAY_SLUG>。）

点击 “Add” 按钮继续。

你现在会在列表中看到新连接器。点击 “Connect” 以使用你的 Arcade 账户进行认证：

你的浏览器将打开一个新标签页进入 Arcade 网站进行认证。确认 URL 与模态对话框中的一致，然后点击 “Allow” 按钮：

太棒了！Claude Desktop 现在应该已连接到你的 Bright Data MCP Gateway。

步骤 #6：验证连接并配置 MCP Gateway

要验证 Arcade Bright Data MCP 服务器是否已正确连接到你的 Claude Desktop 应用，请进入 “Settings”，打开 “Connectors” 选项卡，并找到 Arcade 条目：

要查看可用工具（并配置其权限），点击 “Configure” 按钮。在配置面板中，你会注意到 Arcade Bright Data MCP 暴露的三个工具：

在这里，你还可以选择哪些工具对 Claude Desktop 可用，以及它们在执行前是否需要人工确认。

任务完成！你现在可以在 Claude Desktop 中开始一个新聊天，并通过 Arcade 自定义连接器获得 Bright Data 的 web 数据检索能力增强。

在 Claude Code 中通过 Arcade Headers 连接到 Bright Data Arcade MCP

在这里，你将被引导通过 Arcade Headers 将 Bright Data Arcade MCP 连接到 Claude Code。为使本节简短，我们将假设Claude Code 已在本地安装并设置好。

注意：如果你正在寻找通过 MCP 在 Claude Code 中直接集成 Bright Data，阅读完整指南。

步骤 #4：将认证方法更改为 Arcade Headers

在步骤 #1 中，你使用 Arcade Auth 在 Arcade 中配置了 Bright Data MCP Gateway。现在是时候更改它了。点击 “Bright Data MCP” 条目上的编辑图标：

然后，将 “Authentication” 字段设置为 “Arcade Headers” 选项：

最后，点击 “Update MCP Gateway” 按钮完成更新。

很酷！你的 Arcade Bright Data MCP 现在将使用基于 header 的认证进行暴露，使其非常适合与 Claude Code 集成。

步骤 #5：生成一个 API key

如前面看到的 MCP Gateway 更新表单中的 “Authentication” 字段所述，Arcade Headers 认证要求你设置以下 headers：

Authorization：通过 bearer token 提供你的 Arcade API key。
Arcade-User-ID：你的 Arcade 订阅邮箱。

你已经有了 Arcade 订阅邮箱，但你可能还没有一个 Arcade API key。要创建一个，请进入 “Get API key” 页面并点击 “Create API Key” 按钮：

为你的 API key 命名（例如 “Claude Code MCP”）并点击 “Create API Key”：

你将看到 API key token。将其存放在安全位置，因为你很快会用到它。该 API key 也会出现在 “API Keys” 表中：

非常好！你现在拥有将 Arcade Bright Data MCP Gateway 连接到 Claude Code 所需的一切。

步骤 #6：添加 Arcade Bright Data MCP

使用以下命令来添加你的 MCP gateway：

claude mcp add, transport http arcade "<YOUR_BRIGHT_DATA_MCP_GATEWAY_URL>" --header "Authorization: Bearer <YOUR_ARCADE_API_KEY>" --header "Arcade-User-ID: <YOUR_ARCADE_SUBSCRIPTION_EMAIL>"

其中 <YOUR_BRIGHT_DATA_MCP_GATEWAY_URL> 类似于 https://api.arcade.dev/mcp/<YOUR_MCP_GATEWAY_SLUG>（在本例中为 https://api.arcade.dev/mcp/bright-data-mcp）。

arcade MCP 将如下被添加到你的Claude 配置文件（~/.claude.json）中：

或者，你可以按如下方式手动配置你的 Claude JSON 文件：

"mcpServers": {
  "arcade": {
    "type": "http",
    "url": "https://api.arcade.dev/mcp/<YOUR_BRIGHT_DATA_MCP_GATEWAY_SLUG>",
    "headers": {
      "Authorization": "Bearer <YOUR_ARCADE_API_KEY>",
      "Arcade-User-ID": "[email protected]"
    }
  }
}

注意：类似的 JSON 配置也可应用于在许多其他 MCP 兼容工具中通过 Arcade Headers 使用 Arcade。

太棒了！由于 Arcade MCP 集成，Bright Data 工具现在应该已在 Claude Code 中可用。

步骤 #7：检查可用工具

要验证 Claude Code 是否已连接到 Arcade Bright Data MCP gateway，请运行：

claude mcp get arcade

这会检查你添加的 arcade MCP 的状态。结果应为：

现在，列出可用工具。先启动 Claude Code：

claude

然后，执行以下命令：

/mcp

选择 arcade MCP 服务器：

并选择 “View tools” 选项：

你现在应该会看到 Arcade 中可用的三个 Bright Data 工具：

做得好！你的本地编码助手现在可以通过 Arcade 访问 Bright Data 的 web 检索与搜索工具。

测试 Bright Data + Arcade MCP 集成

要验证通过 MCP 的 Bright Data + Arcade 集成是否正常工作，请发起如下提示：

Who won the 2026 Oscars? Search Google using 1,2 reliable sources to answer the question, then access their page content and return the list of winners for each category.

这是常规 LLM 无法单独处理的内容。因为它需要实时 web 搜索和抓取，才能回答模型尚未训练过的近期查询。

Claude 将首先请求你允许使用 Brightdata.SearchEngine 工具：