# Instrucciones para el agente: Bright Data MCP: obtiene datos web para tus agentes

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/brightdata/brightdata-mcp (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/bright-data-mcp

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que el cliente MCP puede encontrar Node.js y npm/npx en su PATH. Esta receta usa Node.js ≥22.12.0 con npm/npx: el README no da mínimo, pero su dependencia FastMCP 3.33 incorpora yargs 18, cuyo [manifiesto publicado](https://www.npmjs.com/package/yargs/v/18.0.0) admite ^20.19.0, ^22.12.0 o ≥23. Playwright 1.64.1 también requiere Node ≥20.

### Paso 1: prepara el token

Crea o consulta el token en tu cuenta y guárdalo con el mecanismo seguro del cliente.

### Paso 2: configura el servidor local

Esta prueba usa Claude Code. Combina este bloque con `mcpServers` en su configuración de usuario `~/.claude.json`, conservando las demás entradas. Carga primero `API_TOKEN` en el entorno privado de la terminal y arranca `claude` desde esa misma terminal para que lo herede el proceso MCP. Adaptamos el bloque del README para evitar un token literal en JSON:

```json
{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["-y", "@brightdata/mcp"]
    }
  }
}
```

Si el cliente filtra variables, configura `API_TOKEN` con su mecanismo privado de entorno; no uses la cadena literal `$API_TOKEN` como valor JSON esperando que se expanda. Comprueba la herencia antes de continuar.

### Paso 3: reinicia y consulta

Comprueba el servidor en `/mcp`, inicia una sesión nueva y pide usar `scrape_as_markdown` sobre `https://example.com`. La salida debe incluir «Example Domain», que puedes contrastar con la página pública.

## Comprobación

Confirma que las URLs y el contenido corresponden a la petición. Contrasta una muestra con la página original y revisa el consumo de la cuenta antes de ampliar el lote.

## Si algo falla

Si aparece un fallo de autorización, revisa cómo llega API_TOKEN al proceso del cliente. Si una herramienta no está disponible, comprueba su grupo y el alcance configurado según el README.

[Fuente del procedimiento](https://github.com/brightdata/brightdata-mcp).