Protocolo de contexto del modelo (MCP)

Carga contexto de forma fluida para flujos de trabajo de IA con Oxylabs Model Context Protocol (MCP). Sube datos, recupera fragmentos e intégralo con pipelines estilo GPT mediante API.

El Protocolo de contexto del modelo (MCP) integración con Web Scraper API de Oxylabs permite la entrega de datos estructurados y listos para IA, optimizados para flujos de trabajo de modelos de lenguaje grandes (LLM).

MCP garantiza que el contexto, los metadatos y las instrucciones estén correctamente formateados, lo que permite que los LLM, como Claude de Anthropic, interpreten y utilicen los datos de forma eficaz.

Puedes integrar fácilmente Web Scraper API con:

• Claude Desktop

• Claude Code

• Cursor

Visita el repositorio de GitHub de Oxylabs para ver un ejemplo funcional completo de integración MCP con Web Scraper API.

Configuración con Claude Desktop

Antes de empezar, asegúrate de tener Claude Desktop instalados.

Usando Smithery.ai

Instala Node.js y npm interfaz de línea de comandos. Si ya los tienes instalados, ejecuta el siguiente comando para actualizar npm a la última versión:

npm install -g npm

Para instalar automáticamente el servidor MCP de Oxylabs para Claude Desktop mediante Smithery, ejecuta este comando:

npx -y @smithery/cli install @oxylabs/oxylabs-mcp --client claude

Durante el proceso de instalación, se te pedirá que ingreses tu nombre de usuario y contraseña de usuario de la API. Introduce estas credenciales cuando se te soliciten.

Una vez completada la instalación, abre Claude Desktop y configura el scraper para empezar a usar salidas mejoradas con MCP.

Usando UV

Instala uv, como alternativa a npm. Consulta la Guía de inicio rápido de Model Context Protocol para entender el proceso de configuración.

Para integrar el servidor MCP con Claude Desktop, actualiza el claude_desktop_config.json archivo de la siguiente manera:

{
  "mcpServers": {
    "oxylabs_mcp": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "your_username",
        "OXYLABS_PASSWORD": "your_password"
      }
    }
  }
}

Reemplaza your_username y your_password con tu nombre de usuario y contraseña de la API.

Guarda los cambios en el archivo de configuración y reinicia Claude Desktop para asegurarte de que la configuración actualizada surta efecto.

Configuración de la CLI de Claude Code

Antes de empezar, asegúrate de tener Claude Code instalados.

Claude Code tiene un comando integrado para añadir servidores MCP directamente desde la terminal. Según tu gestor de paquetes preferido, sigue uno de los métodos de configuración siguientes.

Usando UV (recomendado)

Instala uv si aún no lo has hecho. Luego ejecuta el siguiente comando en tu terminal para añadir el servidor MCP de Oxylabs a Claude Code:

claude mcp add oxylabs -- command uvx args oxylabs-mcp --env OXYLABS_USERNAME=your_username --env OXYLABS_PASSWORD=your_password

Reemplaza your_username y your_password con tu nombre de usuario y contraseña de la API.

Usando NPM / NPX

Instala Node.js y npm si aún no lo has hecho. Si npm ya está instalado, asegúrate de que esté actualizado:

npm install -g npm

Luego ejecuta el siguiente comando en tu terminal para añadir el servidor MCP de Oxylabs a Claude Code:

claude mcp add oxylabs -- command npx args -y @oxylabs/oxylabs-mcp --env OXYLABS_USERNAME=your_username --env OXYLABS_PASSWORD=your_password

Reemplaza your_username y your_password con tu nombre de usuario y contraseña de la API.

Nota: Si prefieres editar archivos manualmente, Claude Code busca su archivo de configuración en ~/.config/claude/mcp.json (en Mac/Linux) o %USERPROFILE%.config\claude\mcp.json (en Windows). La estructura JSON dentro de ese archivo coincide exactamente con el formato usado para Claude Desktop.

Uso en Cursor

Configuración de Cursor. Nota: requiere la versión 0.46+ de Cursor

Para configurar Oxylabs en Cursor:

1. Selecciona Cursor → Settings → Cursor Settings → MCP Tools

2. Haz clic en "Add Custom MCP"

3. Añade la siguiente configuración:

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "your_username",
        "OXYLABS_PASSWORD": "your_password",
        "OXYLABS_AI_STUDIO_API_KEY": "your_ai_studio_api_key"
      }
    }
  }
}

Reemplaza your_username y your_password con tu nombre de usuario y contraseña de la API. Además, reemplaza your_ai_studio_api_key con tu clave de API de Oxylabs AI Studio.

Después de añadir la configuración, actualiza la lista de servidores MCP para ver las nuevas herramientas. Composer Agent usará Oxylabs automáticamente cuando corresponda, pero puedes solicitarlo explícitamente describiendo tus necesidades de web scraping. Accede a Composer mediante Command+L (Mac), selecciona "Agent" junto al botón de envío e introduce tu consulta.