プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

UniFi Site Manager and Network (unofficial)

作者:mguttmannバージョン 0.4.0i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.mguttmann/the-real-unifi-mcp

インストール方法

What it does

Unofficial MCP server for the UniFi Site Manager and Network cloud APIs, with a write-confirm guard.

  • Connects パソコンで動く
  • Account or key Needs UNIFI_API_KEY
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中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 やスマホでは使えません

  1. 提供元のインストールファイルをダウンロード

    作者の .mcpb ファイルをダウンロード

    .mcpb ファイルは提供元から直接のもので、当サイトは変更していません

  2. ファイルをダブルクリックし、パソコン版 Claude アプリで Install を押す

  3. 試してみる

    UniFi Site Manager and Network (unofficial) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が UniFi Site Manager and Network (unofficial) を使っていると言うか、回答に UniFi Site Manager and Network (unofficial) のツール名が出れば接続成功です

追加の設定 10 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • UNIFI_CONFIRM_WRITES 書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。
    英語の原文を見るWrite confirmation: destructive tools return a preview and run only when called again with confirm "YES". Only false, 0, no or off turn it off.
    · 初期値 true
  • 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.com
  • UNIFI_TIMEOUT_MS リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。
    英語の原文を見るPer-request timeout in milliseconds, covering response headers and body.
    · 初期値 30000
  • UNIFI_LOG_LEVEL stderr のログレベル:debug、info、warn、error のいずれか。
    英語の原文を見るLog level on stderr: debug, info, warn or error.
    · 初期値 info
  • UNIFI_CONSOLE_ID UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。
    英語の原文を見るPins the UniFi console instead of discovering it (needed when the account has several consoles).
  • UNIFI_NETWORK_SITE_ID Network のサイトを自動検出せず固定します。
    英語の原文を見るPins the Network site instead of discovering it.
  • UNIFI_SITE_MANAGER_SITE_ID Site Manager のサイトを自動検出せず固定します。
    英語の原文を見るPins the Site Manager site instead of discovering it.
  • UNIFI_READ_ONLY 読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。
    英語の原文を見るRead-only mode: every write tool returns an error and sends no request; reads still work. Off by default.
    · 初期値 false
  • UNIFI_REDACT_SECRETS すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。
    英語の原文を見るMasks passwords, WiFi passphrases, pre-shared keys and other secret fields in every tool result with (redacted); write tools refuse a body that contains that placeholder. Off by default.
    · 初期値 false
  • UNIFI_MAX_RESULT_BYTES このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。
    英語の原文を見るCuts tool results longer than this many bytes and marks them as truncated. Unset or empty: 100000. 0, off or none: no cap.
    · 初期値 100000

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 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) につなげるアプリを使う

  • UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを 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 がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. UniFi Site Manager and Network (unofficial) に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    UniFi Site Manager and Network (unofficial) のサイトを開く ↗

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user the-real-unifi --env UNIFI_API_KEY=your-value -- npx -y the-real-unifi-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude Code で /mcp と入力

    UniFi Site Manager and Network (unofficial) が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    UniFi Site Manager and Network (unofficial) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が UniFi Site Manager and Network (unofficial) を使っていると言うか、回答に UniFi Site Manager and Network (unofficial) のツール名が出れば接続成功です

追加の設定 10 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • UNIFI_CONFIRM_WRITES 書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。
    英語の原文を見るWrite confirmation: destructive tools return a preview and run only when called again with confirm "YES". Only false, 0, no or off turn it off.
    · 初期値 true
  • 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.com
  • UNIFI_TIMEOUT_MS リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。
    英語の原文を見るPer-request timeout in milliseconds, covering response headers and body.
    · 初期値 30000
  • UNIFI_LOG_LEVEL stderr のログレベル:debug、info、warn、error のいずれか。
    英語の原文を見るLog level on stderr: debug, info, warn or error.
    · 初期値 info
  • UNIFI_CONSOLE_ID UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。
    英語の原文を見るPins the UniFi console instead of discovering it (needed when the account has several consoles).
  • UNIFI_NETWORK_SITE_ID Network のサイトを自動検出せず固定します。
    英語の原文を見るPins the Network site instead of discovering it.
  • UNIFI_SITE_MANAGER_SITE_ID Site Manager のサイトを自動検出せず固定します。
    英語の原文を見るPins the Site Manager site instead of discovering it.
  • UNIFI_READ_ONLY 読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。
    英語の原文を見るRead-only mode: every write tool returns an error and sends no request; reads still work. Off by default.
    · 初期値 false
  • UNIFI_REDACT_SECRETS すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。
    英語の原文を見るMasks passwords, WiFi passphrases, pre-shared keys and other secret fields in every tool result with (redacted); write tools refuse a body that contains that placeholder. Off by default.
    · 初期値 false
  • UNIFI_MAX_RESULT_BYTES このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。
    英語の原文を見るCuts tool results longer than this many bytes and marks them as truncated. Unset or empty: 100000. 0, off or none: no cap.
    · 初期値 100000

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを 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 がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. UniFi Site Manager and Network (unofficial) に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    UniFi Site Manager and Network (unofficial) のサイトを開く ↗

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    UniFi Site Manager and Network (unofficial) の設定で UNIFI_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    UniFi Site Manager and Network (unofficial) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が UniFi Site Manager and Network (unofficial) を使っていると言うか、回答に UniFi Site Manager and Network (unofficial) のツール名が出れば接続成功です

追加の設定 10 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • UNIFI_CONFIRM_WRITES 書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。
    英語の原文を見るWrite confirmation: destructive tools return a preview and run only when called again with confirm "YES". Only false, 0, no or off turn it off.
    · 初期値 true
  • 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.com
  • UNIFI_TIMEOUT_MS リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。
    英語の原文を見るPer-request timeout in milliseconds, covering response headers and body.
    · 初期値 30000
  • UNIFI_LOG_LEVEL stderr のログレベル:debug、info、warn、error のいずれか。
    英語の原文を見るLog level on stderr: debug, info, warn or error.
    · 初期値 info
  • UNIFI_CONSOLE_ID UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。
    英語の原文を見るPins the UniFi console instead of discovering it (needed when the account has several consoles).
  • UNIFI_NETWORK_SITE_ID Network のサイトを自動検出せず固定します。
    英語の原文を見るPins the Network site instead of discovering it.
  • UNIFI_SITE_MANAGER_SITE_ID Site Manager のサイトを自動検出せず固定します。
    英語の原文を見るPins the Site Manager site instead of discovering it.
  • UNIFI_READ_ONLY 読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。
    英語の原文を見るRead-only mode: every write tool returns an error and sends no request; reads still work. Off by default.
    · 初期値 false
  • UNIFI_REDACT_SECRETS すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。
    英語の原文を見るMasks passwords, WiFi passphrases, pre-shared keys and other secret fields in every tool result with (redacted); write tools refuse a body that contains that placeholder. Off by default.
    · 初期値 false
  • UNIFI_MAX_RESULT_BYTES このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。
    英語の原文を見るCuts tool results longer than this many bytes and marks them as truncated. Unset or empty: 100000. 0, off or none: no cap.
    · 初期値 100000

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

UniFi Site Manager and Network (unofficial) のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを 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 がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. UniFi Site Manager and Network (unofficial) に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    UniFi Site Manager and Network (unofficial) のサイトを開く ↗

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    UniFi Site Manager and Network (unofficial) の設定で UNIFI_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    UniFi Site Manager and Network (unofficial) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が UniFi Site Manager and Network (unofficial) を使っていると言うか、回答に UniFi Site Manager and Network (unofficial) のツール名が出れば接続成功です

追加の設定 10 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • UNIFI_CONFIRM_WRITES 書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。
    英語の原文を見るWrite confirmation: destructive tools return a preview and run only when called again with confirm "YES". Only false, 0, no or off turn it off.
    · 初期値 true
  • 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.com
  • UNIFI_TIMEOUT_MS リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。
    英語の原文を見るPer-request timeout in milliseconds, covering response headers and body.
    · 初期値 30000
  • UNIFI_LOG_LEVEL stderr のログレベル:debug、info、warn、error のいずれか。
    英語の原文を見るLog level on stderr: debug, info, warn or error.
    · 初期値 info
  • UNIFI_CONSOLE_ID UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。
    英語の原文を見るPins the UniFi console instead of discovering it (needed when the account has several consoles).
  • UNIFI_NETWORK_SITE_ID Network のサイトを自動検出せず固定します。
    英語の原文を見るPins the Network site instead of discovering it.
  • UNIFI_SITE_MANAGER_SITE_ID Site Manager のサイトを自動検出せず固定します。
    英語の原文を見るPins the Site Manager site instead of discovering it.
  • UNIFI_READ_ONLY 読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。
    英語の原文を見るRead-only mode: every write tool returns an error and sends no request; reads still work. Off by default.
    · 初期値 false
  • UNIFI_REDACT_SECRETS すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。
    英語の原文を見るMasks passwords, WiFi passphrases, pre-shared keys and other secret fields in every tool result with (redacted); write tools refuse a body that contains that placeholder. Off by default.
    · 初期値 false
  • UNIFI_MAX_RESULT_BYTES このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。
    英語の原文を見るCuts tool results longer than this many bytes and marks them as truncated. Unset or empty: 100000. 0, off or none: no cap.
    · 初期値 100000

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?UniFi Site Manager and Network (unofficial) を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user the-real-unifi --env UNIFI_API_KEY=your-value -- npx -y the-real-unifi-mcp

Claude 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 秘密 必須 env
    UniFi Site Manager API key with Network scope (unifi.ui.com, Settings > API). It controls your whole network: treat it like an admin password.
  • UNIFI_CONFIRM_WRITES env
    書き込み確認:破壊的なツールはプレビューを返し、confirm が "YES" の状態で再度呼び出された場合にのみ実行されます。false、0、no、off の場合のみ無効になります。
    英語の原文を見るWrite confirmation: destructive tools return a preview and run only when called again with confirm "YES". Only false, 0, no or off turn it off.
  • UNIFI_API_BASE env
    API base URL; this host receives the API key. https origin only (http only for loopback test stubs). Keep the default.
  • UNIFI_TIMEOUT_MS env
    リクエストごとのタイムアウト時間(ミリ秒)。レスポンスヘッダーと本文の両方を対象とします。
    英語の原文を見るPer-request timeout in milliseconds, covering response headers and body.
  • UNIFI_LOG_LEVEL env
    stderr のログレベル:debug、info、warn、error のいずれか。
    英語の原文を見るLog level on stderr: debug, info, warn or error.
  • UNIFI_CONSOLE_ID env
    UniFi コンソールを自動検出せず、指定したものに固定します(アカウントに複数のコンソールがある場合に必要)。
    英語の原文を見るPins the UniFi console instead of discovering it (needed when the account has several consoles).
  • UNIFI_NETWORK_SITE_ID env
    Network のサイトを自動検出せず固定します。
    英語の原文を見るPins the Network site instead of discovering it.
  • UNIFI_SITE_MANAGER_SITE_ID env
    Site Manager のサイトを自動検出せず固定します。
    英語の原文を見るPins the Site Manager site instead of discovering it.
  • UNIFI_READ_ONLY env
    読み取り専用モード:すべての書き込みツールはエラーを返し、リクエストを送信しません。読み取りは引き続き機能します。デフォルトはオフです。
    英語の原文を見るRead-only mode: every write tool returns an error and sends no request; reads still work. Off by default.
  • UNIFI_REDACT_SECRETS env
    すべてのツール結果でパスワード、WiFi パスフレーズ、事前共有鍵などの秘密フィールドを (redacted) に置き換えます。書き込みツールは、そのプレースホルダーを含む本文を拒否します。既定ではオフです。
    英語の原文を見るMasks passwords, WiFi passphrases, pre-shared keys and other secret fields in every tool result with (redacted); write tools refuse a body that contains that placeholder. Off by default.
  • UNIFI_MAX_RESULT_BYTES env
    このバイト数を超えるツール結果を切り詰め、切り詰められたことを示します。未設定または空:100000。0、off、none:上限なし。
    英語の原文を見るCuts tool results longer than this many bytes and marks them as truncated. Unset or empty: 100000. 0, off or none: no cap.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
134/週
接続方法
パソコンで動く
最新バージョンi
0.4.0
カテゴリi
その他
レジストリ公開日i
2026年10月28日
コードの最終更新i
2026年11月16日
作者
mguttmann
パッケージ
npm: the-real-unifi-mcp
mcpb: …/the-real-unifi-mcp-0.4.0.mcpb
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント mguttmann で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:3 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に the-real-unifi-mcp@0.4.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mguttmann-the-real-unifi-mcp.svg)](https://mcp.popnx.com/en/servers/mguttmann-the-real-unifi-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20693件のうち0%よりスターが多い
  • このカテゴリのほかの20693件のうち66%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20693件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

UniFi Site Manager and Network (unofficial)は安全ですか?

当てはまる基本チェック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

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582514 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
UniFi Site Manager and Network (unofficial)
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/41/44/4
ライセンスMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

the-real-unifi-mcp

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.

Features

  • 169 tools across both UniFi APIs, read *and* write.
  • Three-layer tool design: 86 hand-wrappers (10 Site Manager + 76 Network) + 82 auto-generated tools, one per documented endpoint + 1 raw-request escape hatch (86 + 82 + 1 = 169). The tool contract is pinned by tests/contract/tools-contract.json.
  • MCP resources and MCP prompts for ready-made workflows.
  • Lazy ID discovery (consoleId / Network siteId / Site Manager siteId), cached for the process lifetime.
  • Write guard on by default: 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).
  • Secret redaction in the server's own stderr log lines (known key patterns and the configured API key by value).

Requirements

  • Node.js 22.12 or a later 22.x, 24.x, or 26 and newer (engines: ^22.12.0 || ^24.0.0 || >=26.0.0, the range of the test toolchain vitest). Node 23 and 25 are not supported.
  • UniFi Site Manager API key with Network scope. Create one at unifi.ui.com under Settings → API.
  • UniFi Console with firmware ≥ 5.0.3 (required by the Network API).

Installation

From npm (recommended)

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.

From source
git clone https://github.com/mguttmann/the-real-unifi-mcp.git

cd the-real-unifi-mcp npm ci cp .env.example .env

Edit .env: set UNIFI_API_KEY (Site Manager key with Network scope)

npm run build # prebuild runs lint, typecheck and unit tests first npm start # node dist/index.js; reads .env from the current directory

As MCPB bundle
npm ci

npm run build:mcpb

Writes release/the-real-unifi-mcp- .mcpb (install it in Claude Desktop) and its SBOM.

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.

Configuration

VariableDefaultDescription
UNIFI_API_KEY(required)Site Manager API key with Network scope
UNIFI_API_BASEhttps://api.ui.comAPI 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_WRITEStrueIf 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_MS30000Per-request timeout (ms), covering the response headers and the body
UNIFI_LOG_LEVELinfodebug \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_ONLYfalseIf 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_SECRETSfalseIf 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_BYTES100000A 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.

Claude Desktop config

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.

Claude Code config

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.

Tool reference

Site Manager hand-wrappers (10)

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 console
  • unifi_sm_list_sites: account-level sites (optional pageSize, nextToken); the statistics object of each site is omitted unless includeStatistics: true
  • unifi_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 window
  • unifi_sm_list_sdwan_configs: SD-WAN configurations
  • unifi_sm_get_sdwan_config: single SD-WAN configuration
  • unifi_sm_get_sdwan_config_status: status of an SD-WAN configuration
  • unifi_sm_identity: resolved consoleId, networkSiteId, siteManagerSiteId
Network hand-wrappers (76)

Per-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.

  • Info / Sites (2): unifi_net_get_info, unifi_net_list_sites
  • Devices (9): unifi_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_device
  • Clients (5): unifi_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)
  • Networks (6): unifi_net_list_networks, unifi_net_get_network, unifi_net_get_network_references, unifi_net_create_network, unifi_net_update_network, unifi_net_delete_network
  • WiFi broadcasts (5): unifi_net_list_wifi, unifi_net_get_wifi, unifi_net_create_wifi, unifi_net_update_wifi, unifi_net_delete_wifi
  • Firewall (13): unifi_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_policies
  • ACL rules (7): unifi_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_rules
  • DNS policies (5): unifi_net_list_dns_policies, unifi_net_get_dns_policy, unifi_net_create_dns_policy, unifi_net_update_dns_policy, unifi_net_delete_dns_policy
  • Traffic matching lists (5): unifi_net_list_traffic_lists, unifi_net_get_traffic_list, unifi_net_create_traffic_list, unifi_net_update_traffic_list, unifi_net_delete_traffic_list
  • Hotspot vouchers (5): unifi_net_list_vouchers, unifi_net_get_voucher, unifi_net_create_vouchers, unifi_net_delete_voucher, unifi_net_delete_vouchers
  • Switching (6): unifi_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_lag
  • Supporting (8): unifi_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_countries
Auto-generated tools (82)

Named 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

冒頭だけを表示しています。続きはリポジトリで読めます