Integración con MCP

Unblocking Browser puede usarse con MCP, permitiendo que sistemas de IA controlen navegadores remotos. Aprende más sobre esta integración.

Esta guía explica cómo integrar Oxylabs Unblocking Browser con MCP (Model Context Protocol) para permitir que los sistemas de IA interactúen y controlen navegadores remotos.

Visita el repositorio de Oxylabs en GitHub para un ejemplo completo y funcional de integración de MCP con Oxylabs Unblocking Browser.

Resumen

Model Control Protocol (MCP) permite que sistemas de IA como Claude interactúen con navegadores y realicen tareas basadas en la web. Al integrar Oxylabs Unblocking Browser con MCP, puedes aprovechar sistemas de IA para realizar navegación web, recuperación de datos y automatización de tareas usando navegadores remotos con capacidades avanzadas de sigilo y integración con Residential Proxy integración.

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

Comenzando

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

1. Cuenta de Oxylabs: obtén tu nombre de usuario y contraseña para Oxylabs Unblocking Browser.

Por ahora, puedes obtener Unblocking Browser a través de nuestro equipo de ventas en [email protected].

1. 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 MCP: ya sea Claude Desktop o Cursor instalado.

Configurar servidor MCP

Crea un bloque de configuración del servidor MCP con tus credenciales de Oxylabs. Reemplaza <username> y <password> con tus credenciales reales de Oxylabs:

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc.oxylabs.io"
  ]
}

Opción 1: integración con Cursor

1. Abre Cursor

2. Abre la configuración de Cursor

3. Selecciona MCP

4. Agrega la configuración de servidor MCP preparada

5. Reinicia Cursor

Opción 2: integración con Claude Desktop

1. Abre Claude Desktop

2. Abre la configuración de Claude Desktop

3. Navega a Developer

4. Presiona Edit Config

5. Edita el claude_desktop_config.json archivo

6. Agrega la configuración de servidor MCP preparada

7. Reinicia Claude Desktop

Opciones de configuración avanzada

Selección de país

Puedes especificar un país para tu sesión del navegador agregando el ?p_cc parámetro a tu URL de conexión:

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc.oxylabs.io?p_cc=US"
  ]
}

Reemplaza US con el código de país SO-3166 deseado. 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í.

Infraestructura con base en EE. UU.

Para usuarios que operan principalmente en EE. UU., puedes conectarte directamente a la infraestructura con base en EE. UU. para tiempos de carga más rápidos:

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc-us.oxylabs.io"
  ]
}

Esta solución acorta principalmente el tiempo de respuesta para usuarios en EE. UU. y no debe confundirse con la selección de geo-ubicación del proxy.

Argumentos del navegador (solo Chrome)

Para Unblocking Browser basado en Chrome, puedes especificar argumentos adicionales del navegador usando el bargs parámetro:

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc.oxylabs.io/?bargs=force-color-profile:srgb&bargs=window-position:100,100"
  ]
}

Los argumentos compatibles incluyen:

• force-color-profile:<profile>: Forzar que todos los monitores se traten como si tuvieran el perfil de color especificado

• window-position:X,Y: Especifica la posición inicial de la ventana

• hide-scrollbars: Evita crear barras de desplazamiento para el contenido web

• enable-features:<feature1>,<feature2>,<feature3>: Lista separada por comas de nombres de funciones para habilitar

• disable-notifications: Deshabilita las APIs de Web Notification y Push

Solución de problemas

Si encuentras problemas con la integración:

1. Problemas de conexión:

   • Verifica tus credenciales de Oxylabs

   • Revisa tu conexión de red

   • Asegúrate de que los firewalls no estén bloqueando las conexiones WebSocket

2. Problemas de rendimiento:

   • Para usuarios en EE. UU., prueba los endpoints específicos para EE. UU.

   • Aumenta los timeouts en tu configuración si es necesario

3. El navegador no carga:

   • Verifica la versión de Node.js (debe ser 18.0.0 o superior)

   • Verifica que npx esté instalado correctamente

   • Reinicia la aplicación host MCP