MKController-Agent auf MikroTik installieren
Zusammenfassung Der MKController-Agent ist eine kleine Desktop-Anwendung, die Ihr lokales Netzwerk scannt, MikroTik-Geräte entdeckt und deren Übernahme in MKController per Mausklick ermöglicht — und damit die manuelle Skriptausführung bei Vor-Ort-Installationen ersetzt. Diese Anleitung erklärt, was der Agent leistet, wie Sie ihn unter Windows, macOS und Linux installieren und wie Sie mit der Zertifikatswarnung umgehen, die während der Installation erscheinen kann.
Was ist der MKController-Agent?
Der MKController-Agent ist ein schlankes Desktop-Hilfsprogramm, das Ihr lokales Netzwerk mit der MKController-Cloud-Plattform verbindet. Er läuft auf Ihrem Computer, durchsucht das LAN nach kompatiblen MikroTik-Geräten und stellt diese im Adoptions-Workflow der Plattform mit einer Ein-Klick-Schaltfläche Übernehmen bereit — ohne dass Sie auf jedem Gerät manuell Adoptionsskripte kopieren und ausführen müssen.
Teams, die mit dem UniFi-Geräteerkennungstool oder ähnlichen Herstellerassistenten vertraut sind, werden den Arbeitsablauf sofort wiedererkennen: Ein lokaler Prozess übernimmt die Erkennung, die Cloud-Plattform übernimmt die Verwaltung.
Der entscheidende Unterschied: Erkennung und Übernahme sind getrennte Aktionen. Der Agent findet geeignete Geräte und zeigt sie Ihnen an — er übernimmt oder ändert nichts automatisch. Jede Übernahme erfordert Ihre ausdrückliche Bestätigung.
Wann sollten Sie den Agent statt der manuellen Methode verwenden?
| Szenario | Empfohlene Methode |
|---|---|
| Erstinstallation an einem neuen Standort mit mehreren Geräten | Agent — findet alle kompatiblen Geräte auf einen Schlag |
| Fernübernahme eines bereits online befindlichen Geräts | Manuelles Skript über WebFig, Winbox oder SSH |
| Laborvorbereitung vor der Lieferung an den Kundenstandort | Agent |
| Einzelgerät, Techniker hat bereits CLI-Zugriff | Manuelles Skript |
| Wiederkehrende Kundenstandortbesuche | Agent beschleunigt das wiederholte Onboarding |
Wo erscheint der Agent in MKController?
Bei einem neuen Konto ohne Geräte hebt MKController zwei Onboarding-Wege hervor: Agent installieren oder manuelles Skript verwenden.
Bei Konten, die bereits Geräte haben, enthält das Menü Gerät hinzufügen die Option für den Adoption-Assistenten.
Ein Statusindikator in der unteren linken Ecke der Plattform zeigt an, ob der Agent Aktiv (grün), Ausstehend oder Inaktiv ist — damit Sie jederzeit wissen, ob das Desktop-Hilfsprogramm scanbereit ist.
Wie wird der Agent installiert und verbunden?
Der Installationsvorgang umfasst drei Schritte: herunterladen, koppeln, bestätigen.
- Klicken Sie in MKController auf Agent herunterladen.
- Führen Sie das heruntergeladene Installationsprogramm auf Ihrem Computer aus.
- Kopieren Sie den auf der Plattform angezeigten Kopplungscode.
- Fügen Sie diesen Code in die Desktop-Anwendung ein.
- Warten Sie, bis die Plattform die Verbindung bestätigt — keine manuelle Konfiguration erforderlich.
Nach der Code-Eingabe wird die Verbindung automatisch hergestellt. Keine Erkennungsregeln, keine Terminal-Befehle, keine Firewall-Ausnahmen erforderlich.
Warum zeigt das Betriebssystem eine Zertifikatswarnung an?
Die MKController-Zertifikate befinden sich derzeit im Genehmigungsprozess. In dieser Zeit können Windows, macOS und Linux beim Ausführen des Installationsprogramms eine Sicherheitswarnung anzeigen. Dies ist ein erwartetes Verhalten bei neu vertriebener Software mit ausstehender Zertifikatsgenehmigung — es bedeutet nicht, dass der Agent unsicher ist.
Windows: Wenn das System eine Warnung für geschützte Apps anzeigt, klicken Sie auf Weitere Informationen und erlauben Sie die Installation. In Unternehmensumgebungen kann eine einmalige Genehmigung durch den IT-Administrator erforderlich sein.
macOS: Wenn macOS das Installationsprogramm blockiert, wechseln Sie zu Systemeinstellungen → Datenschutz & Sicherheit, scrollen Sie nach unten und genehmigen Sie die blockierte Anwendung. Führen Sie dann das Installationsprogramm erneut aus.
Linux: Stellen Sie sicher, dass die heruntergeladene Datei Ausführungsrechte hat. In restriktiven Umgebungen muss Ihr Administrator möglicherweise die Paketquelle genehmigen.
Wie bestätigen Sie, dass der Agent online ist?
Wenn der Agent installiert und aktiv ist, zeigt MKController seinen Status in der unteren linken Ecke der Plattform als Aktiv in Grün an.
Zu diesem Zeitpunkt kann der Adoption-Assistent Ihr Netzwerk scannen und erkennbare Geräte auflisten.
Wie werden Geräte gescannt und übernommen?
Bei aktivem Agent scannt MKController das lokale Netzwerk und listet kompatible Geräte mit einer Schaltfläche Übernehmen neben jedem Gerät auf.
Einige praktische Hinweise:
- Der Scan erfasst Geräte in dem Netzwerk, in dem der Computer des Agents läuft.
- Geräte müssen in diesem Netzwerksegment erreichbar sein.
- Eine Internetverbindung ist weiterhin erforderlich, da der Adoptions-Workflow von der MKController-Plattform koordiniert wird.
Nach der Übernahme können Geräte physisch in ein beliebiges Netzwerk mit Internetzugang verlagert werden und bleiben über MKController verwaltbar.
Was passiert, wenn der Agent offline geht?
Wenn das Desktop-Hilfsprogramm nicht mehr läuft oder den Internetzugang verliert, zeigt MKController seinen Status als offline an und bietet einen Wiederherstellungspfad.
Wiederherstellungsschritte:
- Öffnen Sie die Desktop-Anwendung erneut, falls sie geschlossen war.
- Überprüfen Sie, ob der Computer über Internetzugang verfügt.
- Verwenden Sie Agent testen oder Agent neu konfigurieren, falls Sie dazu aufgefordert werden.
- Kehren Sie zu MKController zurück und warten Sie, bis der Statusindikator grün wird.
Benötigen Sie Hilfe bei der Installation? Kontaktieren Sie unser Team auf WhatsApp — wir begleiten Sie bei allen betriebssystemspezifischen Fragen.