Protocolo de contexto de modelo (MCP)

Usa Oxylabs MCP para proporcionar a los asistentes de IA herramientas de scraping web en vivo, búsqueda y extracción a través de Web Scraper API y AI Studio.

El servidor MCP de Oxylabs conecta asistentes de IA (Claude, Cursor, y cualquier otro Protocolo de contexto del modelo cliente) con la web del mundo real.

Una vez conectado, tu asistente puede raspar cualquier URL (incluye renderizado de JavaScript y segmentación geográfica), buscar en la web, rastrear sitios y extraer datos estructurados.

Código abierto y registro: Ver el código fuente en GitHub. El servidor está registrado oficialmente en el MCP Registry (io.oxylabs/oxylabs-mcp), PyPI, y Smithery.

Requisitos previos

Necesitas al menos un conjunto de credenciales para desbloquear sus herramientas correspondientes. Proporcionar ambos desbloquea todas las herramientas que se indican a continuación.

Credenciales	Dónde obtenerlo	Desbloquea
Web Scraper API nombre de usuario & contraseña	panel de Oxylabs (prueba gratuita disponible)	herramientas de Web Scraper API
clave API de AI Studio	Ajustes de AI Studio (incluye créditos gratuitos)	herramientas de AI Studio

Configura solo las credenciales que realmente tengas. Los valores de marcador de posición exponen herramientas que fallarán al llamarlas.

Herramientas disponibles

Herramienta	Qué hace	Requiere
universal_scraper	Raspa cualquier URL. Renderizado opcional de JavaScript, segmentación geográfica, salida Markdown/HTML	Web Scraper API
google_search_scraper	Resultados de Google Search, opcionalmente analizados a JSON estructurado	Web Scraper API
amazon_search_scraper	Páginas de resultados de búsqueda de Amazon, opcionalmente analizadas	Web Scraper API
amazon_product_scraper	Páginas individuales de producto de Amazon	Web Scraper API
ai_scraper	Extracción impulsada por IA desde cualquier URL (JSON, CSV, Markdown, TOON)	AI Studio
ai_crawler	Rastreo multipágina y recopilación de datos impulsados por prompt	AI Studio
ai_browser_agent	Control del navegador impulsado por prompt: navegar, hacer clic, rellenar formularios	AI Studio
ai_search	Búsqueda web con contenido Markdown opcional de cada resultado	AI Studio
ai_map	Mapea URLs de sitios web	AI Studio
generate_schema	Genera esquemas de extracción personalizados para las herramientas de AI Studio	AI Studio

Elige cómo conectarte

	Servidor alojado (recomendado)	Servidor local
Instalar	Ninguno	uv + uvx oxylabs-mcp
Punto de conexión	https://mcp.oxylabs.io/mcp	Cursor/Claude inician el proceso
Credenciales	Encabezados HTTP	Variables de entorno
Ideal para	Configuración más rápida, sin gestión	Control sin conexión, depuración local, clientes que no pueden enviar encabezados personalizados

Método 1: Servidor alojado (recomendado)

Conéctate al servidor MCP alojado de Oxylabs:

https://mcp.oxylabs.io/mcp

Pasa las credenciales como encabezados de solicitud:

Credencial	Encabezado
Web Scraper API	Authorization: Basic <base64(username:password)>
AI Studio	X-Oxylabs-AI-Studio-Api-Key: <your API key>

Nota: Incluye solo los encabezados de las credenciales que tengas.

Claude Code

Instálalo directamente en la línea de comandos:

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \\
  --header "Authorization: Basic $(echo -n 'YOUR_USERNAME:YOUR_PASSWORD' | base64)" \\
  --header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"

Omite una --header línea si no tienes esa credencial.

Claude Desktop

El editor de configuración integrado de Claude Desktop usa servidores locales (command). Para el endpoint alojado, usa Claude Code con el comando HTTP anterior, o ejecuta el servidor localmente y apunta Claude Desktop a esa configuración.

Cursor

1. Abre Configuración de Cursor → Personalizar en la barra lateral → MCPs
2. Haz clic en + Nuevo
3. Elige Usuario (todos los proyectos) o Proyecto (solo espacio de trabajo)
4. Añade lo siguiente al mcp.json:

   {
     "mcpServers": {
       "oxylabs": {
         "url": "https://mcp.oxylabs.io/mcp",
         "headers": {
           "Authorization": "Basic <base64 of username:password>",
           "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
         }
       }
     }
   }

5. Guarda y luego confirma que el servidor esté habilitado en Personalizar → MCPs.

Nota: Usuario escribe en ~/.cursor/mcp.json. Espacio de trabajo escribe en .cursor/mcp.json en el espacio de trabajo elegido. Si ambos definen el mismo nombre de servidor, la espacio de trabajo tiene prioridad.

Método 2: Servidor local

El servidor está disponible en nuestro repositorio de PyPI.

Si aún no está instalado, instala el paquete uv según el sistema operativo elegido:

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Las credenciales se pasan como variables de entorno (configura solo las que tengas):

Variable	Descripción
OXYLABS_USERNAME	nombre de usuario de Web Scraper API
OXYLABS_PASSWORD	contraseña de Web Scraper API
OXYLABS_AI_STUDIO_API_KEY	clave API de AI Studio

Claude Code

claude mcp add oxylabs -- command uvx args oxylabs-mcp \\
  --env OXYLABS_USERNAME=YOUR_USERNAME \\
  --env OXYLABS_PASSWORD=YOUR_PASSWORD \\
  --env OXYLABS_AI_STUDIO_API_KEY=YOUR_API_KEY

Ruta de configuración manual para Claude Code: ~/.config/claude/mcp.json (macOS/Linux) o %USERPROFILE%\.config\claude\mcp.json (Windows). La estructura JSON coincide con Claude Desktop.

Claude Desktop

1. Abre Claude → Configuración → Desarrollador → Editar configuración
2. Añade lo siguiente a claude_desktop_config.json:

   {
     "mcpServers": {
       "oxylabs": {
         "command": "uvx",
         "args": ["oxylabs-mcp"],
         "env": {
           "OXYLABS_USERNAME": "YOUR_USERNAME",
           "OXYLABS_PASSWORD": "YOUR_PASSWORD",
           "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }

3. Reinicia Claude Desktop

Cursor

1. Abre Configuración de Cursor → Personalizar en la barra lateral → MCPs
2. Haz clic en + Nuevo
3. Elige Usuario (todos los proyectos) o Proyecto (solo espacio de trabajo)
4. Añade lo siguiente al mcp.json:

   {
     "mcpServers": {
       "oxylabs": {
         "command": "uvx",
         "args": ["oxylabs-mcp"],
         "env": {
           "OXYLABS_USERNAME": "YOUR_USERNAME",
           "OXYLABS_PASSWORD": "YOUR_PASSWORD",
           "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }

5. Guarda y luego confirma que el servidor esté habilitado en Personalizar → MCPs.

Nota: Usuario escribe en ~/.cursor/mcp.json. Espacios de trabajo escribe en .cursor/mcp.json en el espacio de trabajo elegido. Si ambos definen el mismo nombre de servidor, la espacio de trabajo tiene prioridad.

Verifica la configuración

Después de conectarte, pídele a tu asistente algo que requiera datos web en vivo (p. ej. “Raspa https://ip.oxylabs.io y devuelve el contenido como Markdown.”):

1

Confirma que el oxylabs servidor aparece y está habilitado en la lista MCP de tu cliente.

2

Aprueba la llamada a la herramienta cuando se te solicite (los clientes preguntan antes de ejecutar herramientas MCP de forma predeterminada).

3

Si la llamada falla, revisa las credenciales y los registros del cliente (Cursor: Salida → Registros MCP).

Solución de problemas

Error	Solución
Falta el servidor en el cliente	Reinicia la app después de editar la configuración. Confirma que el JSON sea válido.
Las herramientas aparecen, pero las llamadas fallan	Credenciales de marcador de posición, Base64 incorrecto o falta el encabezado/variable de entorno para esa herramienta.
La URL alojada no se conecta	Puede que el cliente no admita encabezados personalizados; usa la configuración local.
uvx / command not found	Instalar uv y asegúrate de que esté en tu PATH.
La ruta de la interfaz de Cursor se ve diferente	Omite la interfaz y edita mcp.json directamente (las etiquetas pueden cambiar entre versiones de Cursor).

Para problemas o solicitudes de funciones, abre un issue en GitHub o contacta con el soporte 24/7 de Oxylabs en [e-mail].