Hudu MCP

Hudu + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するすべてのエージェント向け

非公式です。Hudu API 向けにコミュニティが開発した Claude Code Skill および MCP サーバーです。Hudu Technologies, Inc. と提携、承認、または後援関係にはありません。

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

すべての Hudu コマンドレットに加え、オフラインの SQLite ミラー、エンティティ間の監査、PowerShell モジュールや読み取り専用 MCP にないエージェントネイティブな出力を備えています。すでに使用している AI で利用できます。ChatGPT（Plus/Pro 以上。ホスト型 HTTPS エンドポイント経由。mcp-install.md を参照）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilotに加え、リモート接続経由でMicrosoft 365 Copilot / Copilot StudioとGoogle Geminiにも対応しています。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに開発されており、コードは不要です。

エージェントで利用できます

MSP オーナーが実際に使う 6 つのエージェントに対応しています（セルフサービスで、すぐに利用可能です）。

お使いの AI エージェント	Hudu スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で hudu-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、hudu-mcp をベアラートークン付きで HTTPS 経由でホストして、Developer Mode コネクターとして登録します。mcp-install.md を参照してください。
Codex CLI	以下のインストールプロンプトを貼り付けます。
Claude Code	以下のインストールプロンプトを貼り付けます。
Claude Cowork	以下のインストールプロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に hudu-mcp を追加して、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。そのため、このコネクターの HTTP モードを使用します。HUDU_MCP_HTTP_TOKEN が設定されるまで起動せず、すべてのリクエストでベアラーヘッダーにこのトークンを含める必要があります。また、ループバック以外のアドレスを使う場合は --tls-cert と --tls-key も必要です。mcp-install.md を参照してください。

Microsoft と Google の環境にも対応

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

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	hudu-mcp をベアラートークン付きで HTTPS 経由でホストし（ChatGPT と同じ HTTP モード）、Copilot Studio で Model Context Protocol ツールとして追加します。Copilot Studio のライセンスとテナント管理者が必要です。mcp-install.md を参照してください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同様です。Gemini アプリはリモートで動作するため、ChatGPT と同じホスト型 HTTPS エンドポイントが必要です。mcp-install.md を参照してください。

スキルネイティブなエージェントにも対応：Hermes と OpenClaw は、このスキルの SKILL.md を直接読み取り、MCP にも対応しています。以下のインストール方法を参照してください。MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed でも利用できます。ツールごとの詳しい接続方法は 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 で起動します。すべてのツールは、付属の hudu-cli をシェルから呼び出します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドルに同梱されています。それ以前のバンドルには MCP サーバーのみが含まれているため、付属の CLI がない場合は、まず以下のパス A またはパス B のインストーラーを実行するか、既存のバイナリを HUDU_CLI_PATH に設定してください。詳細： #331。

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

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

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

パス A — AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

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

このエージェントのワークスペースに、Servosity/msp-skills から Hudu Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、Bash）を使用している場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/hudu/install.sh) を実行してください。Windows PowerShell を使用している場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/hudu/install.ps1 | iex を実行してください。その後、README に従って認証し、hudu-cli --help を実行して使い方を確認してください。

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

パス B — インストーラーを自分で実行する

Windows（PowerShell）：

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

macOS / Linux：

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

インストーラーは、hudu-cli（CLI）と hudu-mcp（MCP サーバー）の両方をユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を通じて Skill を検出します。

確認：

hudu-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新のリリースを取得します。アップグレードするには、インストーラーを再実行してください。

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの先頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update hudu@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、または別の MCP クライアントに追加する

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

Hermes にインストールする

Hermes CLI から：

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

Hermes のチャットセッション内から：

/skills install servosity/msp-skills/skills/hudu --force

Hermes はネイティブに MCP に対応しているため、hudu-mcp サーバーも直接使用できます。インストール手順と環境変数は同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）。

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

OpenClaw はまだ一般公開されていません。frontmatter の設定は事前に組み込まれており、OpenClaw が公開されるとすぐに有効になります。

認証する

CLI に必要な認証情報を Hudu ポータルから設定します。キーは Admin -> API Keys で作成し、HUDU_BASE_URL にインスタンスの /api/v1 URL を指定してください。

HUDU_BASE_URL=https://<your-subdomain>.huducloud.com/api/v1 HUDU_API_KEY=<value> hudu-cli doctor

doctor を実行すると、データにアクセスする操作を行う前に認証情報が有効か確認できます。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

まず hudu-cli sync を一度実行して、インスタンスをローカルにミラーリングします。その後、次のように質問できます。

MSP でよく聞かれる質問	コマンド
ドキュメントの網羅性が最も低いクライアントはどこですか？	hudu-cli audit completeness --agent
すべてのクライアントで、今後 30 日以内に期限切れになるものは何ですか？	hudu-cli audit expirations --within 30d --agent
ローテーション期限を過ぎている保管庫のパスワードはどれですか？	hudu-cli audit stale-passwords --older-than 180d --agent
古くなっていて、おそらく情報が更新されていないナレッジベースの記事はどれですか？	hudu-cli audit stale-articles --older-than 365d --agent
現在のレイアウトスキーマから逸脱しているアセットはどれですか？	hudu-cli audit layout-drift --agent
すべての会社を対象に、最も問題のあるものから並べた衛生状態のスコアカードを表示してください。	hudu-cli audit summary --agent
同期済みのすべてのドキュメントから、キーワードに一致するものを探してください。	hudu-cli search "vpn gateway" --agent
PSA/RMM のレコードのうち、稼働中の Hudu アセットに対応していないものはどれですか？	hudu-cli reconcile --agent
標準テンプレートを使って、新しいクライアントのドキュメントのひな形を作成してください。	hudu-cli onboard --company 42 --template msp-standard

コマンドの完全なリファレンスは guide.md をご覧ください。AI エージェントの運用上の取り決め（--agent、--dry-run、変更を加える前に確認するタイミング）については、AGENTS.md をご覧ください。

このスキルの特徴

Hudu 連携や MCP サーバーの多くは、質問のたびにライブ API 呼び出しへ中継します。単一のレコードを確認する場合には問題ありません。しかし、QBR が続く直前に「クライアント 50 社のうち、パスワードが古く、アセットのドキュメントが不完全で、今月証明書の有効期限が切れるのはどこか」と尋ねるような規模になると、対応できなくなります。

このスキルは、Hudu を全文検索機能付きの ローカル SQLite ミラーに同期します。集計に関する質問は、ローカル SQL の結合 1 回で処理できるため、即座にオフラインで結果が得られ、AI には生データではなく回答が渡されます。audit summary や audit completeness --cross-tenant のような複合コマンドは、アセットをレイアウト、会社、パスワード保管庫と結合して、すべてのテナントを問題の大きい順にランク付けします。ステートレスな API ラッパーでは実現できない処理です。

解決する課題

「ドキュメントはいつも最新の状態ではない」というのは、r/msp で何度も繰り返される不満のひとつです。必須フィールドが半分空欄のままアセットが作成され、パスワードが何年もローテーションされず、すべてのテナントの更新日を一度に監視する人がいないため証明書の有効期限が切れます。Hudu にはこれらすべての情報がありますが、「どこで問題が起きているか」を調べるには会社ごとにクリックする必要があり、Hudu にはパスワードの有効期限を追跡する標準機能もありません。

このスキルを使えば、こうした繰り返し尋ねられる質問を、それぞれ 1 つのコマンドで解決できます。

• hudu-cli audit completeness --agent - 必須ドキュメントが実際にどの程度記入されているかに基づいて、クライアントをランク付けします。
• hudu-cli audit stale-passwords --older-than 180d --agent - 誰もローテーションしていない保管庫の認証情報を、会社ごとにまとめて表示します（ローカルで計算され、保管庫のパスワードや OTP シークレットが表示、保存、キャッシュされることはありません）。
• hudu-cli audit expirations --within 30d --agent - すべてのテナントを対象に、SSL、ドメイン、保証、パスワードのうち、まもなく期限切れとなるものを種類別のリストで表示します。
• hudu-cli audit summary --agent - 最初に修正すべきクライアントがわかるよう、問題の大きい順に並べた衛生状態のスコアカードを表示します。

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

よくある質問

ChatGPT で使えますか？

はい、Plus、Pro、Team、Business、Enterprise、Education プランで利用できます（Free ではまだ Developer Mode を利用できません）。ChatGPT が接続できるのは HTTPS 経由の リモート MCP サーバーのみなので、hudu-mcp を HTTP モードでホストする必要があります。HUDU_MCP_HTTP_TOKEN が設定されるまで起動せず、すべてのリクエストでこのトークンをベアラーヘッダーとして送信する必要があります。また、ループバック以外のアドレスを使用する場合は、--tls-cert と --tls-key も必要です。コネクターが動作するのは、その認証設定でベアラートークンを送信できる場合に限られるため、まず設定をご確認ください。詳しい手順は mcp-install.md をご覧ください。

Codex、Cursor、Windsurf、Cline、Copilot、Geminiで動作しますか？

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

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

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

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

データはお使いのマシンに保存されます。CLIとMCPサーバーはローカルのバイナリです。SQLiteミラーは、ユーザーアカウント配下のディレクトリに保存されます。AIエージェントが参照できるのはCLIが返す情報のみで、通常はクエリ結果であり、生の一括データではありません。VaultのパスワードとOTPシークレットは表示、保存、キャッシュされません。CLIが保持するのは各Vaultエントリのメタデータ（名前、ユーザー名、URL、フォルダー、日付）のみです。シークレットを取得するにはHuduポータルをご利用ください。パスワードタイプのアセットフィールドの値も同様に非表示になり（[withheld: password field]と表示されます）、Vaultまたはアセットのリクエストでエラーが発生した場合も、HTTPステータスのみが表示されます。Hudu APIキーはHUDU_API_KEY（環境変数またはエージェントの設定）から読み込まれます。または、auth set-tokenで保存した場合は、CLIのデータディレクトリにあるcredentials.toml（所有者のみがアクセス可能な権限）から読み込まれます。このリポジトリに含まれることも、MSP Skillsによって外部に送信されることもありません。

会社スコープのHudu APIキーは使えますか？

おおむね使えます。監査と検索は同期済みのデータを対象に実行されるため、どのキーでも機能します。制限が1つあります。Huduのグローバルなアセット一覧エンドポイントには、会社スコープではなくグローバルキーが必要です。スコープ付きキーを使用する場合は、代わりにhudu-cli assets list-by-company <company_id>を実行してください。また、onboard --applyによる書き込みにもグローバルキーが必要です。

Huduポータルは不要になりますか？

いいえ。編集や日々のドキュメント作成に使用しているWebアプリを補完するものです。このスキルはテナントをまたぐ衛生管理に関する質問に回答し、その結果をAIエージェントに渡します。作成や閲覧には、引き続きHuduのUIを使用します。

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

達しないように設計されています。hudu-cli syncは再開可能な増分同期を使って、インスタンスのデータを一度ローカルのSQLiteミラーに取り込みます。その後の監査、検索、解決はすべてミラーを使ってオフラインで実行されるため、同じ質問を繰り返してもAPI呼び出しは発生しません。

費用はかかりますか？

無料です。Apache-2.0ライセンスで提供されています。費用が発生するのは、使用するAIエージェント（Claude、ChatGPT、Codexなど）のみで、請求元は当社ではなく各AIプロバイダーです。

安全性モデル

ティア	例	推奨されるエージェントのポリシー
読み取り	audit completeness、audit stale-passwords、audit expirations、audit summary、search、resolve、reconcile、companies list、assets list-by-company、sync、doctor	許可
書き込み（通常）	assets create、assets update、articles create、articles update、companies create、companies update、asset-layouts create、onboard --apply	--dry-runでプレビューした後、レビュー済みの書き込みを実行
破壊的操作／認証情報	assets delete、articles delete、companies delete、asset-passwords delete、asset-passwords get、asset-passwords list、auth set-token、auth logout	必ず人が介在

最も強力な制御手段は、Huduの認証情報に付与するスコープです。CLIが実行できるのは、その認証情報で許可されている操作のみです。制限方法を含む詳細は、governance.mdをご覧ください。

ステータス

実環境で検証済みです。@Xenith-B（MSP）が自身の本番テナントで確認しました（証拠）。ほかのMSPも、毎週開催しているBuild Sessionsで実際に利用しています。compoundingteams.com/build-sessionsで参加登録できます。

---

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

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