# Instrucciones para el agente: MCP Inspector: examina herramientas y prueba conexiones

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/modelcontextprotocol/inspector (licencia NOASSERTION)
- Guía completa: https://lab.wisd.ai/hub/mcp-inspector-v2

---

## 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: inicia la interfaz

Comprueba que tienes Node.js ≥22.19.0 y npm/npx, según el [package.json oficial](https://github.com/modelcontextprotocol/inspector/blob/HEAD/package.json). El README publica:

```bash
npx @modelcontextprotocol/inspector
```

Para la interfaz de terminal:

```bash
npx @modelcontextprotocol/inspector --tui
```

### Paso 2: conecta el servidor

Elige el transporte correcto e introduce el comando o endpoint de un servidor de prueba según su documentación.

### Paso 3: inspecciona antes de llamar

Revisa herramientas y esquemas. Escoge una operación sin efectos externos y proporciona argumentos de ensayo.

## Comprobación

Comprueba que la conexión anuncia las capacidades esperadas y que una llamada válida devuelve un resultado interpretable. Prueba también una entrada inválida y revisa el error.

## Si algo falla

Si no conecta, comprueba transporte, URL o ejecutable antes de modificar el servidor. Para cambios respecto a v1 lee `docs/v1-to-v2-migration.md`; para autenticación, `docs/secret-storage.md`.

Consulta el [README oficial](https://github.com/modelcontextprotocol/inspector#readme) para el procedimiento completo y los cambios de versión.
