World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Unofficial MCP server for the UniFi Site Manager and Network cloud APIs, with a write-confirm guard.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 12/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
UniFi Site Manager and Network (unofficial) をインストールして。https://mcp.popnx.com/i/mguttmann-the-real-unifi-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
UniFi Site Manager and Network (unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が UniFi Site Manager and Network (unofficial) を使っていると言うか、回答に UniFi Site Manager and Network (unofficial) のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
UNIFI_CONFIRM_WRITES 書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。 UNIFI_API_BASE API base URL; this host receives the API key. https origin only (http only for loopback test stubs). Keep the default. · 初期値 https://api.ui.comUNIFI_TIMEOUT_MS リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。 UNIFI_LOG_LEVEL stderr のログレベル:debug、info、warn、error のいずれか。 UNIFI_CONSOLE_ID UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。 UNIFI_NETWORK_SITE_ID Network のサイトを自動検出せず固定します。 UNIFI_SITE_MANAGER_SITE_ID Site Manager のサイトを自動検出せず固定します。 UNIFI_READ_ONLY 読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。 UNIFI_REDACT_SECRETS すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。 UNIFI_MAX_RESULT_BYTES このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ UniFi Site Manager and Network (unofficial) につなげません
UniFi Site Manager and Network (unofficial) はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · UniFi Site Manager and Network (unofficial) につなげるアプリを使う
B · その他 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server UniFi Site Manager and Network (unofficial) を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user the-real-unifi --env UNIFI_API_KEY=your-value -- npx -y the-real-unifi-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) UNIFI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、UniFi Site Manager and Network (unofficial) のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user the-real-unifi --env UNIFI_API_KEY=your-value -- npx -y the-real-unifi-mcpEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
UniFi Site Manager and Network (unofficial) が一覧にあり、接続済みと表示されれば OK です
UniFi Site Manager and Network (unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が UniFi Site Manager and Network (unofficial) を使っていると言うか、回答に UniFi Site Manager and Network (unofficial) のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
UNIFI_CONFIRM_WRITES 書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。 UNIFI_API_BASE API base URL; this host receives the API key. https origin only (http only for loopback test stubs). Keep the default. · 初期値 https://api.ui.comUNIFI_TIMEOUT_MS リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。 UNIFI_LOG_LEVEL stderr のログレベル:debug、info、warn、error のいずれか。 UNIFI_CONSOLE_ID UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。 UNIFI_NETWORK_SITE_ID Network のサイトを自動検出せず固定します。 UNIFI_SITE_MANAGER_SITE_ID Site Manager のサイトを自動検出せず固定します。 UNIFI_READ_ONLY 読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。 UNIFI_REDACT_SECRETS すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。 UNIFI_MAX_RESULT_BYTES このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server UniFi Site Manager and Network (unofficial) を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "the-real-unifi": { "command": "npx", "args": [ "-y", "the-real-unifi-mcp" ], "env": { "UNIFI_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) UNIFI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、UniFi Site Manager and Network (unofficial) のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
UniFi Site Manager and Network (unofficial) の設定で UNIFI_API_KEY が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
UniFi Site Manager and Network (unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が UniFi Site Manager and Network (unofficial) を使っていると言うか、回答に UniFi Site Manager and Network (unofficial) のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
UNIFI_CONFIRM_WRITES 書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。 UNIFI_API_BASE API base URL; this host receives the API key. https origin only (http only for loopback test stubs). Keep the default. · 初期値 https://api.ui.comUNIFI_TIMEOUT_MS リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。 UNIFI_LOG_LEVEL stderr のログレベル:debug、info、warn、error のいずれか。 UNIFI_CONSOLE_ID UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。 UNIFI_NETWORK_SITE_ID Network のサイトを自動検出せず固定します。 UNIFI_SITE_MANAGER_SITE_ID Site Manager のサイトを自動検出せず固定します。 UNIFI_READ_ONLY 読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。 UNIFI_REDACT_SECRETS すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。 UNIFI_MAX_RESULT_BYTES このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server UniFi Site Manager and Network (unofficial) を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "the-real-unifi": { "type": "stdio", "command": "npx", "args": [ "-y", "the-real-unifi-mcp" ], "env": { "UNIFI_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) UNIFI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、UniFi Site Manager and Network (unofficial) のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
UniFi Site Manager and Network (unofficial) の設定で UNIFI_API_KEY が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
UniFi Site Manager and Network (unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が UniFi Site Manager and Network (unofficial) を使っていると言うか、回答に UniFi Site Manager and Network (unofficial) のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
UNIFI_CONFIRM_WRITES 書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。 UNIFI_API_BASE API base URL; this host receives the API key. https origin only (http only for loopback test stubs). Keep the default. · 初期値 https://api.ui.comUNIFI_TIMEOUT_MS リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。 UNIFI_LOG_LEVEL stderr のログレベル:debug、info、warn、error のいずれか。 UNIFI_CONSOLE_ID UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。 UNIFI_NETWORK_SITE_ID Network のサイトを自動検出せず固定します。 UNIFI_SITE_MANAGER_SITE_ID Site Manager のサイトを自動検出せず固定します。 UNIFI_READ_ONLY 読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。 UNIFI_REDACT_SECRETS すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。 UNIFI_MAX_RESULT_BYTES このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user the-real-unifi --env UNIFI_API_KEY=your-value -- npx -y the-real-unifi-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"the-real-unifi": {
"command": "npx",
"args": [
"-y",
"the-real-unifi-mcp"
],
"env": {
"UNIFI_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"the-real-unifi": {
"command": "npx",
"args": [
"-y",
"the-real-unifi-mcp"
],
"env": {
"UNIFI_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"the-real-unifi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"the-real-unifi-mcp"
],
"env": {
"UNIFI_API_KEY": "your-value"
}
}
}
}UNIFI_API_KEY 秘密 必須 envUNIFI_CONFIRM_WRITES envUNIFI_API_BASE envUNIFI_TIMEOUT_MS envUNIFI_LOG_LEVEL envUNIFI_CONSOLE_ID envUNIFI_NETWORK_SITE_ID envUNIFI_SITE_MANAGER_SITE_ID envUNIFI_READ_ONLY envUNIFI_REDACT_SECRETS envUNIFI_MAX_RESULT_BYTES env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
npm: the-real-unifi-mcpmcpb: …/the-real-unifi-mcp-0.4.0.mcpbこのサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント mguttmann で確認済みです
コードの最終更新:3 日前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に the-real-unifi-mcp@0.4.0 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/mguttmann-the-real-unifi-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:UNIFI_API_KEY
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は3 日前、最新バージョン(0.4.0)がレジストリに届いたのは22 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.js, MCPBも必要です。
同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| これ UniFi Site Manager and Network (unofficial) | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| ライセンス | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
An MCP server that gives Claude (or any MCP client) full read/write access to the UniFi Site Manager and Network APIs over the official cloud endpoint. Cloud-only, stdio transport.
Unofficial project. This server is not affiliated with or endorsed by Ubiquiti Inc. UniFi and Ubiquiti are trademarks of Ubiquiti Inc., used here only to name the API this software works with; see NOTICE.
Point it at a UniFi Site Manager API key and your MCP client can list consoles, inspect devices and clients, and manage networks, WiFi, firewall policies, and more, through 169 tools covering the documented API surface.
tests/contract/tools-contract.json.UNIFI_CONFIRM_WRITES (default true) turns destructive tools into preview-then-confirm; set it to false to execute writes directly. The model itself can send confirm: "YES", so this is a speed bump, not a human approval (see SECURITY.md).engines: ^22.12.0 || ^24.0.0 || >=26.0.0, the range of the test toolchain vitest). Node 23 and 25 are not supported.No install step is needed: your MCP client starts the server with npx, which fetches the package from npm on first use.
npx -y the-real-unifi-mcp # starts the server on stdio; needs UNIFI_API_KEY in the environment
Or install it globally and use the the-real-unifi-mcp command:
npm install -g the-real-unifi-mcp
Pin a version (the-real-unifi-mcp@ ) if you want updates only when you change the config. Releases from v0.2.1 on are published to npm from GitHub Actions with provenance (v0.2.0 is a GitHub release only); npm audit signatures verifies it.
git clone https://github.com/mguttmann/the-real-unifi-mcp.git
cd the-real-unifi-mcp npm ci cp .env.example .env
npm run build # prebuild runs lint, typecheck and unit tests first npm start # node dist/index.js; reads .env from the current directory
npm ci
npm run build:mcpb
The bundle maps its settings (API key, confirm writes, read-only, hide secrets, log level) to the environment variables below as ${user_config. } placeholders. If a host starts the server without substituting them, a value that is still such a placeholder counts as unset: each switch keeps its default, the missing key stops the server, and a warning names the variable.
Releases from v0.2.0 on attach the .mcpb, the npm tarball, CycloneDX SBOMs and SHA256SUMS; see docs/RELEASING.md.
| Variable | Default | Description | |||
|---|---|---|---|---|---|
UNIFI_API_KEY | (required) | Site Manager API key with Network scope | |||
UNIFI_API_BASE | https://api.ui.com | API base URL. This host receives the API key: leave it at the default unless you test against a local stub. Must be https:// (plain http:// only for 127.0.0.1, [::1] or localhost) and an origin without path, query or fragment; anything else stops the server at startup. | |||
UNIFI_CONFIRM_WRITES | true | If on, destructive tools require confirm: "YES". Only false, 0, no or off (any case) turn it off. Unset, empty, true, 1, yes and on keep it on; an unknown value keeps it on and logs a warning. | |||
UNIFI_TIMEOUT_MS | 30000 | Per-request timeout (ms), covering the response headers and the body | |||
UNIFI_LOG_LEVEL | info | debug \ | info \ | warn \ | error |
UNIFI_CONSOLE_ID | (unset) | Override discovery (pin to a specific console; needed when the account owns several consoles or a host of another type) | |||
UNIFI_NETWORK_SITE_ID | (unset) | Override discovery (pin to a specific Network site) | |||
UNIFI_SITE_MANAGER_SITE_ID | (unset) | Override discovery (pin to a specific Site Manager site) | |||
UNIFI_READ_ONLY | false | If on, every tool with a confirm param (all write tools, and unifi_raw_request for methods other than GET) returns an error with code: "READ_ONLY" and sends no request; the tools stay listed. Same values as UNIFI_CONFIRM_WRITES; an unknown value turns it on and logs a warning. | |||
UNIFI_REDACT_SECRETS | false | If on, every tool result has the fields the confirm preview redacts (passwords, WiFi passphrases, pre-shared keys, secrets, tokens, keys) replaced by (redacted); paging tokens such as nextToken stay. MCP resources (unifi://hosts, unifi://identity) are not redacted. Write tools always refuse a body that contains the placeholder (see Write safety). Same values as UNIFI_READ_ONLY. | |||
UNIFI_MAX_RESULT_BYTES | 100000 | A tool result text longer than this many UTF-8 bytes is cut to it and ends with a ... (truncated: ...) marker that names the paging params. Unset or empty: the default (roughly 25,000 tokens of JSON). 0, off or none (any case): no cap. A positive integer sets the cap; any other value stops the server at startup. MCP resources are not cut. |
Add to claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": { "unifi": { "command": "npx", "args": ["-y", "the-real-unifi-mcp"], "env": { "UNIFI_API_KEY": " " } } } }
Any variable from Configuration can go into env. With a source checkout, use "command": "node" and "args": ["--env-file=/absolute/path/to/the-real-unifi-mcp/.env", "/absolute/path/to/the-real-unifi-mcp/dist/index.js"] instead.
Restart Claude Desktop after editing the file. The server exposes its tools under the unifi prefix.
Register the server with the Claude Code CLI (--scope user makes it available in every project; the default scope, local, keeps it private to you in the current project):
claude mcp add --scope user unifi --env UNIFI_API_KEY="YOUR_SITE_MANAGER_API_KEY" -- npx -y the-real-unifi-mcp
From a source checkout:
claude mcp add --scope user unifi -- node \
--env-file=/absolute/path/to/the-real-unifi-mcp/.env \ /absolute/path/to/the-real-unifi-mcp/dist/index.js
claude mcp list shows whether it connects.
Account-level tools against api.ui.com directly:
unifi_sm_list_hosts: list all UniFi consoles on the account (optional pageSize, nextToken)unifi_sm_get_host: detail for a single consoleunifi_sm_list_sites: account-level sites (optional pageSize, nextToken); the statistics object of each site is omitted unless includeStatistics: trueunifi_sm_list_devices: account-level device list (optional hostIds, time, pageSize, nextToken)unifi_sm_get_isp_metrics: ISP metrics by bucket (5m/1h), for beginTimestamp/endTimestamp or a duration (24h, 7d, 30d)unifi_sm_query_isp_metrics: query ISP metrics with a time windowunifi_sm_list_sdwan_configs: SD-WAN configurationsunifi_sm_get_sdwan_config: single SD-WAN configurationunifi_sm_get_sdwan_config_status: status of an SD-WAN configurationunifi_sm_identity: resolved consoleId, networkSiteId, siteManagerSiteIdPer-console tools via the Cloud Connector proxy, grouped by resource. Every unifi_net_list_* tool takes optional offset, limit and filter (vendor filter syntax); a result with more items carries a pagination hint with the next offset.
unifi_net_get_info, unifi_net_list_sitesunifi_net_list_devices, unifi_net_get_device, unifi_net_get_device_stats, unifi_net_list_pending_devices, unifi_net_adopt_devices, unifi_net_device_action, unifi_net_reboot_device, unifi_net_port_action, unifi_net_remove_deviceunifi_net_list_clients, unifi_net_get_client, unifi_net_client_action, unifi_net_block_client, unifi_net_unblock_client (block/unblock return a "not supported" error: the Network API has no such client action)unifi_net_list_networks, unifi_net_get_network, unifi_net_get_network_references, unifi_net_create_network, unifi_net_update_network, unifi_net_delete_networkunifi_net_list_wifi, unifi_net_get_wifi, unifi_net_create_wifi, unifi_net_update_wifi, unifi_net_delete_wifiunifi_net_list_firewall_zones, unifi_net_get_firewall_zone, unifi_net_create_firewall_zone, unifi_net_update_firewall_zone, unifi_net_delete_firewall_zone, unifi_net_list_firewall_policies, unifi_net_get_firewall_policy, unifi_net_create_firewall_policy, unifi_net_update_firewall_policy, unifi_net_patch_firewall_policy, unifi_net_delete_firewall_policy, unifi_net_get_firewall_policy_ordering, unifi_net_reorder_firewall_policiesunifi_net_list_acl_rules, unifi_net_get_acl_rule, unifi_net_create_acl_rule, unifi_net_update_acl_rule, unifi_net_delete_acl_rule, unifi_net_get_acl_rule_ordering, unifi_net_reorder_acl_rulesunifi_net_list_dns_policies, unifi_net_get_dns_policy, unifi_net_create_dns_policy, unifi_net_update_dns_policy, unifi_net_delete_dns_policyunifi_net_list_traffic_lists, unifi_net_get_traffic_list, unifi_net_create_traffic_list, unifi_net_update_traffic_list, unifi_net_delete_traffic_listunifi_net_list_vouchers, unifi_net_get_voucher, unifi_net_create_vouchers, unifi_net_delete_voucher, unifi_net_delete_vouchersunifi_net_list_switch_stacks, unifi_net_get_switch_stack, unifi_net_list_mclag_domains, unifi_net_get_mclag_domain, unifi_net_list_lags, unifi_net_get_lagunifi_net_list_wans, unifi_net_list_site_to_site_vpn, unifi_net_list_vpn_servers, unifi_net_list_radius_profiles, unifi_net_list_device_tags, unifi_net_list_dpi_application_categories, unifi_net_list_dpi_applications, unifi_net_list_countriesNamed unifi_gen_ (the vendor operationId in lower case, e.g. unifi_gen_createfirewallpolicy, unifi_gen_getinfo). One tool per documented UniFi API endpoint (Site Manager API v1.0.0, Network API v11.0.97), except the Site Manag