> 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).

# Model Context Protocol (MCP)

La **Protocolo de contexto de modelo (MCP)** integración con [**Web Scraper API de Oxylabs**](https://oxylabs.io/products/scraper-api/web) permite la entrega de datos estructurados, listos para IA y optimizados para flujos de trabajo de modelos de lenguaje grandes (LLM).

MCP garantiza que el contexto, los metadatos y las instrucciones se formateen correctamente, lo que permite a los LLM, como Claude de Anthropic, interpretar y utilizar los datos de forma eficaz.

Puedes 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" %}
Visita el repositorio de GitHub de Oxylabs para ver un ejemplo funcional completo de [Integración MCP con 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 UV

Instalación [**uv**](https://docs.astral.sh/uv/getting-started/installation/), como alternativa a npm. Consulta 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**, actualiza 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"
      }
    }
  }
}
```

Reemplaza `your_username` y `your_password` con el nombre de usuario y la contraseña de tu usuario de 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

{% 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 tu gestor de paquetes preferido, sigue uno de los métodos de configuración siguientes.

### Usando UV (recomendado)

Instalación [**uv**](https://docs.astral.sh/uv/getting-started/installation/) 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:

```bash
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 el nombre de usuario y la contraseña de tu usuario de API.

### Usando NPM / NPX

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

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

Luego ejecuta el siguiente comando en tu 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
```

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

{% hint style="info" %}
**Nota:** Si prefieres 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 con el formato exacto utilizado 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. 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 el nombre de usuario y la contraseña de tu usuario de 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. El Composer Agent usará automáticamente Oxylabs cuando sea apropiado, 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.


---

# 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.