Instalar el Agente MKController en MikroTik
Resumen El Agente MKController es una pequeña aplicación de escritorio que escanea su red local, descubre dispositivos MikroTik y le permite adoptarlos en MKController con un solo clic — reemplazando la ejecución manual de scripts para despliegues en sitio. Esta guía explica qué hace el agente, cómo instalarlo en Windows, macOS y Linux, y cómo gestionar el aviso de certificado que aparece durante la instalación.
¿Qué es el Agente MKController?
El Agente MKController es una herramienta de escritorio ligera que conecta su red local con la plataforma cloud de MKController. Se ejecuta en su computadora, escanea la LAN en busca de dispositivos MikroTik compatibles y los presenta en el flujo de adopción de la plataforma con un botón Adoptar de un solo clic — eliminando la necesidad de copiar y ejecutar manualmente scripts de adopción en cada dispositivo.
Para los equipos familiarizados con la Herramienta de Descubrimiento de Dispositivos UniFi o asistentes similares de otros fabricantes, el flujo de trabajo es directamente comparable: un proceso local gestiona el descubrimiento y la plataforma cloud se encarga de la administración.
La distinción clave: el descubrimiento y la adopción son acciones separadas. El agente localiza los dispositivos elegibles y los muestra — no adopta ni modifica nada automáticamente. Cada adopción requiere su confirmación explícita.
¿Cuándo Usar el Agente en Lugar del Método Manual?
| Escenario | Método recomendado |
|---|---|
| Primer despliegue en un nuevo sitio con múltiples dispositivos | Agente — descubre todos los dispositivos compatibles a la vez |
| Adopción remota de un dispositivo ya en línea | Script manual mediante WebFig, Winbox o SSH |
| Preparación en laboratorio antes de enviar al sitio del cliente | Agente |
| Dispositivo único, el técnico ya tiene acceso a la CLI | Script manual |
| Visitas recurrentes a sitios de clientes | El agente acelera la incorporación repetida |
¿Dónde Aparece el Agente en MKController?
En una cuenta nueva sin dispositivos, MKController destaca dos caminos de incorporación: instalar el agente o usar el script manual.
En cuentas que ya tienen dispositivos, el menú Agregar Dispositivo incluye la opción del Asistente de Adopción.
Un indicador de estado en la esquina inferior izquierda de la plataforma muestra si el agente está Activo (verde), Pendiente o Inactivo — para que siempre sepa si el asistente de escritorio está listo para escanear.
¿Cómo Se Instala y Conecta el Agente?
El flujo de instalación tiene tres pasos: descargar, vincular, confirmar.
- Haga clic en Descargar Agente en MKController.
- Ejecute el instalador descargado en su computadora.
- Copie el código de vinculación que aparece en la plataforma.
- Pegue ese código en la aplicación de escritorio.
- Espere a que la plataforma confirme la conexión — no se requiere configuración manual.
Una vez ingresado el código, la conexión se establece automáticamente. No se necesitan reglas de descubrimiento, comandos de terminal ni excepciones de firewall.
¿Por Qué el Sistema Operativo Muestra una Advertencia de Certificado?
Los certificados de MKController están actualmente en proceso de aprobación. Durante este período, Windows, macOS y Linux pueden mostrar una alerta de seguridad al ejecutar el instalador. Este es el comportamiento esperado para software de nueva distribución pendiente de aprobación de certificado — no indica que el agente sea inseguro.
Windows: Si el sistema muestra una advertencia de aplicación protegida, haga clic en Más información y permita la instalación. En entornos empresariales puede requerirse la aprobación puntual del administrador de TI.
macOS: Si macOS bloquea el instalador, vaya a Configuración del Sistema → Privacidad y Seguridad, desplácese hacia abajo y apruebe la aplicación bloqueada. Luego vuelva a ejecutar el instalador.
Linux: Asegúrese de que el archivo descargado tenga permisos de ejecución. En entornos restringidos, su administrador puede necesitar aprobar la fuente del paquete.
¿Cómo Confirmar que el Agente Está en Línea?
Cuando el agente está instalado y en ejecución, MKController muestra su estado como Activo en verde en la esquina inferior izquierda de la plataforma.
En este punto, el Asistente de Adopción puede escanear su red y listar los dispositivos detectables.
¿Cómo Escanear y Adoptar Dispositivos?
Con el agente en línea, MKController escanea la red local y lista los dispositivos compatibles con un botón Adoptar junto a cada uno.
Algunas consideraciones prácticas:
- El escaneo alcanza los dispositivos en la red donde se ejecuta la computadora del agente.
- Los dispositivos deben ser accesibles en ese segmento de red.
- La conectividad a Internet sigue siendo necesaria, ya que el flujo de adopción es coordinado por la plataforma MKController.
Tras la adopción, los dispositivos pueden reubicarse físicamente en cualquier red con acceso a Internet y seguir siendo gestionables a través de MKController.
¿Qué Sucede Cuando el Agente Se Desconecta?
Si el asistente de escritorio deja de ejecutarse o pierde el acceso a Internet, MKController muestra su estado como desconectado y proporciona una vía de recuperación.
Pasos de recuperación:
- Vuelva a abrir la aplicación de escritorio si estaba cerrada.
- Verifique que la computadora tenga acceso a Internet.
- Use Probar Agente o Configurar Agente de Nuevo si se le solicita.
- Regrese a MKController y espere a que el indicador de estado se vuelva verde.
¿Necesita ayuda con la instalación? Contacte a nuestro equipo por WhatsApp — podemos guiarle ante cualquier problema específico del sistema operativo.