Usando o Arcade para Acessar as Ferramentas Web da Bright Data via MCP em Agentes de IA em Produção

Neste artigo, você aprenderá:

• O que é o Arcade, quais recursos ele oferece e quais problemas ele resolve.
• As ferramentas disponíveis graças à integração existente da Bright Data no Arcade.
• Como aproveitar essas ferramentas em agentes de IA prontos para produção usando o Arcade, tanto no Claude Desktop quanto no Claude Code.

Vamos começar!

Uma Introdução ao Arcade

Entenda o que o Arcade oferece e por que ele apresenta vantagens em relação à conexão direta de agentes de IA a servidores MCP.

O que é o Arcade?

Arcade é um runtime MCP baseado em nuvem que apoia o desenvolvimento de agentes de IA seguros para produção.

Em detalhes, ele fornece a camada de infraestrutura entre modelos de IA e sistemas externos, conectados por meio de ferramentas personalizadas e servidores MCP. Isso é alcançado gerenciando autenticação, autorização e execução de ferramentas. Dessa forma, os agentes de IA podem interagir com aplicativos (por exemplo, Gmail, Slack etc.) e provedores de dados de IA (por exemplo, Bright Data, Hugging Face etc.) de forma escalável e segura.

Alguns dos recursos mais relevantes do Arcade incluem:

• Autenticação segura: OAuth integrado e permissões delegadas por usuário, eliminando a complexidade do gerenciamento de tokens.
• Conectores pré-construídos: Integrações prontas para uso com ferramentas populares como GitHub, Slack, Gmail, Jira e muito mais.
• SDK de desenvolvimento de agentes: Crie ferramentas personalizadas e conecte agentes a qualquer API ou fonte de dados.
• Orquestração de ferramentas: Um runtime que seleciona e executa as ferramentas apropriadas em fluxos de trabalho de múltiplas etapas.
• Suporte a múltiplos inquilinos: Projetado para aplicações que exigem autorização por usuário em escala.
• Flexibilidade de implantação: Execute na nuvem, em uma VPC, on-premises ou em ambientes isolados (air-gapped).

Descubra mais na documentação oficial.

Por que Ele Existe e Quais Problemas Ele Resolve

Como você provavelmente já sabe, os agentes de IA são ótimos em raciocínio. No entanto, seu conhecimento é limitado aos conjuntos de dados estáticos com os quais foram treinados. Como resultado, eles não têm contexto sobre eventos recentes e não conseguem interagir nativamente com o mundo externo.

Em outras palavras, os agentes de IA ficam presos no “modo somente leitura”. Para superar essas limitações, aplicações agênticas confiáveis dependem de acesso a dados externos e integrações com aplicativos de terceiros (por exemplo, via MCP ou integrações diretas baseadas em API). Isso permite que os agentes de IA acessem dados sensíveis (e-mails, calendários, registros de CRM) e ajam em nome dos usuários. Ainda assim, é aí que as coisas começam a se complicar…

O motivo é que conectar agentes de IA diretamente a servidores MCP ou APIs requer lidar com fluxos OAuth, armazenamento de tokens, lógica de renovação, escopos de permissão e controle de acesso por usuário. Tudo isso é complexo, sujeito a erros e difícil de proteger. Assim que você vai além de um protótipo, rapidamente se torna um grande gargalo.

O Arcade resolve isso fornecendo um runtime MCP escalável que cuida de autenticação e autorização. Ele inclui um sistema integrado para gerenciar OAuth 2.0, chaves de API e tokens de usuário, garantindo que os agentes possam acessar e agir com segurança sobre serviços externos com as permissões corretas. Ele também gerencia autorização baseada em escopos, solicitando aos usuários quando necessário e aplicando controle refinado sobre o que um agente pode fazer.

Em comparação com conectar agentes diretamente a servidores MCP, o Arcade oferece várias vantagens:

• Sem dores de cabeça com autenticação: Fluxos OAuth, renovação de tokens e permissões são totalmente gerenciados.
• Segurança por usuário: Os agentes atuam com permissões delegadas, não com credenciais compartilhadas.
• Confiabilidade em escala: Execução padronizada de ferramentas com menos casos extremos de integração.
• Desenvolvimento mais rápido: Os desenvolvedores podem focar na lógica do agente em vez de infraestrutura.

Em resumo, o Arcade visa transformar agentes de IA de protótipos frágeis em sistemas seguros e prontos para produção.

Opções de Desenvolvimento Disponíveis no Arcade

Abaixo estão as três principais maneiras de usar o Arcade em seu agente de IA:

• Usar servidores MCP pré-construídos do Arcade: Configure um ou mais dos dezenas de servidores MCP pré-construídos disponíveis no Arcade web app. Em seguida, exponha as ferramentas configuradas por meio do seu IDE (por exemplo, VS Code, Cursor) ou apps de IA (por exemplo, Claude Desktop) via uma interface MCP Gateway unificada.
• Criar ferramentas personalizadas com o Arcade MCP Server: Crie e implante seus próprios servidores MCP usando o pacote arcade_mcp_server. Ele fornece um framework seguro, enquanto o Arcade CLI ajuda a criar o scaffolding, configurar e implantar tudo o que é necessário para integrações sólidas.
• Integrar com frameworks de agentes e clientes MCP: Use o SDK do Arcade para conectar com frameworks como CrewAI, LangChain, OpenAI Agents e outros. Isso habilita capacidades de chamada de ferramentas seguras e confiáveis nos seus aplicativos de IA sem precisar construir infraestrutura do zero.

Integração da Bright Data com o Arcade

Como destacado anteriormente, as duas principais limitações dos agentes de IA são:

1. A falta de conhecimento atualizado.
2. A incapacidade de interagir com o mundo externo (o que geralmente se traduz na incapacidade de interagir com a web).

Bright Data é a principal plataforma de dados web e fornece ferramentas prontas para IA para abordar especificamente esses desafios (e muito mais).

Em particular, a Bright Data está oficialmente disponível como servidor MCP do Arcade:

Essa integração fornece infraestrutura pronta para empresas para busca web em grande escala, rastreamento e scraping sem ser bloqueado. A Bright Data permite extração confiável de páginas web e dados estruturados com alto desempenho, alcançando 99,99% de uptime e 99,95% de taxa de sucesso. É apoiada por uma rede de proxies com mais de 400 milhões de IPs em 195 países, suportando escalabilidade ilimitada.

As ferramentas expostas pelo Arcade Bright Data MCP Server são:

• Brightdata.ScrapeAsMarkdown: Faz scraping de uma página web e retorna o conteúdo em formato Markdown (ideal para ingestão por LLMs) usando a API Web Unlocker da Bright Data.
• Brightdata.SearchEngine: Realiza buscas no Google, Bing ou Yandex com parâmetros avançados via SERP API.
• Brightdata.WebDataFeed: Extrai dados estruturados de plataformas como LinkedIn, Amazon e Instagram por meio das APIs de Web Scraping da Bright Data.

Juntas, essas ferramentas equipam seu agente de IA com a capacidade de pesquisar na web e recuperar dados em um formato otimizado para IA.

Usando as Ferramentas de Recuperação de Dados Web da Bright Data via Arcade MCP: Um Guia Passo a Passo

Integrar o Arcade por meio de seus servidores MCP pré-construídos é a maneira mais rápida e simples de começar. Portanto, esta seção do tutorial foca nessa abordagem. Se, em vez disso, você deseja integrar o Arcade Bright Data MCP com frameworks como LangChain, CrewAI ou ferramentas similares, consulte os guias detalhados na documentação oficial.

Antes de começar, tenha em mente que os Arcade MCP Gateways suportam dois modos de autenticação:

• Arcade Auth: Os usuários se autenticam com sua conta do Arcade via OAuth. É ideal para desenvolvimento, testes e uso interno.
• Arcade Headers: Os usuários finais se autenticam via cabeçalhos Authorization e Arcade-User-ID em vez de pelo Arcade diretamente. Isso é mais adequado para ambientes de produção.

As etapas de integração dependem do modo de autenticação escolhido. Para demonstrar ambas as abordagens, as seções a seguir mostram como conectar o Bright Data Arcade MCP:

1. Ao Claude Desktop via Arcade Auth.
2. Ao Claude Code via Arcade Headers.

Observe que o Claude Desktop e o Claude Code são apenas exemplos — você pode usar qualquer solução compatível com MCP!

Passos Comuns

Independentemente de você usar Arcade Auth ou Arcade Headers para autenticação, há algumas etapas iniciais comuns a ambas as abordagens. Vamos começar com elas!

Passo #1: Comece com o Arcade

Crie uma conta no Arcade se ainda não tiver feito isso, ou simplesmente faça login. Após o login, vá para o painel da sua conta — você deverá ver algo como isso:

Reserve um tempo para se familiarizar com a interface e explorar as opções disponíveis. Seu objetivo é criar um Arcade MCP Gateway. Esse mecanismo permite conectar vários servidores MCP na sua plataforma do Arcade e expô-los por meio de uma única interface MCP, que você pode conectar ao seu agente, aplicativo ou IDE.

Acesse a página “MCP gateways” e pressione o botão “Create MCP Gateway”:

Preencha o formulário de criação do MCP Gateway com algo como:

• Nome: Bright Data MCP.
• Descrição: Um gateway MCP para conectar às ferramentas de busca web, scraping e feed de dados da Bright Data.
• Instruções para o LLM: Use este gateway MCP sempre que precisar pesquisar na web, recuperar feeds de dados estruturados de sites específicos (por exemplo, LinkedIn, Instagram, Amazon) ou extrair dados de qualquer página web.
• Slug: bright-data-mcp.
• Autenticação: Arcade Auth (vamos mudar para Arcade Headers no capítulo dedicado).
• Ferramentas permitidas: Pressione “Select Tools”, pesquise por “bright data”, marque as ferramentas da Bright Data e clique em “Use 3 Tools”.

Isso é o que você deverá ver agora:

Observe como o Arcade está alertando que duas configurações obrigatórias estão faltando:

• brightdata_api_key.
• brightdata_zone.

Esses são os dois segredos necessários para conectar o Arcade à Bright Data. Não se preocupe, pois lidaremos com eles nas próximas etapas. Por ora, prossiga criando o gateway MCP mesmo assim, pressionando o botão “Create MCP Gateway”.

Você verá então “Bright Data MCP” listado como uma nova entrada na tabela:

Incrível! Seu gateway MCP alimentado pelo Arcade e conectado à Bright Data está pronto.

Passo #2: Configure sua Conta na Bright Data

Como mencionado anteriormente, o Arcade Bright Data MCP exige que você configure esses dois segredos:

• BRIGHTDATA_API_KEY: Sua chave de API da Bright Data.
• BRIGHTDATA_ZONE: O nome da zona Web Unlocker da Bright Data.

Esses dois segredos são utilizados para conectar às soluções baseadas em API da Bright Data (Web Unlocker, SERP API e APIs de Web Scraping), que alimentam as três ferramentas expostas.

Siga as instruções abaixo para recuperar ambos!

Se você não tem uma conta na Bright Data, crie uma nova. Caso contrário, faça login. Em seguida, navegue até o painel de controle, vá para a página “Proxies & Scraping” e verifique a tabela “My Zones”:

Se uma zona da Web Unlocker API (por exemplo, web_unlocker) já existir, você pode avançar para a etapa de criação da chave de API da Bright Data.

Se estiver faltando, crie uma rolando até o cartão “Unblocker API” e clicando em “Create zone”:

Siga o assistente cuidadosamente e nomeie sua zona de forma adequada. Para instruções detalhadas, consulte o guia de configuração oficial.

Por fim, gere sua chave de API da Bright Data e armazene-a com segurança.

Pronto! Você agora tem os dois segredos necessários para conectar a Bright Data ao Arcade.

Passo #3: Configure os Segredos da Bright Data no Arcade MCP

Agora que você tem os segredos necessários, configure-os no Arcade. No painel da sua conta, vá para a página “Secrets” e clique no botão “Add Secret”:

Preencha o formulário “Add New Secret” da seguinte forma:

• ID: BRIGHTDATA_API_KEY
• Valor: <YOUR_BRIGHT_DATA_API_KEY> (substitua pelo valor recuperado anteriormente).

Em seguida, clique em “Create Secret” para confirmar.

Repita o processo para o segundo segredo:

• ID: BRIGHTDATA_ZONE
• Valor: Sua zona da Web Unlocker API da Bright Data (por exemplo, web_unlocker ou o nome que você atribuiu).

Após adicionados, sua tabela de Secrets deve ficar assim:

Verifique se o Arcade reconhece os segredos acessando a página “MCP Gateways”, clicando em “Edit” na entrada “Bright Data MCP” e rolando para baixo. A mensagem de aviso anterior deve ter sumido:

Fantástico! Seu Arcade MCP Gateway agora está totalmente configurado e pronto para expor as ferramentas da Bright Data.

Conectar ao Bright Data Arcade MCP via Arcade Auth no Claude Desktop

Agora você aprenderá como conectar o Bright Data Arcade MCP, configurado anteriormente, ao Claude Desktop usando autenticação via Arcade Auth. Para manter este tutorial conciso, assumiremos que você já tem o Claude Desktop instalado e configurado localmente.

Tenha em mente que a seção abaixo destina-se a demonstrar como a integração da Bright Data via Arcade funciona por meio do Arcade Auth. Para orientações sobre como conectar outras soluções compatíveis com MCP, confira a documentação do Arcade.

Nota: Se você quiser integrar a Bright Data diretamente ao Claude Desktop via MCP, explore a documentação.

Pré-requisitos

Para integrar o Arcade ao Claude Desktop via Arcade Auth, você deve criar um conector personalizado. Este recurso está disponível apenas para usuários Pro, Max, Team e Enterprise. Portanto, você precisa de uma conta do Claude com um plano pago.

Passo #4: Adicione um Novo Conector Personalizado

Abra o Claude Desktop, clique no avatar do usuário no canto inferior esquerdo e selecione a opção “Settings”:

Na página “Settings”, vá para a aba “Connectors” e clique no botão “Add custom connector”:

Ótimo! Agora você pode definir o conector do Arcade.

Passo #5: Configure o Conector do Arcade

Um diálogo modal será aberto para personalizar seu novo conector. Preencha-o da seguinte forma:

• Nome: Arcade.
• URL: https://api.arcade.dev/mcp/bright-data-mcp. (De forma mais geral: https://api.arcade.dev/mcp/<YOUR_BRIGHT_DATA_MCP_GATEWAY_SLUG>.)

Prossiga clicando no botão “Add”.

Você verá agora o novo conector na sua lista. Clique em “Connect” para se autenticar com sua conta do Arcade:

Seu navegador abrirá uma nova aba no site do Arcade para autenticação. Verifique se a URL corresponde à do diálogo modal e clique no botão “Allow”:

Ótimo! O Claude Desktop agora deve estar conectado ao seu Bright Data MCP Gateway.

Passo #6: Verifique a Conexão e Configure o MCP Gateway

Para verificar se o servidor Arcade Bright Data MCP está conectado corretamente ao seu app Claude Desktop, vá para “Settings”, abra a aba “Connectors” e localize a entrada do Arcade:

Para ver as ferramentas disponíveis (e configurar suas permissões), clique no botão “Configure”. No painel de configuração, você verá as três ferramentas expostas pelo Arcade Bright Data MCP:

Aqui, você também pode escolher quais ferramentas estão disponíveis para o Claude Desktop e se elas exigem confirmação humana antes da execução.

Missão cumprida! Você pode agora iniciar uma nova conversa no Claude Desktop, aprimorada com as capacidades de recuperação de dados web da Bright Data por meio do conector personalizado do Arcade.

Conectar ao Bright Data Arcade MCP via Arcade Headers no Claude Code

Aqui, você será guiado pela conexão do Bright Data Arcade MCP ao Claude Code usando Arcade Headers. Para manter esta seção curta, assumiremos que o Claude Code já está instalado e configurado localmente.

Nota: Se você estiver buscando uma integração direta da Bright Data no Claude Code via MCP, leia o guia completo.

Passo #4: Altere o Método de Autenticação para Arcade Headers

No Passo #1, você configurou o Bright Data MCP Gateway no Arcade usando Arcade Auth. Agora é hora de mudar isso. Clique no ícone de edição na entrada “Bright Data MCP”:

Em seguida, defina o campo “Authentication” para a opção “Arcade Headers”:

Por fim, clique no botão “Update MCP Gateway” para concluir a atualização.

Ótimo! Seu Arcade Bright Data MCP agora será exposto usando autenticação baseada em cabeçalhos, tornando-o ideal para integração com o Claude Code.

Passo #5: Gere uma Chave de API

Como mencionado no campo “Authentication” do formulário de atualização do MCP Gateway visto anteriormente, a autenticação via Arcade Headers exige que você configure os seguintes cabeçalhos:

• Authorization: Sua chave de API do Arcade via um bearer token.
• Arcade-User-ID: Seu e-mail de assinatura do Arcade.

Você já tem seu e-mail de assinatura do Arcade, mas pode ainda não ter uma chave de API do Arcade. Para criar uma, vá para a página “Get API key” e clique no botão “Create API Key”:

Dê um nome à sua chave de API (por exemplo, “Claude Code MCP”) e clique em “Create API Key”:

Você verá o token da chave de API. Armazene-o em um lugar seguro, pois você precisará dele em breve. A chave de API também aparecerá na tabela “API Keys”:

Excelente! Você agora tem tudo o que precisa para conectar o Arcade Bright Data MCP Gateway ao Claude Code.

Passo #6: Adicione o Arcade Bright Data MCP

Use o seguinte comando para adicionar seu gateway MCP:

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>"

Onde <YOUR_BRIGHT_DATA_MCP_GATEWAY_URL> é algo como https://api.arcade.dev/mcp/<YOUR_MCP_GATEWAY_SLUG> (neste caso, https://api.arcade.dev/mcp/bright-data-mcp).

O MCP arcade será adicionado ao seu arquivo de configuração do Claude (~/.claude.json) da seguinte forma:

Alternativamente, você pode configurar manualmente seu arquivo JSON do Claude da seguinte forma:

"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]"
    }
  }
}

Nota: Uma configuração JSON similar pode ser aplicada para usar o Arcade via Arcade Headers em muitas outras ferramentas compatíveis com MCP.

Excelente! As ferramentas da Bright Data agora devem estar disponíveis no Claude Code graças à integração com o Arcade MCP.

Passo #7: Verifique as Ferramentas Disponíveis

Para verificar se o Claude Code está conectado ao gateway MCP Arcade Bright Data, execute:

claude mcp get arcade

Isso verifica o status do MCP arcade que você adicionou. O resultado deve ser:

Agora, liste as ferramentas disponíveis. Comece iniciando o Claude Code:

claude

Em seguida, execute o seguinte comando:

/mcp

Selecione o servidor MCP arcade:

E escolha a opção “View tools”:

Você deverá ver agora as três ferramentas da Bright Data disponíveis no Arcade:

Muito bem! Seu assistente de codificação local agora tem acesso às ferramentas de recuperação web e busca da Bright Data via Arcade.

Testando a Integração Bright Data + Arcade MCP

Para verificar que a integração Bright Data + Arcade via MCP está funcionando, execute um prompt como este:

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.

Isso é algo que um LLM comum não consegue lidar por conta própria. Isso porque requer busca web ao vivo e scraping para responder a uma consulta recente para a qual o modelo não foi treinado.

O Claude primeiro solicitará sua permissão para usar a ferramenta Brightdata.SearchEngine:

Essa ferramenta chama a SERP API da Bright Data para pesquisar resultados relevantes (neste caso, “vencedores do Oscar 2026 Academy Awards”) no Google (ou no mecanismo de busca especificado).

Em seguida, o Claude selecionará as fontes mais relevantes e pedirá que você faça scraping delas via a ferramenta Brightdata.ScrapeAsMarkdown:

Depois de autorizar a execução da ferramenta nas páginas selecionadas, o resultado será:

Isso corresponde perfeitamente à lista de vencedores do Oscar de 2026.

Muito bem! O agente de IA completou com sucesso a tarefa graças às capacidades de exploração web fornecidas pela Bright Data via Arcade.

Conclusão

Neste artigo, você explorou como o Arcade aborda os desafios de autenticação e autorização típicos de integrações de terceiros em agentes de IA. Ao abstrair a camada de integração de ferramentas e reforçá-la com OAuth e um robusto framework de permissões, o Arcade ajuda a manter seus agentes de IA seguros.

Entre as centenas de ferramentas MCP pré-construídas disponíveis na plataforma, a Bright Data se destaca por expor acesso a algumas das ferramentas de dados mais relevantes e prontas para IA:

• Web Unlocker API para web scraping com saída em Markdown.
• APIs de Web Scraping para feeds de dados diretos de mais de 50 domínios.
• SERP API para busca web nos principais mecanismos de busca.

Aqui, você viu como conectar a Bright Data no Arcade e expô-la via um gateway MCP para agentes de IA em soluções compatíveis com MCP do mundo real. O resultado é um agente de IA mais poderoso e seguro, capaz de acessar dados web em tempo real em vez de adivinhar ou retornar respostas desatualizadas.

Crie uma conta na Bright Data hoje e descubra suas soluções de dados web prontas para IA!