Domotz MCP

Domotz + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP を話すあらゆるエージェント向け

非公式です。Domotz API 向けにコミュニティが構築した Claude Code Skill と MCP サーバーです。Domotz Inc. との提携、同社による承認または後援はありません。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションですが、表示されているコマンドはすべて実際の CLI で使用できます。}

すべての Domotz エンドポイントに加え、サイトを横断する質問に答えるローカル SQLite フリートミラーを利用できます。すでにお使いの AI、ChatGPT（Plus/Pro+）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot に対応し、リモート経由では Microsoft 365 Copilot / Copilot Studio と Google Gemini にも対応します。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに構築されており、コードは不要です。

お使いのエージェントで利用できます

MSP オーナーが実際に使っている 6 つのエージェント（セルフサービスで、今すぐ利用できます）：

お使いの AI エージェント	Domotz スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で domotz-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、domotz-mcp を HTTPS 経由で公開して、Developer Mode コネクターとして登録します。
Codex CLI	下記のインストールプロンプトを貼り付けます。
Claude Code	下記のインストールプロンプトを貼り付けます。
Claude Cowork	下記のインストールプロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に domotz-mcp を追加してから、Agent モードを選択します。

ChatGPT の場合は、domotz-mcp --transport http を実行し、HTTPS の背後で公開します。ブリッジパッケージは不要です。mcp-install.md を参照してください。

Microsoft と Google の環境にも対応

導入ベースは大きいものの、正直にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、インストールしたばかりのローカルバイナリを使う方法ではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	セルフサービスでは利用できません。 domotz-mcp を HTTPS 経由でホストし、Copilot Studio（Tools > Add a tool > Model Context Protocol > Server URL）または宣言型エージェントに接続します。Copilot Studio ライセンスとテナント管理者の権限が必要です。mcp-install.md を参照してください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同じです。Gemini アプリはリモートで動作し、ChatGPT と同じ HTTPS 経由の方法を使います。mcp-install.md を参照してください。

スキルネイティブのエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。下記のインストール手順を参照してください。Cursor、Windsurf、Cline、Continue.dev、Zed でも MCP 経由で利用できます。ツールごとの詳しい接続方法は、docs/which-agent.md を参照してください。

複数のエージェントを使いますか？ 1 つのコマンドで、対応する 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。続けて、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 サーバーのみです。お使いのバンドルに CLI が含まれていない場合は、先に以下の Path A または Path B のインストーラーを実行するか、既存のバイナリを DOMOTZ_CLI_PATH に設定してください。詳細： #331。

Domotz MCP（.mcpb）をダウンロード してから、Claude Desktop > Settings > Extensions を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（リリースページですべての Domotz リリースを確認できます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリ一覧の取得は不要で、すぐに使えます。

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

Path A - AI エージェントにプロンプトを貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください。

このエージェントのワークスペースに Servosity/msp-skills から Domotz Skill と MCP サーバーをインストールしてください。このワークスペースで POSIX シェル（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 を実行して使い方を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使えます。

Path 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 クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法（GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot / Copilot Studio の手順を含む）について、mcp-install.md と docs/which-agent.md を参照してください。Claude Desktop の Settings > Extensions パネルが最も簡単な方法です。MCP 設定ブロック（JSON の編集を希望する方向け）は mcp-install.md に記載されています。

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 エージェントに次の内容を伝えてください（コピーして使用できます）。

https://github.com/servosity/msp-skills/tree/main/skills/domotz から domotz スキルをインストールしてください。このスキルには、必須の CLI（domotz-cli）を openclaw: frontmatter ブロック経由でインストールする方法が定義されています。

OpenClaw はまだ一般公開されていません。frontmatter の設定はあらかじめ用意されており、OpenClaw が公開されるとすぐに有効になります。

認証する

Domotz ポータルから取得した、CLI に必要な認証情報を設定します。

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
過去 1 日以内に、いずれかのネットワークに新しく出現したデバイスは何ですか？	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、--dry-run、変更を加える前に確認するタイミング）については、AGENTS.md をご覧ください。

このスキルの特長

ほとんどの Domotz 連携や MCP サーバーは、各質問をエージェント単位の API 呼び出しに変換します。デバイス 1 台なら問題ありません。しかし、「40 のクライアントサイトのうち、今オフラインになっているデバイスがあるのはどこか？」や「QBR 用に、すべての Collector をまとめた資産インベントリを出して」と尋ねるような規模では機能しません。

このスキルは Domotz のデータを全文検索対応のローカル SQLite ミラーに同期します。集計に関する質問は 1 回のローカルクエリで処理できるため、即座に結果が得られ、オフラインでも利用でき、AI には JSON の生データではなく回答が表示されます。fleet health、fleet inventory、fleet new のような複合コマンドは、すべての Collector、デバイス、サイトのデータを一度に集約します。これは、ステートレスな API ラッパーでは 1 回の呼び出しで実現できない処理です。

解消する課題

r/msp のネットワーク監視に関するスレッドでは、サイト単位のツールに共通する同じ課題がたびたび取り上げられています。可視性は Collector ごとに整理されますが、実際に尋ねたいのはフリート全体に関する質問です。「問題が起きているクライアントはどこか？」「一晩でネットワークに何が出現したか？」「QBR 用に資産一覧をまとめて出して。」ポータルでは、それぞれの質問に答えるために、すべてのサイトを手作業でクリックして確認するか、サイトごとにエクスポートしてスプレッドシートを統合する必要があります。データはすべてそろっていても、クライアント全体をまとめて一画面で確認できません。

このスキルは、その課題を解消します。

• fleet health - すべてのサイトのステータスを 1 つのボードにまとめ、「何か問題が起きていますか？」を一目で確認できます。
• fleet offline - 各エージェントのページを順に確認する代わりに、すべてのサイトのオフラインデバイスを優先順位付きで一覧表示します。
• fleet new --since 24h - すべてのクライアントを対象に、不正なデバイスがないか一度に調査できます。
• fleet inventory --csv - フリート全体の QBR／CMDB 用エクスポートを 1 行で実行できます。
• fleet unmonitored - 認証／SNMP のカバレッジ不足をフリート全体から検出できるため、監視の死角が放置されません。

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

はい。Plus、Pro、Team、Business、Enterprise、Education の各プランで利用できます（Free プランでは、まだ Developer Mode を利用できません）。ChatGPT は HTTPS 経由でリモート MCP サーバーに接続します。ローカルの stdio バイナリには接続しません。Domotz MCP サーバーはローカルで動作しますが、HTTP にネイティブ対応しています。domotz-mcp --transport http --addr :7777 で起動し、HTTPS トンネルまたは独自のリバースプロキシの背後に配置してください。ブリッジパッケージは不要です。詳しい手順は mcp-install.md をご覧ください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini でも使えますか？

はい。いずれも MCP に対応しています。各ツールのインストールコマンドは上記の一覧に、詳しい説明は docs/which-agent.md にあります。

コーディングの知識は必要ですか？

いいえ。推奨されるインストール方法は、Claude Code または Codex に一文を貼り付けることです。エージェントが SKILL.md を読み込んでインストールを実行します。代替手段として、OS ごとに 1 行のインストーラー（bash または PowerShell）も用意されています。どちらの方法でも、コードを書く必要はありません。Domotz の認証情報を一度入力するだけです。

Domotz のデータは安全ですか？

データはお使いのマシンに保持されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーはユーザーアカウント配下のディレクトリに保存されます。AI エージェントに表示されるのは CLI が返す内容のみで、通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。MSP Skills によってこのリポジトリに含められたり、どこかに送信されたりすることはありません。

API を使うには、特別な Domotz プランが必要ですか？

アドオンは必要ありません。既存のアカウントで Domotz Portal の Settings > Services > API Keys から API Key を生成します。一部のエンドポイント（会社エリア、チームの移動、一部の RBAC）は Enterprise プラン限定です。それ以外はすべて標準アカウントで利用でき、プランによってエンドポイントが制限されている場合、CLI は明確なエラーを返します。

Domotz ポータルの代わりになりますか？

いいえ。ポータルとモバイルアプリは、1 つのサイトで作業するために構築されており、デバイスをリアルタイムで操作する場所として引き続き利用できます。このスキルは、1 つのポータル画面ではできない、全 Collector を対象としたフリート全体の集計を追加します。ターミナルから利用でき、スクリプト化でき、エージェントにも対応しています。

Domotz API のレート制限に達しますか？

サイトをまたぐクエリはライブ API ではなく、ローカル SQLite ミラーから読み取るため、40 サイトにわたる fleet inventory は、API 呼び出し 40 回ではなく、ローカルクエリ 1 回で済みます。API にアクセスするのは sync、ライブコマンド、または --data-source live を明示的に指定した場合のみです。ライブ API を使用する際は、グローバルな --rate-limit フラグでリクエストレートを制限できます。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。費用がかかるのは、利用する AI エージェント（Claude、ChatGPT、Codex など）のみで、その料金は当社ではなく AI プロバイダーに支払います。

安全性モデル

Tier	例	推奨されるエージェントのポリシー
読み取り	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 をご覧ください。

ステータス

ベータ版です。Domotz API の仕様に照らして検証済みで、毎週開催している Build Sessions では、本番テナントで実際に運用している MSP とともに検証を進めています。compoundingteams.com/build-sessions から参加登録できます。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025 年 12 月；40 以上のエージェント）に準拠しています。MCP と互換性があり、Hermes を含む、MCP 対応のあらゆるエージェントで動作します。OpenClaw に対応済みです（frontmatter は設定済みで、OpenClaw のリリース待ちです）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press で構築されています。最終更新日：2026-06-06.