# Integración con MCP
Esta guía explica cómo integrar [**Oxylabs Headless Browser**](https://oxylabs.io/products/headless-browser) con MCP (Model Context Protocol) para permitir que los sistemas de IA interactúen con navegadores remotos y los controlen.
{% hint style="success" %}
Visita el repositorio de GitHub de Oxylabs para ver un ejemplo funcional completo de [**integración de MCP con Oxylabs Headless Browser**](https://github.com/oxylabs/oxylabs-hb-mcp)**.**
{% endhint %}
## Descripción general
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 Headless Browser**](https://oxylabs.io/products/unblocking-browser) con MCP, puedes aprovechar sistemas de IA para realizar **navegación web, recuperación de datos y automatización** tareas usando navegadores remotos con capacidades avanzadas de sigilo e integración de [**Residential Proxy**](https://oxylabs.io/products/residential-proxy-pool) .
El host de MCP (como [**Claude Desktop**](https://claude.ai/download) o [**Cursor**](https://www.cursor.com/)) incluye 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 Oxylabs Headless Browser.
{% hint style="info" %}
Por ahora, puedes obtener Headless Browser a través de nuestro equipo de ventas en [**hello@oxylabs.io**](mailto:hello@oxylabs.io)**.**
{% endhint %}
2. **Node.js**: versión 18.0.0 o superior (incluye npm/npx)
* **Windows**: descarga e instala desde [**nodejs.org**](https://nodejs.org/)
* **macOS**: usa Homebrew (`brew install node`) o descarga desde [**nodejs.org**](https://nodejs.org/)
* **Linux**:
* Ubuntu/Debian: `sudo apt update && sudo apt install nodejs npm`
* Fedora: `sudo dnf install nodejs npm`
* O descarga desde [**nodejs.org**](https://nodejs.org/)
3. **Host de MCP**: tener instalado Claude Desktop o Cursor.
## Configurar el servidor MCP
Crea un bloque de configuración del servidor MCP con tus credenciales de Oxylabs. Reemplaza `` y `` con tus credenciales reales de Oxylabs:
```json
"oxylabs_headless_browser": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--cdp-endpoint",
"wss://:@ubs.oxylabs.io"
]
}
```
### 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 del 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. Ve a Developer
4. Pulsa Edit Config
5. Edita el archivo `claude_desktop_config.json` archivo
6. Añade la configuración del servidor MCP preparada
7. Reinicia Claude Desktop
## Opciones de configuración avanzadas
### Selección de país
Puedes especificar un país para tu sesión del navegador añadiendo el parámetro `?p_cc` a tu URL de conexión:
```json
"oxylabs_headless_browser": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--cdp-endpoint",
"wss://:@ubs.oxylabs.io?p_cc=US"
]
}
```
Reemplaza `US` con el código de país SO-3166 que desees. Si no se especifica ningún país, el sistema asignará uno automáticamente según la disponibilidad.
{% hint style="success" %}
Puedes encontrar la lista de **códigos de país ISO-3166** [**aquí**](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes).
{% endhint %}
### Infraestructura basada en EE. UU.
Para los usuarios que operan principalmente en EE. UU., puedes conectarte directamente a infraestructura basada en EE. UU. para obtener tiempos de carga más rápidos:
```json
"oxylabs_headless_browser": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--cdp-endpoint",
"wss://:@ubs-us.oxylabs.io"
]
}
```
{% hint style="warning" %}
Esta solución principalmente acorta el tiempo de respuesta para los usuarios basados en EE. UU. y no debe confundirse con la selección de geolocalización del proxy.
{% endhint %}
### Argumentos del navegador (solo Chrome)
Para Headless Browser basado en Chrome, puedes especificar argumentos adicionales del navegador usando el parámetro `bargs` :
```json
"oxylabs_headless_browser": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--cdp-endpoint",
"wss://:@ubc.oxylabs.io/?bargs=force-color-profile:srgb&bargs=window-position:100,100"
]
}
```
Los argumentos compatibles incluyen:
* `force-color-profile:`: Obliga a que todos los monitores sean tratados 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:,,`: Lista separada por comas de nombres de funciones que se deben habilitar
* `disable-notifications`: Desactiva la Web Notification API y la Push API
## 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 estén bloqueando las conexiones WebSocket
2. **Problemas de rendimiento**:
* Para usuarios basados en EE. UU., prueba los endpoints específicos de 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
