MKController エージェントを MikroTik にインストールする
概要 MKController エージェントは、ローカルネットワークをスキャンして MikroTik デバイスを検出し、ワンクリックで MKController に採用できる小型のデスクトップアプリケーションです。現地でのスクリプト手動実行を不要にします。このガイドでは、エージェントの役割、Windows・macOS・Linux へのインストール方法、インストール時に表示される証明書の警告への対処法を説明します。
MKController エージェントとは？
MKController エージェントは、ローカルネットワークと MKController クラウドプラットフォームを橋渡しする軽量なデスクトップツールです。コンピューター上で動作し、LAN 上の対応 MikroTik デバイスをスキャンして、プラットフォームの採用フローにワンクリックの 採用 ボタンとともに表示します。各デバイスに手動でスクリプトをコピー・実行する手間を省けます。
UniFi デバイスディスカバリーツール や類似のベンダーアシスタントに慣れている方には、同様のワークフローとしてすぐに理解できます。ローカルプロセスが検出を担当し、クラウドプラットフォームが管理を担当する仕組みです。
重要な区別： 検出と採用は別々のアクションです。エージェントは対象デバイスを見つけて表示するだけで、自動的に採用したり変更を加えたりすることはありません。すべての採用にはユーザーの明示的な確認が必要です。
エージェントを使うべき場合と手動方法を使うべき場合
| シナリオ | 推奨する方法 |
|---|---|
| 複数デバイスを含む新規サイトへの初回導入 | エージェント — 対応デバイスをまとめて検出 |
| すでにオンラインのデバイスへのリモート採用 | WebFig・Winbox・SSH による手動スクリプト |
| クライアント納品前のラボでのステージング | エージェント |
| 単一デバイス、技術者がすでに CLI アクセス可能 | 手動スクリプト |
| 定期的な顧客サイト訪問 | エージェントで繰り返しのオンボーディングを効率化 |
MKController のどこにエージェントが表示されますか？
デバイスがまだない新規アカウントでは、MKController はエージェントのインストールと手動スクリプトの 2 つのオンボーディング方法を案内します。
すでにデバイスがあるアカウントでは、デバイスを追加 メニューに採用アシスタントのオプションが表示されます。
プラットフォーム左下のステータスインジケーターで、エージェントが オン（緑）、保留中、または オフ のいずれの状態かを常に確認できます。
エージェントをインストールして接続するには？
インストールは、ダウンロード・ペアリング・確認の 3 ステップで完了します。
- MKController で エージェントをダウンロード をクリックします。
- ダウンロードしたインストーラーをコンピューターで実行します。
- プラットフォームに表示されたペアリングコードをコピーします。
- そのコードをデスクトップアプリに貼り付けます。
- プラットフォームが接続を確認するまで待ちます — 手動設定は不要です。
コードを入力すると、接続が自動的に確立されます。探索ルールの設定も、ターミナルコマンドも、ファイアウォールの例外設定も一切不要です。
OS に証明書の警告が表示されるのはなぜですか？
MKController の証明書は現在承認プロセス中です。この期間中、インストーラーを実行すると Windows・macOS・Linux でセキュリティプロンプトが表示されることがあります。これは証明書承認待ちの新しいソフトウェアに見られる正常な動作であり、エージェントが安全でないことを意味するものではありません。
Windows： 保護されたアプリの警告が表示された場合は、詳細情報 をクリックしてインストールを許可してください。企業環境では IT 管理者による一度限りの承認が必要な場合があります。
macOS： macOS がインストーラーをブロックした場合は、システム設定 → プライバシーとセキュリティ に移動してスクロールし、ブロックされたアプリケーションを承認してください。その後、インストーラーを再実行します。
Linux： ダウンロードしたファイルに実行権限があることを確認してください。制限のある環境では、管理者によるパッケージソースの承認が必要な場合があります。
エージェントがオンラインであることを確認するには？
エージェントがインストールされ起動している場合、MKController はプラットフォーム左下にステータスを緑の オン として表示します。
この状態になると、採用アシスタントがネットワークをスキャンして検出可能なデバイスを一覧表示できます。
デバイスをスキャンして採用するには？
エージェントがオンラインになると、MKController はローカルネットワークをスキャンし、対応デバイスを 採用 ボタン付きで一覧表示します。
いくつかの実用的な注意点：
- スキャンはエージェントが動作しているコンピューターのネットワーク上のデバイスに届きます。
- デバイスはそのネットワークセグメント上でアクセス可能である必要があります。
- 採用ワークフローは MKController プラットフォームが調整するため、インターネット接続が引き続き必要です。
採用後、デバイスはインターネット接続がある任意のネットワークに物理的に移動しても、MKController を通じて管理し続けることができます。
エージェントがオフラインになった場合は？
デスクトップヘルパーが停止またはインターネット接続を失うと、MKController はオフライン状態を表示し、回復手順を案内します。
回復手順：
- アプリが閉じられていた場合はデスクトップアプリを再起動します。
- コンピューターのインターネット接続を確認します。
- 画面の指示に従って エージェントをテスト または エージェントを再設定 を使用します。
- MKController に戻り、ステータスインジケーターが緑になるまで待ちます。
インストールでお困りですか？WhatsApp でサポートチームにお問い合わせください — OS 固有の問題も丁寧にご案内します。