MikroTik에 MKController 에이전트 설치하기
요약 MKController 에이전트는 로컬 네트워크를 스캔하여 MikroTik 디바이스를 검색하고, 클릭 한 번으로 MKController에 어답션할 수 있는 소형 데스크톱 애플리케이션입니다. 현장에서의 수동 스크립트 실행을 대체합니다. 이 가이드에서는 에이전트의 역할, Windows·macOS·Linux 설치 방법, 설치 중 표시되는 인증서 경고 처리 방법을 설명합니다.
MKController 에이전트란 무엇인가요?
MKController 에이전트는 로컬 네트워크와 MKController 클라우드 플랫폼을 연결하는 경량 데스크톱 도구입니다. 컴퓨터에서 실행되며, LAN에서 호환되는 MikroTik 디바이스를 스캔하여 플랫폼의 어답션 플로우에 원클릭 어답션 버튼과 함께 표시합니다. 각 디바이스에 수동으로 스크립트를 복사하고 실행하는 번거로움을 없애줍니다.
UniFi 디바이스 디스커버리 툴 또는 유사한 벤더 어시스턴트에 익숙하신 분들이라면 바로 이해하실 수 있는 워크플로입니다. 로컬 프로세스가 검색을 담당하고, 클라우드 플랫폼이 관리를 담당합니다.
중요한 구분: 검색과 어답션은 별개의 작업입니다. 에이전트는 대상 디바이스를 찾아 표시할 뿐이며, 자동으로 어답션하거나 변경을 가하지 않습니다. 모든 어답션은 사용자의 명시적인 확인이 필요합니다.
에이전트를 사용해야 할 때와 수동 방법을 사용해야 할 때
| 시나리오 | 권장 방법 |
|---|---|
| 여러 디바이스가 있는 신규 사이트 최초 배포 | 에이전트 — 호환 디바이스를 한 번에 검색 |
| 이미 온라인 상태인 디바이스의 원격 어답션 | WebFig·Winbox·SSH를 통한 수동 스크립트 |
| 클라이언트 납품 전 랩 스테이징 | 에이전트 |
| 단일 디바이스, 기술자가 이미 CLI 접근 가능 | 수동 스크립트 |
| 정기적인 고객 사이트 방문 | 에이전트로 반복 온보딩 효율화 |
MKController에서 에이전트는 어디에 표시되나요?
디바이스가 없는 신규 계정에서는 MKController가 에이전트 설치와 수동 스크립트라는 두 가지 온보딩 경로를 안내합니다.
이미 디바이스가 있는 계정에서는 디바이스 추가 메뉴에 어답션 어시스턴트 옵션이 표시됩니다.
플랫폼 왼쪽 하단의 상태 표시기를 통해 에이전트가 켜짐(녹색), 대기 중, 또는 꺼짐 상태인지 항상 확인할 수 있습니다.
에이전트를 설치하고 연결하는 방법은?
설치는 다운로드·페어링·확인의 3단계로 완료됩니다.
- MKController에서 에이전트 다운로드를 클릭합니다.
- 다운로드한 설치 프로그램을 컴퓨터에서 실행합니다.
- 플랫폼에 표시된 페어링 코드를 복사합니다.
- 해당 코드를 데스크톱 앱에 붙여넣습니다.
- 플랫폼이 연결을 확인할 때까지 기다립니다 — 수동 설정은 필요 없습니다.
코드를 입력하면 연결이 자동으로 설정됩니다. 검색 규칙 설정도, 터미널 명령어도, 방화벽 예외 설정도 필요 없습니다.
OS에서 인증서 경고가 표시되는 이유는 무엇인가요?
MKController 인증서는 현재 승인 프로세스 중에 있습니다. 이 기간 동안 설치 프로그램을 실행하면 Windows·macOS·Linux에서 보안 메시지가 표시될 수 있습니다. 이는 인증서 승인을 기다리는 새 소프트웨어에서 나타나는 정상적인 동작이며, 에이전트가 안전하지 않다는 의미가 아닙니다.
Windows: 보호된 앱 경고가 표시되면 추가 정보를 클릭하고 설치를 허용하세요. 기업 환경에서는 IT 관리자의 일회성 승인이 필요할 수 있습니다.
macOS: macOS가 설치 프로그램을 차단하면 시스템 설정 → 개인 정보 보호 및 보안으로 이동하여 스크롤하고 차단된 앱을 승인하세요. 그런 다음 설치 프로그램을 다시 실행합니다.
Linux: 다운로드한 파일에 실행 권한이 있는지 확인하세요. 제한된 환경에서는 관리자가 패키지 소스를 승인해야 할 수 있습니다.
에이전트가 온라인 상태임을 확인하는 방법은?
에이전트가 설치되어 실행 중이면 MKController는 플랫폼 왼쪽 하단에 녹색 켜짐 상태를 표시합니다.
이 상태가 되면 어답션 어시스턴트가 네트워크를 스캔하여 검색 가능한 디바이스를 나열할 수 있습니다.
디바이스를 스캔하고 어답션하는 방법은?
에이전트가 온라인 상태가 되면 MKController는 로컬 네트워크를 스캔하고 호환 디바이스를 어답션 버튼과 함께 나열합니다.
몇 가지 실용적인 참고 사항:
- 스캔은 에이전트가 실행 중인 컴퓨터의 네트워크에 있는 디바이스에 도달합니다.
- 디바이스는 해당 네트워크 세그먼트에서 접근 가능해야 합니다.
- 어답션 워크플로는 MKController 플랫폼이 조율하므로 인터넷 연결이 계속 필요합니다.
어답션 후에는 디바이스를 인터넷 접근이 가능한 어떤 네트워크로 이동시켜도 MKController를 통해 계속 관리할 수 있습니다.
에이전트가 오프라인이 되면 어떻게 되나요?
데스크톱 헬퍼가 중지되거나 인터넷 연결을 잃으면 MKController는 오프라인 상태를 표시하고 복구 경로를 안내합니다.
복구 단계:
- 앱이 닫혀 있었다면 데스크톱 앱을 다시 엽니다.
- 컴퓨터의 인터넷 연결을 확인합니다.
- 메시지가 표시되면 에이전트 테스트 또는 에이전트 재설정을 사용합니다.
- MKController로 돌아와 상태 표시기가 녹색으로 바뀔 때까지 기다립니다.
설치에 어려움이 있으신가요? WhatsApp으로 팀에 문의하세요 — OS별 문제도 친절하게 안내해 드립니다.