lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio mcpnodejsdepuracion

MCP Inspector: examina herramientas y prueba conexiones

Inspecciona lo que anuncia un servidor MCP y ensaya sus llamadas con datos de prueba. Usa interfaz web, terminal o CLI según la tarea.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

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.

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. El README publica:

npx @modelcontextprotocol/inspector

Para la interfaz de terminal:

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 para el procedimiento completo y los cambios de versión.

ver en .md ¿Prefieres el recurso entero?

Qué es

MCP Inspector es el cliente de diagnóstico del proyecto Model Context Protocol. Su línea v2 ofrece varias interfaces para conectarte a servidores y revisar herramientas, recursos y comportamiento.

Para qué te sirve

  • Cuando una herramienta MCP falla y necesitas separar un problema de conexión de uno de entrada.
  • Cuando quieres revisar el esquema de una herramienta antes de darle datos de negocio.

Cómo funciona

Las interfaces comparten una capa de conexión y estado. La web añade un backend local que gestiona la conexión MCP, y la CLI facilita comprobaciones desde terminal. Puedes examinar capacidades y realizar una llamada explícita con los argumentos que declare el servidor.

Antes de empezar

El paquete actual declara Node.js ≥22.19.0; la ruta descrita usa npm/npx. Ten ese entorno disponible y prepara el transporte del servidor: proceso stdio o endpoint remoto. Si requiere autenticación, sigue su procedimiento oficial.

Límites y alternativas

Probar una herramienta puede ejecutar acciones reales: empieza con servidores y datos de ensayo. Inspector puede guardar información de autenticación; revisa la guía de almacenamiento, especialmente en máquinas sin llavero del sistema. GitHub clasifica la licencia como NOASSERTION y el README explica la transición de licencias.

Recursos