Avanzado Lección 5 de 6 ≈ 70 min de lectura Especificación 2026-07-28

Testing y depuración

Especificación MCP 2026-07-28 · revisada el 2 de octubre de 2026

Cómo saber que un servidor MCP funciona y sigue funcionando: tests de dominio y de protocolo en las dos versiones, conformidad de mensajes, depuración con el Inspector, evaluación del uso de las tools, trazas y CI.

Qué aprenderás

  • Repartir las pruebas de un servidor MCP en cuatro capas y decidir qué afirma cada una
  • Probar las tools a través del protocolo, sin red, en las dos versiones que atiende el servidor
  • Comprobar la conformidad de los mensajes con peticiones literales y gestionar las desviaciones
  • Depurar con el Inspector una tool que el modelo no consigue usar y fijar la corrección con un test
  • Diseñar casos y métricas para evaluar el uso de las tools, propagar trazas y montar el flujo de CI

Contenido de la lección

  1. 01 El problema
  2. 02 Dominio y tools a través del protocolo
  3. 03 Conformidad: probar mensajes, no código
  4. 04 Depurar con el Inspector: la tool que el modelo no consigue usar
  5. 05 Evaluar si el modelo elige y usa bien las tools
  6. 06 Trazas: unir la llamada del agente con la auditoría del servidor
  7. 07 Integración continua
  8. 08 En producción

Además: quiz de comprobación y desafío práctico.

Extracto

Un equipo de Nortia que no ha pasado por la lección 1 añade crear_incidencia_entrega al nortia-pedidos del nivel Básico. La revisión de código pasa, tsc pasa y quien la escribió la prueba a mano con los argumentos correctos. Tres días después, soporte avisa: el agente intenta registrar incidencias y no lo consigue. En la auditoría hay rechazos encadenados dentro de una misma conversación. Ningún test falló porque ninguno miraba lo único que el modelo ve de una tool: su definición y el texto de sus errores.

La misma semana, la ingeniera de plataforma quiere actualizar el SDK. Nadie sabe decirle si los clientes que todavía usan versiones con handshake seguirán funcionando. Y es que «funciona» son en realidad cuatro afirmaciones distintas:

Fin del extracto · la lección sigue con 7 secciones más

Artículos relacionados

Preguntas frecuentes

¿Cómo se prueba un servidor MCP?

Con varios tipos de prueba, porque decir que un servidor funciona mezcla comprobaciones distintas: que el dominio calcula bien, que cada tool contesta correctamente por MCP, que los mensajes se ajustan a la especificación y que el modelo acierta al usarlas. Cada una tiene su coste, y una tool puede superar la revisión de código y el compilador y aun así resultar inservible para el agente. En la lección se ordenan esas pruebas por capas sobre nortia-pedidos y se llevan a integración continua.

¿Para qué sirve MCP Inspector?

Es la herramienta oficial para conectarse a un servidor MCP, ver sus tools, resources y prompts tal como los recibe un cliente y lanzar llamadas a mano observando cada mensaje. Resulta especialmente útil cuando el código funciona pero el agente no logra servirse de una tool, porque muestra la única información de la tool a la que el modelo tiene acceso: cómo está definida y qué dicen sus mensajes de error. En la lección se depura con el Inspector un caso real de Nortia y luego se protege el arreglo con una prueba automática.

¿Cómo se evalúa si un modelo usa bien las tools de un servidor MCP?

Con una evaluación propia: casos con peticiones realistas y métricas que indican si el modelo escoge la tool adecuada y rellena bien sus argumentos. Los tests habituales no lo detectan, porque ejercitan el código con argumentos correctos, mientras que en producción esos argumentos los escribe el modelo guiándose por cómo está definida cada tool. En la lección se diseñan esos casos y métricas, y se conectan las trazas de cada llamada del agente con lo que registra el servidor.

Temario del curso