Integración con MCP

Headless Browser puede usarse con MCP, lo que permite a los sistemas de IA controlar navegadores remotos. Obtén más información sobre esta integración.

Esta guía explica cómo integrar Oxylabs Headless Browser con MCP (Protocolo de contexto de modelos) para permitir que los sistemas de IA interactúen con navegadores remotos y los controlen.

Visita el repositorio de GitHub de Oxylabs para ver un ejemplo funcional completo de la integración de MCP con Oxylabs Headless Browser.

Descripción general

El Protocolo de control de modelos (MCP) permite que sistemas de IA como Claude interactúen con navegadores y realicen tareas web. Al integrar Oxylabs Headless Browser con MCP, puedes implementar sistemas de IA para realizar navegación web, recuperación de datos y automatización tareas usando navegadores remotos con capacidades avanzadas de navegación autónoma e Residential Proxy integración.

El host de MCP (como Claude Desktop o Cursor) viene con un cliente MCP integrado. Playwright-MCP actúa como un servidor MCP y, en lugar de usar un navegador local, se conecta a Headless Browser mediante una conexión WebSocket segura (WSS).

Primeros pasos

Antes de configurar la integración, asegúrate de tener:

1. cuenta de Oxylabs: obtén tu nombre de usuario y contraseña para Headless Browser desde el panel de Oxylabs.
2. Node.js: versión 18.0.0 o superior (incluye npm/npx)

• Windows: descarga e instala desde nodejs.org
• macOS: usa Homebrew (brew install node) o descarga desde nodejs.org
• Linux:

  • Ubuntu/Debian: sudo apt update && sudo apt install nodejs npm
  • Fedora: sudo dnf install nodejs npm
  • O descarga desde nodejs.org

1. Host de MCP: Claude Desktop o Cursor instalado.

Configura el servidor MCP

Crea una sección de configuración del servidor MCP con tus credenciales de Oxylabs. Reemplaza USERNAME y PASSWORD con tus credenciales reales de Oxylabs:

"oxylabs_headless_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://USERNAME:[e-mail]"
  ]
}

Opción 1: integración con Cursor

1. Abre Cursor
2. Abre la configuración de Cursor
3. Selecciona MCP
4. Añade la configuración preparada del servidor MCP
5. Reinicia Cursor

Opción 2: integración con Claude Desktop

1. Abre Claude Desktop
2. Abre la configuración de Claude Desktop
3. Ve a Developer
4. Pulsa Edit Config
5. Edita el claude_desktop_config.json archivo
6. Añade la configuración preparada del servidor MCP
7. Reinicia Claude Desktop

Opciones de configuración avanzadas

Selección de país

Puedes especificar un país para tu sesión de navegador añadiendo el ?p_cc a tu URL de conexión:

"oxylabs_headless_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://USERNAME:[e-mail]?p_cc=US"
  ]
}

Reemplaza US con el código de país ISO-3166 que desees. Si no se especifica un país, el sistema asignará uno automáticamente según la disponibilidad.

Puedes encontrar la lista de códigos de país ISO-3166 aquí.

También puedes usar p_state o p_city para segmentación a nivel de estado (US) o ciudad, o usar proxies residenciales persistentes para un control más preciso de la IP de salida. Más información aquí.

Solución de problemas

Si encuentras problemas con la integración:

1. Problemas de conexión:

   • Verifica tus credenciales de Oxylabs
   • Comprueba tu conexión de red
   • Asegúrate de que los firewalls no bloqueen las conexiones WebSocket
2. Problemas de rendimiento:

   • Para usuarios con sede en EE. UU., prueba los endpoints específicos para EE. UU.
   • Aumenta los tiempos de espera en tu configuración si es necesario
3. El navegador no carga:

   • Comprueba la versión de Node.js (debe ser 18.0.0 o superior)
   • Verifica que npx esté instalado correctamente
   • Reinicia la aplicación host de MCP