> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/integrations/es/integraciones-de-web-scraper-api/model-context-protocol-mcp.md).

# Model Context Protocol (MCP)

La **Model Context Protocol (MCP)** integración con [**Oxylabs Web Scraper API**](https://oxylabs.io/products/scraper-api/web) permite la entrega de datos estructurados, 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.

Puede usar fácilmente la integración de Web Scraper API MCP con:

* [**Claude Desktop**](#setup-with-claude-desktop)
* [**Claude Code**](#claude-code-cli-setup)
* [**Cursor**](#running-on-cursor)

{% hint style="success" %}
Visite el repositorio de GitHub de Oxylabs para un ejemplo funcional completo de [la integración de MCP con Web Scraper API](https://github.com/oxylabs/oxylabs-mcp).
{% endhint %}

## Configuración con Claude Desktop

{% hint style="warning" %}
Antes de comenzar, asegúrese de tener [**Claude Desktop**](https://claude.ai/download) instalado. 
{% endhint %}

### Usando Smithery.ai

Instale [**Node.js y npm**](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) interfaz de línea de comandos. Si ya los tiene instalados, ejecute 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](https://smithery.ai/server/@oxylabs/oxylabs-mcp), ejecute este comando:

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

Durante el proceso de instalación, se le pedirá que introduzca su nombre de usuario y contraseña de usuario de API. Introduzca estas credenciales cuando se le soliciten.

Una vez completada la instalación, abra Claude Desktop y configure el scraper para comenzar a usar salidas mejoradas con MCP.

### Usando UV

Instale [**uv**](https://docs.astral.sh/uv/getting-started/installation/), como alternativa a npm. Consulte la [**Guía de inicio rápido de Model Context Protocol**](https://modelcontextprotocol.io/quickstart/user) para entender el proceso de configuración.

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

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

Reemplace `your_username` y `your_password` con el nombre de usuario y la contraseña de su usuario de API.

Guarde los cambios en el archivo de configuración y reinicie Claude Desktop para asegurarse de que los ajustes actualizados surtan efecto.

## Configuración de la CLI de Claude Code

{% hint style="warning" %}
Antes de comenzar, asegúrese de tener [**Claude Code**](https://docs.anthropic.com/en/docs/claude-code) instalado.
{% endhint %}

Claude Code incluye un comando integrado para agregar servidores MCP directamente desde la terminal. Según su gestor de paquetes preferido, siga uno de los métodos de configuración a continuación.

### Usando UV (recomendado)

Instale [**uv**](https://docs.astral.sh/uv/getting-started/installation/) si aún no lo ha hecho. Luego ejecute el siguiente comando en su terminal para agregar el servidor MCP de Oxylabs a Claude Code:

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

Reemplace `your_username` y `your_password` con el nombre de usuario y la contraseña de su usuario de API.

### Usando NPM / NPX

Instale [**Node.js y npm**](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) si aún no lo ha hecho. Si `npm` ya está instalado, asegúrese de que esté actualizado:

```bash
npm install -g npm
```

Luego ejecute el siguiente comando en su terminal para agregar el servidor MCP de Oxylabs a Claude Code:

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

Reemplace `your_username` y `your_password` con el nombre de usuario y la contraseña de su usuario de API.

{% hint style="info" %}
**Nota:** Si prefiere editar los 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.
{% endhint %}

## Uso en Cursor

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

Para configurar Oxylabs en Cursor:<br>

1. Seleccione Cursor → Settings → Cursor Settings → MCP Tools
2. Haga clic en "Add Custom MCP"
3. Agregue 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"
      }
    }
  }
}
```

Reemplace `your_username` y `your_password` con el nombre de usuario y la contraseña de su usuario de API. También reemplace `your_ai_studio_api_key` con su clave API de Oxylabs AI Studio.

Después de añadir la configuración, actualice la lista de servidores MCP para ver las nuevas herramientas. El agente Composer usará automáticamente Oxylabs cuando sea apropiado, pero puede solicitarlo explícitamente describiendo sus necesidades de web scraping. Acceda a Composer mediante Command+L (Mac), seleccione "Agent" junto al botón de envío e introduzca su consulta.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/integrations/es/integraciones-de-web-scraper-api/model-context-protocol-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.