用途：为受支持的 MCP 客户端配置 UniFi Network MCP 服务器，设置控制器主机、凭据与权限。按其运行时选择目标：Claude Code 用 claude，Codex 用 codex，OpenClaw 用 openclaw；不确定时需询问。若来自独立 npx skills 安装，需自行按客户端原生 MCP 注册路径注册服务器。
主要流程：
- 前置检查。macOS/Linux 运行 bash <plugin>/scripts/check-prereqs.sh --target <claude|codex|openclaw> "unifi-network"；Windows 运行 powershell -ExecutionPolicy Bypass -File <plugin>/scripts/check-prereqs.ps1 -Target <target> -PluginName "unifi-network"。退出码非零即停止。脚本依赖 uv/uvx 与所选客户端 CLI。
- 控制器主机：询问 IP 或主机名。
- 凭据：选择仅 API key、本地用户名密码或两者。禁止在聊天、工具调用或命令参数中传入明文密码或密钥；只能指定间接提供方，例如 UNIFI_NETWORK_PASSWORD_FILE、UNIFI_NETWORK_PASSWORD_COMMAND、UNIFI_NETWORK_API_KEY_FILE、UNIFI_NETWORK_API_KEY_COMMAND。Claude Code 可用插件选项对话框的掩码字段。配置优先级：非空 UNIFI_<PRODUCT>* 覆盖共享 UNIFI*；多个非空写法会拒绝启动。
- 可选设置：端口 443、站点 default、SSL 校验 false、惰性工具加载；可自定义。
- 权限：只读、常用写权限、除删除外的写权限或自定义。设置 UNIFI_NETWORK_TOOL_PERMISSION_MODE=confirm 先预览变更；只读时三项 CREATE/UPDATE/DELETE 均 false。Codex/OpenClaw 支持按类别覆盖，但需先清理已有的类别级策略。
- 写入：macOS/Linux 用 bash <plugin>/scripts/set-env.sh --target <target> ...；Windows 用 set-env.ps1 -Target <target>。原始值或删除用 --input-json/-InputJson。
升级：旧版本 Codex 写入 config.toml、OpenClaw 写入 openclaw.json 的条目会保留旧服务器，需执行 --refresh/-Refresh；旧版 Claude Code 项目设置需 --migrate/-Migrate，可能需 --replace。迁移后运行 /reload-plugins 或新会话。限制：独立技能安装不注册 MCP 服务器；Claude Code 不支持按类别策略覆盖；keychain 中的密钥无法通过配置清除。