Instalar o Agente MKController no MikroTik
Resumo O Agente MKController é um pequeno aplicativo de desktop que escaneia sua rede local, descobre dispositivos MikroTik e permite que você os adote no MKController com um único clique — substituindo a execução manual de scripts para implantações no local. Este guia explica o que o agente faz, como instalá-lo no Windows, macOS e Linux, e como lidar com o aviso de certificado que aparece durante a instalação.
O Que É o Agente MKController?
O Agente MKController é um auxiliar de desktop leve que conecta sua rede local à plataforma cloud do MKController. Ele roda no seu computador, escaneia a LAN em busca de dispositivos MikroTik compatíveis e os apresenta no fluxo de adoção da plataforma com um botão Adotar de um clique — eliminando a necessidade de copiar e executar manualmente scripts de adoção em cada dispositivo.
Para equipes familiarizadas com a Ferramenta de Descoberta de Dispositivos UniFi ou assistentes similares de outros fabricantes, o fluxo de trabalho é diretamente comparável: um processo local cuida da descoberta, e a plataforma cloud cuida do gerenciamento.
A distinção principal: descoberta e adoção são ações separadas. O agente localiza os dispositivos elegíveis e os exibe para você — ele não adota nem modifica nada automaticamente. Cada adoção requer sua confirmação explícita.
Quando Usar o Agente vs. o Método Manual?
| Cenário | Método recomendado |
|---|---|
| Primeira implantação em um novo site com vários dispositivos | Agente — descobre todos os dispositivos compatíveis de uma vez |
| Adoção remota de um dispositivo já online | Script manual via WebFig, Winbox ou SSH |
| Preparação em laboratório antes de enviar ao site do cliente | Agente |
| Dispositivo único, técnico já tem acesso à CLI | Script manual |
| Visitas recorrentes a sites de clientes | O agente acelera o onboarding repetido |
Onde o Agente Aparece no MKController?
Em uma conta nova sem dispositivos, o MKController destaca dois caminhos de onboarding: instalar o agente ou usar o script manual.
Em contas que já têm dispositivos, o menu Adicionar Dispositivo inclui a opção do Assistente de Adoção.
Um indicador de status no canto inferior esquerdo da plataforma mostra se o agente está Ativo (verde), Pendente ou Inativo — para que você sempre saiba se o auxiliar de desktop está pronto para escanear.
Como Instalar e Conectar o Agente?
O fluxo de instalação tem três etapas: baixar, emparelhar, confirmar.
- Clique em Baixar Agente no MKController.
- Execute o instalador baixado no seu computador.
- Copie o código de emparelhamento exibido na plataforma.
- Cole esse código no aplicativo de desktop.
- Aguarde a plataforma confirmar a conexão — nenhuma configuração manual é necessária.
Assim que o código é inserido, a conexão é estabelecida automaticamente. Sem regras de descoberta, sem comandos de terminal, sem exceções de firewall.
Por Que o Sistema Operacional Exibe um Aviso de Certificado?
Os certificados do MKController estão atualmente em processo de aprovação. Durante esse período, Windows, macOS e Linux podem exibir um alerta de segurança ao executar o instalador. Esse é o comportamento esperado para softwares recém-distribuídos com aprovação de certificado pendente — não indica que o agente seja inseguro.
Windows: Se o sistema exibir um aviso de aplicativo protegido, clique em Mais informações e permita a instalação. Ambientes corporativos podem exigir aprovação pontual do administrador de TI.
macOS: Se o macOS bloquear o instalador, vá em Configurações do Sistema → Privacidade e Segurança, role para baixo e aprove o aplicativo bloqueado. Em seguida, execute o instalador novamente.
Linux: Certifique-se de que o arquivo baixado tenha permissão de execução. Em ambientes restritos, seu administrador pode precisar aprovar a fonte do pacote.
Como Confirmar que o Agente Está Online?
Quando o agente está instalado e em execução, o MKController exibe seu status como Ativo em verde no canto inferior esquerdo da plataforma.
Nesse ponto, o Assistente de Adoção pode escanear sua rede e listar os dispositivos detectáveis.
Como Escanear e Adotar Dispositivos?
Com o agente online, o MKController escaneia a rede local e lista os dispositivos compatíveis com um botão Adotar ao lado de cada um.
Algumas observações práticas:
- O escaneamento alcança dispositivos na rede onde o computador do agente está rodando.
- Os dispositivos precisam estar acessíveis nesse segmento de rede.
- A conectividade com a internet ainda é necessária, pois o fluxo de adoção é coordenado pela plataforma MKController.
Após a adoção, os dispositivos podem ser fisicamente realocados para qualquer rede com acesso à internet e continuam gerenciáveis pelo MKController.
O Que Acontece Quando o Agente Fica Offline?
Se o auxiliar de desktop parar de funcionar ou perder acesso à internet, o MKController exibe seu status como offline e oferece um caminho de recuperação.
Etapas de recuperação:
- Reabra o aplicativo de desktop se estiver fechado.
- Verifique se o computador tem acesso à internet.
- Use Testar Agente ou Configurar Agente Novamente se solicitado.
- Volte ao MKController e aguarde o indicador de status ficar verde.
Precisa de ajuda com a instalação? Fale com nossa equipe pelo WhatsApp — podemos te guiar em qualquer problema específico do sistema operacional.