# Instrucciones para el agente: TradingView MCP: conecta tu agente con los gráficos del escritorio

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: avanzado
- Proyecto: https://github.com/tradesdontlie/tradingview-mcp (licencia NOASSERTION)
- Guía completa: https://lab.wisd.ai/hub/tradingview-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

### Paso 1: prepara la aplicación

Comprueba Git, Node.js ≥22 con npm, TradingView Desktop y una suscripción válida. El README anuncia ≥18, pero `npm install` también instala ESLint 9, cuyo intervalo incluye ≥22 (y exige al menos 18.18 en la rama 18); esta ruta utiliza Node 22 para satisfacer la cadena. Lee los límites y el archivo LICENSE del repositorio. Usa un gráfico de prueba.

### Paso 2: instala el puente

```bash
git clone https://github.com/tradesdontlie/tradingview-mcp.git
cd tradingview-mcp
npm install
```

### Paso 3: abre la depuración local

En macOS, el README documenta:

```bash
./scripts/launch_tv_debug_mac.sh
```

Para Linux y Windows usa los scripts específicos del mismo Quick Start. No expongas el puerto de depuración fuera del equipo.

### Paso 4: configura el cliente MCP

Desde la raíz del clon, registra el proceso con Claude Code:

```bash
claude mcp add --transport stdio tradingview -- node "$PWD/src/server.js"
```

Es la configuración `node` + ruta absoluta de Add to Claude Code expresada mediante la CLI. Abre una sesión nueva y comprueba `/mcp`. No uses literalmente `/path/to/` del JSON de ejemplo.

## Comprobación

Pide al agente que ejecute `tv_health_check`, como indica Verify en el README. Después solicita una captura y contrasta el símbolo y el marco temporal con la aplicación. Para una prueba de Pine Script, revisa el resultado de compilación y el gráfico antes de guardar.

## Si algo falla

Si no conecta, comprueba que TradingView se inició con CDP en el puerto 9222 y que la ruta del servidor es absoluta. Si una herramienta deja de funcionar tras una actualización de la aplicación, revisa los avisos del repo antes de modificar el script o conceder más acceso.