Usar Arcade para acceder a las herramientas web de Bright Data a través de MCP en agentes de IA en producción

En este artículo aprenderás:

• Qué es Arcade, las funciones que ofrece y los problemas que resuelve.
• Las herramientas disponibles gracias a la integración de Bright Data en Arcade.
• Cómo aprovechar estas herramientas en agentes de IA listos para producción usando Arcade, tanto en Claude Desktop como en Claude Code.

¡Comencemos!

Introducción a Arcade

Comprende qué aporta Arcade y por qué ofrece ventajas frente a conectar agentes de IA directamente a servidores MCP.

¿Qué es Arcade?

Arcade es un runtime MCP basado en la nube que apoya el desarrollo de agentes de IA seguros para producción.

En detalle, proporciona la capa de infraestructura entre los modelos de IA y los sistemas externos, conectados a través de herramientas personalizadas y servidores MCP. Lo logra manejando la autenticación, la autorización y la ejecución de herramientas. De esa manera, los agentes de IA pueden interactuar con aplicaciones (por ejemplo, Gmail, Slack, etc.) y proveedores de datos de IA (por ejemplo, Bright Data, Hugging Face, etc.) de forma escalable y segura.

Some of Arcade’s most relevant features include:

• Autenticación segura: OAuth integrado y permisos delegados por usuario, lo que elimina la complejidad de la gestión de tokens.
• Conectores prediseñados: Integraciones listas para usar con herramientas populares como GitHub, Slack, Gmail, Jira y más.
• SDK para el desarrollo de agentes: Crea herramientas personalizadas y conecta agentes a cualquier API o fuente de datos.
• Orquestación de herramientas: Un runtime que selecciona y ejecuta las herramientas adecuadas en flujos de trabajo de varios pasos.
• Soporte multi-inquilino: Diseñado para aplicaciones que requieren autorización por usuario a gran escala.
• Flexibilidad de despliegue: Ejecuta en la nube, en una VPC, en las instalaciones o en entornos aislados.

Descubre más en la documentación oficial.

Por qué existe y qué problemas resuelve

Como probablemente ya sabes, los agentes de IA son excelentes para razonar. Sin embargo, su conocimiento se limita a los conjuntos de datos estáticos con los que fueron entrenados. Como resultado, carecen de contexto sobre eventos recientes y no pueden interactuar de forma nativa con el mundo externo.

En otras palabras, los agentes de IA están atrapados en “modo de solo lectura”. Para superar estas limitaciones, las aplicaciones agénticas confiables dependen del acceso a datos externos y de integraciones con aplicaciones de terceros (por ejemplo, a través de MCP o integraciones directas basadas en API). Esto permite a los agentes de IA acceder a datos confidenciales (correos electrónicos, calendarios, registros de CRM) y actuar en nombre de los usuarios. Sin embargo, es ahí donde las cosas empiezan a complicarse…

La razón es que conectar agentes de IA directamente a servidores MCP o APIs requiere gestionar flujos de OAuth, almacenamiento de tokens, lógica de renovación, ámbitos de permisos y control de acceso a nivel de usuario. Todo esto es complejo, propenso a errores y difícil de asegurar. Tan pronto como superas el prototipo, rápidamente se convierte en un cuello de botella importante.

Arcade resuelve esto proporcionando un runtime MCP escalable que se encarga de la autenticación y la autorización. Incluye un sistema integrado para gestionar OAuth 2.0, claves de API y tokens de usuario, lo que garantiza que los agentes puedan acceder de forma segura y actuar en servicios externos con los permisos correctos. También gestiona la autorización basada en ámbitos, solicitando a los usuarios cuando sea necesario y aplicando un control detallado sobre lo que puede hacer un agente.

En comparación con la conexión directa de agentes a servidores MCP, Arcade ofrece varias ventajas:

• Sin problemas de autenticación: Los flujos de OAuth, la renovación de tokens y los permisos se gestionan de forma completa.
• Seguridad a nivel de usuario: Los agentes actúan con permisos delegados, no con credenciales compartidas.
• Fiabilidad a escala: Ejecución estandarizada de herramientas con menos casos extremos de integración.
• Desarrollo más rápido: Los desarrolladores pueden centrarse en la lógica del agente en lugar de la infraestructura.

En resumen, Arcade aspira a transformar los agentes de IA de prototipos frágiles en sistemas seguros y listos para producción.

Opciones de desarrollo disponibles en Arcade

A continuación se presentan las tres formas principales de usar Arcade en tu agente de IA:

• Utilizar servidores MCP de Arcade prediseñados: Configura uno o más de las docenas de servidores MCP prediseñados disponibles en la aplicación web de Arcade. Luego, expón las herramientas configuradas a través de tu IDE (por ejemplo, VS Code, Cursor) o aplicaciones de IA (por ejemplo, Claude Desktop) mediante una interfaz unificada de MCP Gateway.
• Crear herramientas personalizadas con Arcade MCP Server: Crea y despliega tus propios servidores MCP usando el paquete arcade_mcp_server. Proporciona un framework seguro, mientras que la CLI de Arcade ayuda a estructurar, configurar y desplegar todo lo necesario para integraciones sólidas.
• Integrate with agent frameworks and MCP clients: Employ Arcade’s SDK to connect with frameworks like CrewAI, LangChain, OpenAI Agents, and others. This enables secure, reliable tool-calling capabilities in your AI applications without building infrastructure from scratch.

Integración de Bright Data con Arcade

Como se destacó anteriormente, las dos principales limitaciones de los agentes de IA son:

1. La falta de conocimiento actualizado.
2. La incapacidad de interactuar con el mundo externo (lo que generalmente se traduce en la incapacidad de interactuar con la web).

Bright Data es la plataforma líder de datos web y proporciona herramientas listas para IA para abordar específicamente esos desafíos (y más).

En particular, Bright Data está disponible oficialmente como servidor MCP de Arcade:

Esta integración proporciona infraestructura lista para empresas para búsqueda web a gran escala, rastreo y scraping sin bloqueos. Bright Data permite la extracción confiable de páginas web y datos estructurados con alto rendimiento, alcanzando un 99,99% de tiempo de actividad y una tasa de éxito del 99,95%. Está respaldada por una red de proxies de más de 400 millones de IPs en 195 países, con escalabilidad ilimitada.

Las herramientas expuestas a través del servidor MCP de Arcade con Bright Data son:

• Brightdata.ScrapeAsMarkdown: Scrapes a webpage and returns content in Markdown format (ideal for LLM ingestion) using Bright Data’s Web Unlocker API.
• Brightdata.SearchEngine: Realiza búsquedas en Google, Bing o Yandex con parámetros avanzados a través de la SERP API.
• Brightdata.WebDataFeed: Extracts structured data from platforms like LinkedIn, Amazon, and Instagram through Bright Data’s Web Scraping APIs.

En conjunto, estas herramientas equipan a tu agente de IA con la capacidad de buscar en la web y recuperar datos en un formato optimizado para IA.

Uso de las herramientas de recuperación de datos web de Bright Data a través del MCP de Arcade: guía paso a paso

Integrar Arcade a través de sus servidores MCP prediseñados es la forma más rápida y sencilla de comenzar. Por eso, esta sección del tutorial se centra en ese enfoque. Si en cambio buscas integrar el MCP de Arcade con Bright Data con frameworks como LangChain, CrewAI o herramientas similares, consulta las guías detalladas en la documentación oficial.

Antes de comenzar, ten en cuenta que los gateways MCP de Arcade admiten dos modos de autenticación:

• Arcade Auth: Los usuarios se autentican con su cuenta de Arcade a través de OAuth. Es ideal para desarrollo, pruebas y uso interno.
• Arcade Headers: Los usuarios finales se autentican a través de los encabezados Authorization y Arcade-User-ID en lugar de autenticarse directamente con Arcade. Esto es más adecuado para entornos de producción.

Los pasos de integración dependen del modo de autenticación elegido. Para demostrar ambos enfoques, las siguientes secciones muestran cómo conectar el MCP de Arcade con Bright Data:

1. A Claude Desktop mediante Arcade Auth.
2. A Claude Code mediante Arcade Headers.

Ten en cuenta que Claude Desktop y Claude Code son solo ejemplos; puedes usar cualquier solución compatible con MCP.

Pasos comunes

No matter whether you use Arcade Auth or Arcade Headers for authentication, there are some initial steps that are common to both approaches. Let’s start with those!

Paso 1: Comenzar con Arcade

Crea una cuenta de Arcade si aún no lo has hecho, o simplemente inicia sesión. Una vez que hayas iniciado sesión, ve al panel de tu cuenta y deberías ver algo como esto:

Tómate un momento para familiarizarte con la interfaz y explorar las opciones disponibles. Tu objetivo es crear un gateway MCP de Arcade. Este mecanismo te permite conectar múltiples servidores MCP en tu plataforma de Arcade y exponerlos a través de una única interfaz MCP, que luego puedes conectar a tu agente, aplicación o IDE.

Visit the “MCP gateways” page and press the “Create MCP Gateway” button:

Completa el formulario de creación del MCP Gateway con algo como:

• Nombre: Bright Data MCP.
• Descripción: An MCP gateway to connect to Bright Data's web search, scraping, and data feed tools.
• Instrucciones para el LLM: Use this MCP gateway whenever you need to search the web, retrieve structured data feeds for specific sites (e.g., LinkedIn, Instagram, Amazon), or extract data from any webpage.
• Slug: bright-data-mcp.
• Autenticación: Arcade Auth (lo cambiaremos a Arcade Headers en el capítulo dedicado).
• Allowed tools: Press “Select Tools”, search for “bright data,” check the Bright Data tools, and click “Use 3 Tools”.

Esto es lo que deberías ver ahora:

Observa cómo Arcade te advierte que faltan dos configuraciones requeridas:

• brightdata_api_key.
• brightdata_zone.

Estos son los dos secretos necesarios para conectar Arcade con Bright Data. No te preocupes, los gestionaremos en los siguientes pasos. Por ahora, procede a crear el gateway MCP de todos modos presionando el botón “Create MCP Gateway”.

Luego verás “Bright Data MCP” listado como una nueva entrada en la tabla:

¡Genial! Tu gateway MCP impulsado por Arcade conectado a Bright Data ya está listo.

Paso 2: Configurar tu cuenta de Bright Data

Como se mencionó anteriormente, el MCP de Arcade con Bright Data requiere que configures estos dos secretos:

• BRIGHTDATA_API_KEY: Tu clave de API de Bright Data.
• BRIGHTDATA_ZONE: El nombre de zona de Web Unlocker de Bright Data.

These two secrets are utilized to connect to Bright Data’s API-based solutions (Web Unlocker, SERP API, and Web Scraping APIs), which power the three exposed tools.

¡Sigue las instrucciones a continuación para obtener ambos!

If you do not have a Bright Data account, create a new one. Otherwise, log in. Next, navigate to your control panel, go to the “Proxies & Scraping” page, and check the “My Zones” table:

Si ya existe una zona de la API Web Unlocker (por ejemplo, web_unlocker), puedes pasar al paso de creación de la API de Bright Data.

If it is missing, create one by scrolling to the “Unblocker API” card and clicking “Create zone”:

Sigue el asistente cuidadosamente y ponle un nombre apropiado a tu zona. Para instrucciones detalladas, consulta la guía de configuración oficial.

Finalmente, genera tu clave de API de Bright Data y guárdala de forma segura.

¡Eso es todo! Ahora tienes ambos secretos necesarios para conectar Bright Data con Arcade.

Paso 3: Configurar los secretos de Bright Data en el MCP de Arcade

Now that you have the required secrets, set them in Arcade. In your account dashboard, go to the “Secrets” page and click the “Add Secret” button:

Fill out the “Add New Secret” form as follows:

• ID: BRIGHTDATA_API_KEY
• Valor: <YOUR_BRIGHT_DATA_API_KEY> (reemplaza con el valor que obtuviste anteriormente).

Then, click “Create Secret” to confirm.

Repite el proceso para el segundo secreto:

• ID: BRIGHTDATA_ZONE
• Valor: Tu zona de la API Web Unlocker de Bright Data (por ejemplo, web_unlocker o el nombre que le asignaste).

Una vez agregados, tu tabla de Secrets debería verse así:

Verify that Arcade recognizes the secrets by going to the “MCP Gateways” page, clicking “Edit” on the “Bright Data MCP” entry, and scrolling down. The previous warning message should now be gone:

¡Fantástico! Tu gateway MCP de Arcade ya está completamente configurado y listo para exponer las herramientas de Bright Data.

Conectar el MCP de Arcade con Bright Data mediante Arcade Auth en Claude Desktop

Ahora aprenderás a conectar el MCP de Arcade con Bright Data, configurado anteriormente, a Claude Desktop usando autenticación mediante Arcade Auth. Para mantener este tutorial conciso, asumiremos que ya tienes Claude Desktop instalado y configurado localmente.

Ten en cuenta que la sección a continuación está diseñada para demostrar cómo funciona la integración de Bright Data a través de Arcade con Arcade Auth. Para orientación sobre cómo conectar otras soluciones compatibles con MCP, echa un vistazo a la documentación de Arcade.

Nota: Si quieres integrar Bright Data directamente en Claude Desktop a través de MCP, explora la documentación.

Requisitos previos

Para integrar Arcade en Claude Desktop mediante Arcade Auth, debes crear un conector personalizado. Esta función está disponible solo para usuarios de los planes Pro, Max, Team y Enterprise. Por lo tanto, necesitas una cuenta de Claude con un plan de pago.

Paso 4: Agregar un nuevo conector personalizado

Abre Claude Desktop, haz clic en tu avatar de usuario en la esquina inferior izquierda y selecciona la opción “Settings”:

En la página “Settings”, ve a la pestaña “Connectors” y haz clic en el botón “Add custom connector”:

¡Genial! Ahora puedes definir el conector de Arcade.

Paso 5: Configurar el conector de Arcade

Se abrirá un cuadro de diálogo modal para personalizar tu nuevo conector. Complétalo de la siguiente manera:

• Nombre: Arcade.
• URL: https://api.arcade.dev/mcp/bright-data-mcp. (Más generalmente: https://api.arcade.dev/mcp/<YOUR_BRIGHT_DATA_MCP_GATEWAY_SLUG>.)

Procede haciendo clic en el botón “Add”.

Ahora verás el nuevo conector en tu lista. Haz clic en “Connect” para autenticarte con tu cuenta de Arcade:

Tu navegador abrirá una nueva pestaña en el sitio web de Arcade para la autenticación. Verifica que la URL coincida con la del cuadro de diálogo modal, luego haz clic en el botón “Allow”:

¡Genial! Claude Desktop ahora debería estar conectado a tu gateway MCP de Bright Data.

Paso 6: Verificar la conexión y configurar el gateway MCP

Para verificar que el servidor MCP de Arcade con Bright Data está correctamente conectado a tu app de Claude Desktop, ve a “Settings”, abre la pestaña “Connectors” y localiza la entrada de Arcade:

Para ver las herramientas disponibles (y configurar sus permisos), haz clic en el botón “Configure”. En el panel de configuración, verás las tres herramientas expuestas por el MCP de Arcade con Bright Data:

Aquí también puedes elegir qué herramientas están disponibles para Claude Desktop y si requieren confirmación humana antes de la ejecución.

Mission complete! You can now start a new chat in Claude Desktop, enhanced with Bright Data’s web data retrieval capabilities through the Arcade custom connector.

Conectar el MCP de Arcade con Bright Data mediante Arcade Headers en Claude Code

Aquí se te guiará a través de la conexión del MCP de Arcade con Bright Data a Claude Code usando Arcade Headers. Para mantener esta sección breve, asumiremos que Claude Code ya está instalado y configurado localmente.

Nota: Si buscas una integración directa de Bright Data en Claude Code a través de MCP, lee la guía completa.

Paso 4: Cambiar el método de autenticación a Arcade Headers

En el Paso 1, configuraste el gateway MCP de Bright Data en Arcade usando Arcade Auth. Ahora es el momento de cambiarlo. Haz clic en el ícono de edición en la entrada “Bright Data MCP”:

Luego, establece el campo “Authentication” en la opción “Arcade Headers”:

Finalmente, haz clic en el botón “Update MCP Gateway” para completar la actualización.

¡Genial! Tu MCP de Arcade con Bright Data ahora se expondrá usando autenticación basada en encabezados, lo que lo hace ideal para la integración con Claude Code.

Paso 5: Generar una clave de API

Como se mencionó en el campo “Authentication” del formulario de actualización del gateway MCP visto anteriormente, la autenticación de Arcade Headers requiere que establezcas los siguientes encabezados:

• Authorization: Tu clave de API de Arcade a través de un token bearer.
• Arcade-User-ID: Tu correo electrónico de suscripción a Arcade.

Ya tienes tu correo electrónico de suscripción a Arcade, pero es posible que aún no tengas una clave de API de Arcade. Para crear una, ve a la página “Get API key” y haz clic en el botón “Create API Key”:

Dale un nombre a tu clave de API (por ejemplo, “Claude Code MCP”) y haz clic en “Create API Key”:

Se te mostrará el token de la clave de API. Guárdalo en un lugar seguro, ya que lo necesitarás pronto. La clave de API también aparecerá en la tabla “API Keys”:

¡Excelente! Ahora tienes todo lo que necesitas para conectar el gateway MCP de Arcade con Bright Data a Claude Code.

Paso 6: Agregar el MCP de Arcade con Bright Data

Usa el siguiente comando para agregar tu 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>"

Donde <YOUR_BRIGHT_DATA_MCP_GATEWAY_URL> es algo como https://api.arcade.dev/mcp/<YOUR_MCP_GATEWAY_SLUG> (en este caso, https://api.arcade.dev/mcp/bright-data-mcp).

El MCP arcade se agregará a tu archivo de configuración de Claude (~/.claude.json) de la siguiente manera:

Alternativamente, puedes configurar manualmente tu archivo JSON de Claude de la siguiente manera:

"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: Una configuración JSON similar se puede aplicar para usar Arcade a través de Arcade Headers en muchas otras herramientas compatibles con MCP.

¡Fantástico! Las herramientas de Bright Data ahora deberían estar disponibles en Claude Code gracias a la integración del MCP de Arcade.

Paso 7: Verificar las herramientas disponibles

Para verificar que Claude Code está conectado al gateway MCP de Arcade con Bright Data, ejecuta:

claude mcp get arcade

Esto verifica el estado del MCP arcade que agregaste. El resultado debería ser:

Ahora, lista las herramientas disponibles. Comienza lanzando Claude Code:

claude

Luego, ejecuta el siguiente comando:

/mcp

Selecciona el servidor MCP arcade:

Y elige la opción “View tools”:

Ahora deberías ver las tres herramientas de Bright Data disponibles en Arcade:

Well done! Your local coding assistant now has access to Bright Data’s web retrieval and search tools via Arcade.

Probar la integración del MCP de Bright Data + Arcade

Para verificar que la integración de Bright Data + Arcade a través de MCP está funcionando, lanza un 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.

Eso es algo que un LLM normal no puede manejar por sí solo. Eso se debe a que requiere búsqueda web en tiempo real y scraping para responder una consulta reciente sobre la que el modelo no ha sido entrenado.

Claude primero te pedirá permiso para usar la herramienta Brightdata.SearchEngine:

Esta herramienta llama a la SERP API de Bright Data para buscar resultados relevantes (en este caso, “2026 Oscars winners Academy Awards”) en Google (o el motor de búsqueda especificado).

A continuación, Claude seleccionará las fuentes más relevantes y te pedirá que las extraigas a través de la herramienta Brightdata.ScrapeAsMarkdown:

Una vez que permitas que la herramienta se ejecute en las páginas seleccionadas, el resultado será:

Esto coincide perfectamente con la lista de ganadores del Óscar de 2026.

¡Bien hecho! El agente de IA completó con éxito la tarea gracias a las capacidades de exploración web proporcionadas por Bright Data a través de Arcade.

Conclusión

En esta publicación del blog, exploraste cómo Arcade aborda los desafíos de autenticación y autorización típicos de las integraciones de terceros para agentes de IA. Al abstraer la capa de integración de herramientas y reforzarla con OAuth y un sólido framework de permisos, Arcade te ayuda a mantener tus agentes de IA seguros.

Entre las cientos de herramientas MCP prediseñadas disponibles en la plataforma, Bright Data se destaca al exponer acceso a algunas de las herramientas de datos más relevantes listas para IA:

• API Web Unlocker para scraping web con salida en Markdown.
• APIs de Web Scraping para feeds de datos directos de más de 50 dominios.
• SERP API para búsqueda web en los principales motores de búsqueda.

Aquí viste cómo conectar Bright Data en Arcade y exponerlo a través de un gateway MCP a agentes de IA en soluciones compatibles con MCP del mundo real. El resultado es un agente de IA más potente y seguro, capaz de acceder a datos web en tiempo real en lugar de adivinar o devolver respuestas desactualizadas.

¡Crea una cuenta de Bright Data hoy y descubre tus soluciones de datos web listas para IA!