Installa l'Agente MKController su MikroTik
Sommario L’Agente MKController è una piccola applicazione desktop che esegue la scansione della rete locale, individua i dispositivi MikroTik e consente di adottarli in MKController con un solo clic — sostituendo l’esecuzione manuale degli script per le installazioni in loco. Questa guida spiega cosa fa l’agente, come installarlo su Windows, macOS e Linux, e come gestire l’avviso di certificato che appare durante l’installazione.
Che Cos’è l’Agente MKController?
L’Agente MKController è un assistente desktop leggero che collega la rete locale alla piattaforma cloud MKController. Viene eseguito sul computer, esegue la scansione della LAN alla ricerca di dispositivi MikroTik compatibili e li presenta nel flusso di adozione della piattaforma con un pulsante Adotta in un clic — eliminando la necessità di copiare ed eseguire manualmente script di adozione su ciascun dispositivo.
Per i team che hanno familiarità con lo Strumento di Rilevamento Dispositivi UniFi o assistenti simili di altri produttori, il flusso di lavoro è direttamente comparabile: un processo locale gestisce il rilevamento e la piattaforma cloud gestisce l’amministrazione.
La distinzione chiave: il rilevamento e l’adozione sono azioni separate. L’agente individua i dispositivi idonei e li mostra — non adotta né modifica nulla automaticamente. Ogni adozione richiede la sua conferma esplicita.
Quando Usare l’Agente rispetto al Metodo Manuale?
| Scenario | Metodo consigliato |
|---|---|
| Prima installazione in un nuovo sito con più dispositivi | Agente — rileva tutti i dispositivi compatibili in una volta |
| Adozione remota di un dispositivo già online | Script manuale tramite WebFig, Winbox o SSH |
| Preparazione in laboratorio prima della spedizione al sito del cliente | Agente |
| Dispositivo singolo, il tecnico ha già accesso alla CLI | Script manuale |
| Visite ricorrenti ai siti dei clienti | L’agente accelera l’onboarding ripetuto |
Dove Appare l’Agente in MKController?
Su un nuovo account senza dispositivi, MKController evidenzia due percorsi di onboarding: installare l’agente o utilizzare lo script manuale.
Sugli account che hanno già dispositivi, il menu Aggiungi Dispositivo include l’opzione dell’Assistente di Adozione.
Un indicatore di stato nell’angolo inferiore sinistro della piattaforma mostra se l’agente è Attivo (verde), In attesa o Inattivo — così sa sempre se l’assistente desktop è pronto per la scansione.
Come Si Installa e Connette l’Agente?
Il flusso di installazione comprende tre passaggi: scaricare, abbinare, confermare.
- Clicchi su Scarica Agente in MKController.
- Esegua il programma di installazione scaricato sul suo computer.
- Copi il codice di abbinamento visualizzato sulla piattaforma.
- Incolli quel codice nell’applicazione desktop.
- Attenda che la piattaforma confermi la connessione — nessuna configurazione manuale è richiesta.
Una volta inserito il codice, la connessione viene stabilita automaticamente. Nessuna regola di rilevamento, nessun comando di terminale, nessuna eccezione del firewall.
Perché il Sistema Operativo Mostra un Avviso di Certificato?
I certificati MKController sono attualmente in fase di approvazione. Durante questo periodo, Windows, macOS e Linux potrebbero visualizzare un avviso di sicurezza durante l’esecuzione del programma di installazione. Questo è il comportamento previsto per i software di nuova distribuzione in attesa di approvazione del certificato — non indica che l’agente sia pericoloso.
Windows: Se il sistema mostra un avviso di app protetta, clicchi su Ulteriori informazioni e consenta l’installazione. Negli ambienti aziendali potrebbe essere necessaria l’approvazione una tantum dell’amministratore IT.
macOS: Se macOS blocca il programma di installazione, vada su Impostazioni di Sistema → Privacy e Sicurezza, scorra verso il basso e approvi l’applicazione bloccata. Quindi riesegua il programma di installazione.
Linux: Si assicuri che il file scaricato abbia i permessi di esecuzione. Negli ambienti con restrizioni, il suo amministratore potrebbe dover approvare la fonte del pacchetto.
Come Confermare che l’Agente è Online?
Quando l’agente è installato e in esecuzione, MKController mostra il suo stato come Attivo in verde nell’angolo inferiore sinistro della piattaforma.
A questo punto l’Assistente di Adozione può eseguire la scansione della rete e elencare i dispositivi rilevabili.
Come Si Esegue la Scansione e Si Adottano i Dispositivi?
Con l’agente online, MKController esegue la scansione della rete locale e elenca i dispositivi compatibili con un pulsante Adotta accanto a ciascuno.
Alcune note pratiche:
- La scansione raggiunge i dispositivi sulla rete dove è in esecuzione il computer dell’agente.
- I dispositivi devono essere accessibili su quel segmento di rete.
- La connettività Internet è comunque necessaria, poiché il flusso di adozione è coordinato dalla piattaforma MKController.
Dopo l’adozione, i dispositivi possono essere fisicamente spostati in qualsiasi rete con accesso a Internet e rimangono gestibili tramite MKController.
Cosa Succede Quando l’Agente Va Offline?
Se l’assistente desktop smette di funzionare o perde l’accesso a Internet, MKController mostra il suo stato come offline e fornisce un percorso di ripristino.
Passaggi di ripristino:
- Riapra l’applicazione desktop se era chiusa.
- Verifichi che il computer abbia accesso a Internet.
- Utilizzi Testa Agente o Riconfigura Agente se richiesto.
- Torni su MKController e attenda che l’indicatore di stato diventi verde.
Ha bisogno di aiuto con l’installazione? Contatti il nostro team su WhatsApp — possiamo guidarla attraverso qualsiasi problema specifico del sistema operativo.