Domotz MCP

Domotz + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方项目。由社区构建的 Claude Code Skill 和 Domotz API MCP 服务。 与 Domotz Inc. 无关联，也未获得其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都存在于真实的 CLI 中。}

提供所有 Domotz 端点，以及可回答跨站点问题的本地 SQLite 设备群镜像。可与您现有的 AI 搭配使用 - ChatGPT（Plus/Pro+，在此连接器重新发布前暂停；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 也可通过远程方式与 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini 搭配使用。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本没有密码保护， 会监听所有网络接口，且早于浏览器重绑定防护机制， 因此您打开的网页可以访问它。MCP 工具还可以使用您的凭据进行更改。 请使用默认的 stdio 传输方式。如果您为远程 Agent 设置了隧道，请将其 关闭。修复版本即将推出。

MSP 所有者实际使用的六种 Agent（可自行安装，即刻可用）：

您的 AI Agent	如何安装 Domotz skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 domotz-mcp（无需编辑 JSON）。
ChatGPT（付费计划）	在此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，但此版本的该模式无需密码，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 domotz-mcp 添加到 mcp.json 的 servers 键下，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着需要使用此连接器的 HTTP 模式；该模式在连接器重新发布前暂停：此版本的该模式无需密码，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。

也适用于 Microsoft 和 Google 技术栈

用户基础庞大，但先说明一点：这属于远程／企业接入方式，并非你刚刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直至重新发布此连接器：Copilot Studio 需要使用 HTTP 模式，而在此版本中，该模式无需密码，会监听所有网络接口，并且可被你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行——与 Claude Code 相同。Gemini app 在远程运行，需要使用与 ChatGPT 相同的、目前已暂停的 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也有说明）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，也支持 MCP——请参阅下方的安装章节。通过 MCP 也支持 Cursor、Windsurf、Cline、Continue.dev 和 Zed。每款工具的完整接入说明：docs/which-agent.md。

要使用多个 Agent？ 运行一条命令，即可在所有 51+ 款受支持的 Agent 中安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行每项 Skill 的安装程序以安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快安装方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 domotz-cli。自 2026-09-18 起发布的版本会在安装包内附带此 CLI；较早的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套程序，请先运行下方的路径 A 或路径 B 安装程序（或者将 DOMOTZ_CLI_PATH 设为已有二进制文件的路径）。详情： #331。

下载 Domotz MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON 或 Shell。（在 releases page 查看所有 Domotz 版本。）

更喜欢使用 Claude Code 插件？添加一次市场，然后安装即可——立即生效，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install domotz@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork：

在此 Agent 工作区中，从 Servosity/msp-skills 安装 Domotz Skill 和 MCP 服务。如果此工作区使用 POSIX Shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/domotz/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/domotz/install.ps1 | iex。然后按照 README 完成身份验证，并运行 domotz-cli --help 以了解用法。

任何能够运行 Shell 的 Agent 都可以使用同一条提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/domotz/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/domotz/install.sh)

安装程序会将 domotz-cli（CLI）和 domotz-mcp（MCP 服务）安装到用户的 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 查找 Skill。

验证：

domotz-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/domotz/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/domotz/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择。Claude Code 插件用户：/plugin update domotz@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的连接方式——每个 Agent 都有单独的章节，其中包括 GitHub Copilot 的 servers 键，以及 Microsoft 365 Copilot / Copilot Studio 的远程连接方式。Claude Desktop 的“设置 > 扩展”面板是最简单的方式；对于喜欢编辑 JSON 的用户，mcp-install.md 中提供了 MCP 配置代码块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/domotz --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/domotz --force

Hermes 原生支持 MCP，因此也可以直接使用 domotz-mcp 服务——安装方式和环境变量都相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/domotz 安装 domotz 技能。该技能通过 openclaw: frontmatter 块定义了所需 CLI（domotz-cli）的安装方式。

OpenClaw 目前尚未全面开放；frontmatter 配置已预先提供，并将在 OpenClaw 发布时立即启用。

验证身份

设置 CLI 所需的凭据（从你的 Domotz 门户获取）：

DOMOTZ_API_KEY=<value> DOMOTZ_PUBLIC_API_KEY=<value> DOMOTZ_REGION=<value> domotz-cli doctor

运行任何会访问数据的操作前，doctor 会确认凭据有效。即使凭据被拒绝，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 常问的问题	命令
我所有站点中是否有任何设备出现严重问题？	domotz-cli fleet health --agent
目前哪些 Collector（站点）离线或状态异常？	domotz-cli fleet agents --agent
所有客户中有哪些设备离线？	domotz-cli fleet offline --agent
过去一天内，哪些网络出现了新设备？	domotz-cli fleet new --since 24h --agent
汇总所有站点的资产清单	domotz-cli fleet inventory --csv
整个设备群中有哪些 IP 冲突？	domotz-cli fleet ip-conflicts --agent
哪些设备无法被完整监控（认证 / SNMP 缺失）？	domotz-cli fleet unmonitored --agent
我们管理的各厂商设备分别有多少？	domotz-cli fleet breakdown --by vendor --agent

完整命令参考：guide.md。关于 AI Agent 操作规范（--agent、--dry-run，以及何时在修改前确认），请参阅 AGENTS.md。

与众不同之处

大多数 Domotz 集成和 MCP 服务都会将每个问题转发为实时的、限定于 Agent 的 API 调用。这适用于单台设备。但当你问“我的 40 个客户站点中，哪些站点目前有设备离线？”或“为季度业务回顾汇总所有 Collector 的资产清单”时，这种方式就难以应对规模化需求。

此技能会将 Domotz 数据同步到本地 SQLite 镜像，并提供全文搜索。汇总类问题只需执行一次本地查询：即时、离线，而且 AI 看到的是答案，而不是一页页原始 JSON。fleet health、fleet inventory 和 fleet new 等组合命令可一次汇总所有 Collector、设备和站点的数据——无状态 API 封装器无法通过一次调用完成这类工作。

此工具解决的痛点

r/msp 上有关网络监控的讨论不断提到按站点使用工具的同一个缺口：可见性是按 Collector 逐个组织的，但你真正提出的问题却面向整个设备群。“哪个客户端有设备离线？”“一夜之间网络上出现了什么？”“给我一份用于季度业务回顾（QBR）的资产清单。”在门户中，这些操作都意味着手动逐个点击每个站点，或者按站点导出后再合并电子表格——数据都在那里，只是无法在单一视图中汇总所有客户端。

此技能填补了这个缺口：

• fleet health——跨所有站点的状态面板，只需一眼就能知道“有没有什么出问题了”。
• fleet offline——列出所有站点上的离线设备并按优先级排序，而不必逐个翻阅每个 Agent。
• fleet new --since 24h——一次扫描所有客户端，查找未授权设备。
• fleet inventory --csv——一条命令导出整个设备群的 QBR/CMDB 清单。
• fleet unmonitored——在整个设备群范围内找出身份验证/SNMP 覆盖缺口，避免盲区悄无声息。

更完整的说明见 pain-point.md。

常见问题

这能和 ChatGPT 一起使用吗？

此版本暂不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 方案；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接到远程 MCP 服务，这意味着需要以 HTTP 模式运行 Domotz MCP 服务。此版本的 HTTP 模式不需要密码，会监听所有网络接口，并且可被你打开的网页访问，因此在连接器重新发布之前，请勿运行它或将其置于隧道之后；原因见 mcp-install.md 中的安全说明。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这能和 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 一起使用吗？

可以——它们都支持 MCP。跨工具安装命令见上方的对照表，详细说明见 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是每种操作系统对应的一行安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 Domotz 凭据。

我的 Domotz 数据安全吗？

你的数据保留在自己的设备上。CLI 和 MCP 服务都是本地二进制程序。SQLite 镜像存放在用户账户下的一个目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而非原始批量数据。凭据从环境变量或 Agent 配置中读取；MSP Skills 绝不会将其打包到此仓库中或传输到任何地方。

使用 API 需要特殊的 Domotz 方案吗？

不需要额外购买附加服务。你可以在现有账户的 Domotz 门户中，通过设置 > 服务 > API 密钥生成 API Key。少数端点（公司区域、团队迁移、部分 RBAC）仅限 Enterprise 方案使用；其余功能在标准账户上均可使用，若某个端点受方案限制，CLI 会返回明确的错误。

这会取代我的 Domotz 门户吗？

不会。门户和移动应用是为一次处理一个站点而设计的，仍然是实时交互设备的入口。此技能提供单个门户视图无法实现的全设备群汇总——涵盖每个 Collector，可在终端中使用、可编写脚本并可供 Agent 使用。

这会触及我的 Domotz API 速率限制吗？

跨站点查询读取的是本地 SQLite 镜像，而不是实时 API，因此跨 40 个站点运行 fleet inventory 只需执行一次本地查询，而不是发出 40 次 API 调用。只有在执行 sync、实时命令，或明确传入 --data-source live 时才会调用 API。实时调用时，你可以使用全局 --rate-limit 标志限制请求速率。

费用是多少？

免费。采用 Apache-2.0 许可证。你只需为所使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 服务提供商收取，而不是由我们收取。

安全模型

层级	示例	推荐的 Agent 策略
读取	fleet health, fleet offline, fleet inventory, agent device list, search, topology, export	允许
写入（常规）	agent device create-eye-snmp, agent device edit, custom-tag create, alert-profile binding bind-alert-profile-to-device, device-profile apply, import	使用 --dry-run 预览，然后执行经审核的写入操作
物理操作 / 设备控制	agent device power-action-on, agent device trigger-outlet-action, agent device backup-configuration, agent connection create-agent-vpnconnection	必须有人参与；绝不可无人值守
凭据 / 安全	agent device set-credentials, agent device set-snmpauthentication, agent device get-snmpauthentication（会返回 SNMP 密钥）, rbac create-user	仅限有人参与
破坏性操作	agent delete, agent device delete, inventory delete, rbac delete-user	仅限有人参与，并须明确确认

最有力的控制措施是授予 Domotz 凭据的权限范围——CLI 只能执行凭据允许的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

Beta 版。已针对 Domotz API 接口进行验证，目前正在每周 Build Sessions 中，与将其连接到自身生产租户并实际运行的 MSP 一起进行验证。请通过 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可证。使用 CLI Printing Press 构建。上次更新：2026-06-06。