En esta clase conectaremos nuestro servidor MCP a un switch Cisco Catalyst 9300 utilizando tools de MCP con Netmiko, ejecutaremos comandos de verificación sobre el dispositivo físico y veremos la respuesta del equipo en el Inspector MCP. Además abordaremos aspectos relacionados al manejo de errores en el código.

¿Qué lograrás con esta clase?

• Conectar un servidor MCP a un dispositivo real mediante una tool que utiliza Netmiko
• Ejecutar comandos remotos sobre el equipo y devolver la respuesta al cliente MCP
• Aplicar el context manager de Netmiko para gestionar correctamente las sesiones SSH
• Implementar bloques try/except para capturar excepciones específicas de Netmiko
• Personalizar los mensajes de error que recibirá la IA cuando algo falle en la conexión
• Resolver el bloqueo del puerto Inspector cuando un proceso queda colgado

Conexión a un dispositivo Cisco desde una tool de MCP

Antes de introducirnos al código, vamos a verificar que el equipo está listo para recibir conexiones remotas. Validaremos la conectividad al switch, comprobaremos el acceso SSH, y revisaremos que las credenciales y la configuración del dispositivo permitan la comunicación que vamos a establecer desde Python.

Con el dispositivo preparado, construiremos una nueva tool dentro de nuestro servidor MCP. Importaremos ConnectHandler desde Netmiko, definiremos los datos de conexión dentro de un diccionario y utilizaremos el context manager with para garantizar que la sesión SSH se cierre correctamente incluso si ocurre un error durante la ejecución del comando. Probaremos toda la integración con el Inspector MCP y veremos el resultado de ejecución del comando.

Manejo de errores en tools de MCP con Netmiko

Si dejamos que Netmiko devuelva sus mensajes de error por defecto, esos mensajes llegarán literalmente hasta la IA y, en consecuencia, hasta el usuario final. Esto significa dos problemas: primero, los mensajes incluyen información que pueden no querer exponer (direcciones IP, tipos de dispositivo); segundo, son mensajes técnicos que no aportan valor dependiendo quien interactúa con la aplicación. Veremos qué mensaje aparece cuando la IP es incorrecta y qué mensaje aparece cuando las credenciales fallan.

La solución a los problemas mencionados pasa por implementar bloques try/except que capturen las excepciones específicas que Netmiko genera. Importaremos NetmikoTimeoutException y NetmikoAuthenticationException para tratar de forma diferenciada los problemas de conectividad y los problemas de credenciales, y añadiremos un except genérico para capturar cualquier otro evento inesperado. Cada except devolverá un mensaje personalizado que oculta los detalles internos y entrega al usuario una explicación del problema.

Resolución de problemas con el Inspector MCP

Para cerrar la clase abordaremos un problema que aparece tarde o temprano al trabajar con el Inspector: cuando realizan el cierre del programa, este no se cierra correctamente y deja un proceso colgado que bloquea el puerto, impidiendo que se inicie nuevamente. Veremos los comandos exactos para identificar el proceso bloqueado, liberar el puerto y dejar el entorno listo para continuar trabajando sin reiniciar el equipo.

Y como siempre, si tienes alguna duda de la clase estamos acá. ¿Qué esperas? ¡Suscribete!.