MKController Agent installeren op MikroTik
Samenvatting De MKController Agent is een kleine desktopapplicatie die uw lokale netwerk scant, MikroTik-apparaten ontdekt en u in staat stelt deze met één klik in MKController te adopteren — zonder handmatige scriptuitvoering bij deployments op locatie. Deze handleiding legt uit wat de agent doet, hoe u hem installeert op Windows, macOS en Linux, en hoe u omgaat met de certificaatwaarschuwing die tijdens de installatie kan verschijnen.
Wat is de MKController Agent?
De MKController Agent is een lichtgewicht desktophulpmiddel dat uw lokale netwerk verbindt met het MKController-cloudplatform. Het draait op uw computer, scant het LAN op compatibele MikroTik-apparaten en presenteert deze in de adoptieflow van het platform met een Adopteren-knop — zonder dat u handmatig adoptiescripts op elk apparaat hoeft te kopiëren en uit te voeren.
Voor teams die bekend zijn met de UniFi Device Discovery Tool of vergelijkbare leveranciershulpmiddelen, is de workflow direct vergelijkbaar: een lokaal proces verzorgt de ontdekking en het cloudplatform verzorgt het beheer.
Het belangrijkste onderscheid: ontdekken en adopteren zijn afzonderlijke acties. De agent lokaliseert in aanmerking komende apparaten en presenteert deze aan u — hij adopteert of wijzigt niets automatisch. Elke adoptie vereist uw expliciete bevestiging.
Wanneer gebruikt u de Agent versus de handmatige methode?
| Scenario | Aanbevolen methode |
|---|---|
| Eerste inzet op een nieuwe locatie met meerdere apparaten | Agent — ontdekt alle compatibele apparaten tegelijk |
| Externe adoptie van een apparaat dat al online is | Handmatig script via WebFig, Winbox of SSH |
| Lab-staging vóór verzending naar klantlocatie | Agent |
| Eén apparaat, technicus heeft al CLI-toegang | Handmatig script |
| Terugkerende bezoeken aan klantlocatie | Agent versnelt herhaalde onboarding |
Waar verschijnt de Agent in MKController?
Op een nieuw account zonder apparaten toont MKController twee onboardingpaden: de agent installeren of het handmatige script gebruiken.
Op accounts met bestaande apparaten bevat het menu Apparaat toevoegen de optie Adoptieassistent.
Een statusindicator linksonder in het platform toont of de agent Aan (groen), In behandeling of Uit is — zodat u altijd weet of de desktophulp klaar is om te scannen.
Hoe installeert en verbindt u de Agent?
De installatie verloopt in drie stappen: downloaden, koppelen, bevestigen.
- Klik op Agent downloaden in MKController.
- Voer het gedownloade installatieprogramma uit op uw computer.
- Kopieer de koppelcode die in het platform wordt weergegeven.
- Plak deze code in de desktopapplicatie.
- Wacht tot het platform de verbinding bevestigt — geen handmatige configuratie vereist.
Zodra de code is ingevoerd, wordt de verbinding automatisch tot stand gebracht. Geen discovery-regels, geen terminalcommando’s, geen firewall-uitzonderingen nodig.
Waarom toont het besturingssysteem een certificaatwaarschuwing?
MKController-certificaten bevinden zich momenteel in het goedkeuringsproces. Gedurende deze periode kunnen Windows, macOS en Linux een beveiligingsprompt weergeven wanneer u het installatieprogramma uitvoert. Dit is normaal gedrag voor nieuw gedistribueerde software die wacht op certificaatgoedkeuring — het geeft niet aan dat de agent onveilig is.
Windows: Als het systeem een waarschuwing voor een beveiligde app toont, klikt u op Meer informatie en staat u de installatie toe. In bedrijfsomgevingen kan eenmalige goedkeuring door de IT-beheerder vereist zijn.
macOS: Als macOS het installatieprogramma blokkeert, ga naar Systeeminstellingen → Privacy en beveiliging, scroll naar beneden en keur de geblokkeerde applicatie goed. Voer vervolgens het installatieprogramma opnieuw uit.
Linux: Zorg ervoor dat het gedownloade bestand uitvoerrechten heeft. In beveiligde omgevingen moet uw beheerder mogelijk de pakketbron goedkeuren.
Hoe bevestigt u dat de Agent online is?
Wanneer de agent is geïnstalleerd en actief is, toont MKController de status als Aan in groen linksonder in het platform.
Op dit punt kan de Adoptieassistent uw netwerk scannen en ontdekbare apparaten weergeven.
Hoe scant en adopteert u apparaten?
Met de agent online scant MKController het lokale netwerk en geeft compatibele apparaten weer met een Adopteren-knop ernaast.
Enkele praktische opmerkingen:
- De scan bereikt apparaten op het netwerk waar de computer van de agent actief is.
- Apparaten moeten toegankelijk zijn op dat netwerksegment.
- Internetverbinding is nog steeds vereist, aangezien de adoptieworkflow wordt gecoördineerd door het MKController-platform.
Na adoptie kunnen apparaten fysiek worden verplaatst naar elk netwerk met internettoegang en blijven ze beheerbaar via MKController.
Wat gebeurt er als de Agent offline gaat?
Als de desktophulp stopt of de internetverbinding verliest, toont MKController de status als offline en biedt een herstelpad.
Herstelstappen:
- Heropen de desktopapplicatie als deze was gesloten.
- Controleer of de computer internetverbinding heeft.
- Gebruik Agent testen of Agent opnieuw configureren indien gevraagd.
- Keer terug naar MKController en wacht tot de statusindicator groen wordt.
Zodra de agent is verbonden en uw apparaten zijn geadopteerd, ontdekt u het volledige beheerplatform: Bewaak de apparaatbeschikbaarheid, stel geautomatiseerde back-ups in en configureer Telegram-meldingen voor offline-notificaties. Voor de standaard browsergebaseerde adoptie-workflow (zonder de desktopagent), zie de MikroTik Onboarding-handleiding.
Hulp nodig bij de installatie? Neem contact op met ons team via WhatsApp — wij begeleiden u bij elk besturingssysteemspecifiek probleem.