> 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/products/es/web-scraper-api/solutions-for-ai-workflows/model-context-protocol-mcp.md).

# Protocolo de contexto del modelo (MCP)

La **Protocolo de Contexto del Modelo (MCP)** integración con [**Web Scraper API de Oxylabs**](https://oxylabs.io/products/scraper-api/web) permite entregar datos estructurados, listos para IA, optimizados para flujos de trabajo de modelos de lenguaje de gran tamaño (LLM).

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

Puede usar fácilmente la integración MCP de Web Scraper API 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 MCP con la Web Scraper API](https://github.com/oxylabs/oxylabs-mcp).
{% endhint %}

## Configuración con Claude Desktop

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

### Usando Smithery.ai

Instala [**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 el nombre de usuario y la contraseña de su usuario de API. Introduzca estas credenciales cuando se le solicite.

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

### Usando UV

Instala [**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 así:

```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 la configuración actualizada surta efecto.

## Configuración de la CLI de Claude Code

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

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

### Usando UV (recomendado)

Instala [**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 añadir 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

Instala [**Node.js y npm**](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) si aún no los ha instalado. 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 añadir 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 %}

## Ejecutando en Cursor

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

Para configurar Oxylabs en Cursor:<br>

1. Seleccione Cursor → Configuración → Configuración de Cursor → Herramientas MCP
2. Haga clic en "Añadir MCP personalizado"
3. Añada 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. Además, 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á Oxylabs automáticamente cuando corresponda, pero puede solicitarlo explícitamente describiendo sus necesidades de web scraping. Acceda a Composer con Command+L (Mac), seleccione "Agente" 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, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/es/web-scraper-api/solutions-for-ai-workflows/model-context-protocol-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.