Proxmox MCP

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

非公式です。Proxmox API 向けにコミュニティが開発した Claude Code スキルおよび MCP サーバーです。Proxmox Server Solutions GmbH との提携、同社による推奨、またはスポンサー提供を受けていません。

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

Servosity からの製品。 バックアップと DR は Servosity 独自の分野です。ファーストパーティの Servosity connector は、同じフリート全体を対象とするローカルミラー方式（フリートへの注意、古いバックアップ、復元、QBR レポート）を Servosity Backup と DR にも導入します。

読み取り専用の Proxmox VE および Backup Server CLI です。すべてのクライアントクラスターにわたって、良好で検証済みの新しい復元ポイントがあるゲストと、ないゲストを確認できます。すでにお使いの AI で動作します。ChatGPT（Plus／Pro+。このコネクターが再リリースされるまで一時停止中です。詳しくは mcp-install.md をご覧ください）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot に加え、リモート経由で Microsoft 365 Copilot／Copilot Studio と Google Gemini にも対応しています。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに開発されています。コードは不要です。

エージェントで利用する

セキュリティに関する注意（このコネクターが再リリースされるまで）。 HTTP モード（--transport http）は、localhost 上であっても実行しないでください。このビルドではトークンを確認しますが、修正版リリースに含まれるリクエストサイズと時間の制限がまだありません。また、MCP ツールはお客様の認証情報を使ってデータを読み取ることもできます。デフォルトの stdio トランスポートを使用してください。リモートエージェント用にトンネルを設定した場合は、停止してください。修正版は準備中です。

MSP オーナーが実際に使う 6 つのエージェント（セルフサービスで、現在利用可能）：

使用する AI エージェント	Proxmox スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions から proxmox-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再リリースされるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではそのモードはトークンを確認する一方、リクエストサイズや時間の制限がありません。mcp-install.md のセキュリティに関する注意をご覧ください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に proxmox-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。つまり、このコネクターの HTTP モードが必要ですが、コネクターが再リリースされるまで一時停止中です。このビルドではそのモードはトークンを確認する一方、リクエストサイズや時間の制限がありません。mcp-install.md のセキュリティに関する注意をご覧ください。

Microsoft と Google のスタックにも対応

大規模なインストールベースがありますが、率直にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再公開されるまで一時停止中です。Copilot Studio では HTTP モードが必要ですが、このビルドではそのモードはトークンを確認する一方、リクエストサイズや時間の制限がまだありません。mcp-install.md のセキュリティに関する注意事項をご覧ください。
Google Gemini	Gemini CLI はローカルで動作します。Claude Code と同じです。Gemini アプリはリモートで動作し、ChatGPT と同じく一時停止中の HTTP モードが必要です。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

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

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

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

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

これを Claude Code、Codex CLI、または Claude Cowork にコピーします：

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

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

方法 B - インストーラーを自分で実行する

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

proxmox-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

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

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

Hermes へのインストール

Hermes CLI から：

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

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

/skills install servosity/msp-skills/skills/proxmox --force

Hermes は MCP をネイティブにサポートしているため、proxmox-mcp サーバーを直接使用することもできます。インストール方法と環境変数は同じです。

OpenClaw へのインストール

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

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

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

認証

製品ごとに、権限を分離した API トークンを作成します。PBS には / の Audit ロールを割り当てます。PVE には / の PVEAuditor を割り当て、バックアップが PVE ストレージにある場合は Datastore.AllocateSpace と VM.Backup も追加します（必要な API トークンは？を参照）。その後、次を実行します。

export PROXMOX_HOST=pve1.example.lan
export PROXMOX_API_TOKEN='monitor@pve!agent=<secret>'      # USER@REALM!TOKENID=SECRET
export PROXMOX_TLS_FINGERPRINT='<PVE certificate SHA-256>'  # stock Proxmox certificates are self-signed
# Optional, for PBS verify, datastore and sync data:
export PROXMOX_PBS_HOST=pbs.example.lan
export PROXMOX_PBS_API_TOKEN='monitor@pbs!agent:<secret>'  # colon before the secret
export PROXMOX_PBS_TLS_FINGERPRINT='<PBS certificate SHA-256>'
proxmox-cli doctor

複数のクライアントを管理していますか？代わりにクライアントクラスターごとにエントリーを追加してください。clusters.toml には、各トークンを保持する環境変数の名前だけが保存されます。

proxmox-cli clusters add acme --client "Acme Dental" --pve-host pve1.acme.lan --pve-token-env ACME_PVE_TOKEN --pve-fingerprint '<sha256>' --pbs-host pbs.acme.lan --pbs-token-env ACME_PBS_TOKEN --pbs-fingerprint '<sha256>'
proxmox-cli clusters list

doctor は設定、パス、API への到達性、PVE トークンで認証できるかどうかを確認します。proxmox-cli posture --agent を実行すると、そのトークンでゲスト、ジョブ、バックアップも参照できることを確認できます。読み取れない項目はすべて fetch_failures に表示されます。

このスキルでできること

MSP からよく聞かれる質問	コマンド
良好で新しいバックアップがないクライアント VM はどれですか（PBS 上の場所を確認済みの場合）？	proxmox-cli posture --only problems --agent
有効なバックアップジョブに含まれていない VM またはディスクはどれですか？	proxmox-cli backup coverage --include-disks --agent
夜間にゲストごとに失敗した、または途中で停止した処理と、そのエラー行は何ですか？	proxmox-cli failures --since 24h --agent
PBS の検証失敗はどこまで広がっていますか？	proxmox-cli verify-health --agent
30 日以内に容量がいっぱいになるバックアップデータストアはどれですか？	proxmox-cli capacity --within 30d --agent
VM 104 にある、PBS で検証済みの復元ポイントはどれですか？	proxmox-cli restore-points "104" --verified-only --agent
クライアントごとに、今月スケジュールされたすべてのバックアップから復元ポイントが作成されましたか？	proxmox-cli rpo --days 30 --by-client --csv

コマンドの全リファレンスについては、guide.md を参照してください。AI エージェントの運用契約（--agent、--dry-run、変更を行う前に確認すべきタイミング）については、AGENTS.md を参照してください。

このスキルの特長

多くの Proxmox MCP サーバーは、VM の一覧表示や起動・停止、スナップショットの作成など、1 つのクラスターを操作するために作られており、危険な操作はフラグで制御します。多くの MSP は、そのようなトークンを AI エージェントに渡すことはありません。このスキルは Proxmox に読み取り（HTTP GET）しか送信しないため、誤って実行される書き込みコマンドはありません。また、Proxmox Backup Server にバックアップを保存する場合、両方のトークンを監査専用にできます。

重要なのは、情報を結び付けることです。「この VM はバックアップされていますか？」に答えるには、Proxmox の別々の場所にある 4 つの情報が必要です。有効なジョブにその VM が含まれているか、最新の実際のアーカイブがいずれかのバックアップストレージにあるか、Proxmox Backup Server がそのアーカイブを検証したか、そして最後の vzdump タスクログでそのゲストについて何が報告されているかです。posture は、すべてのクライアントクラスターにわたるすべてのゲストについて、これらの情報を結び付けます（backup coverage は最初の項目に答えます。つまり、有効なジョブに含まれていないゲストとディスクを示します）。failures と rpo は、ジョブが対象とするすべてのゲストを対象とし、いずれも実行のたびに最新情報を読み取ります。インベントリに関する質問には、sync が全文検索に対応したローカル SQLite ミラーを維持します。

解決する課題

多数のクライアントを抱える Proxmox 運用環境では、クライアントごとに 1 つのクラスターを運用し、Backup Server もクライアントごとに 1 台用意することがよくあります。バックアップタスクが成功と表示されても、すべてのゲストがバックアップされたとは限りません。1 つの vzdump ジョブで多くのゲストをバックアップしますが、失敗したゲストの名前はタスクログの中にしか記録されません。検証の失敗も、気づかないうちに広がります。Proxmox フォーラムのスレッドでは、中央の PBS が 100～200 台のサーバーからバックアップを取得しているプロバイダーが、原因が特定される前に、毎週の検証ジョブで失敗したスナップショットが増え続けるのを目にしました。また、Proxmox 向けの AI エージェント管理レイヤーが同じフォーラムで共有されたとき、管理者たちはエージェントをホストに近づけることに強く反発しました。

このスキルを使えば、そうした信頼を求めることなく、朝の確認事項に答えられます。

• posture --only problems - カバーされていない、復元ポイントがない、古くなっている、検証に失敗した、または最後の試行に失敗したすべてのゲスト
• backup coverage --include-disks - 有効なジョブに含まれていないすべてのゲストまたはディスクと、その理由
• failures --since 24h - 失敗したタスクと、気づかれないまま不完全に終わったタスクを、エラー行とともにゲストまたはデータストアごとに 1 行で表示
• verify-health - 検証の失敗がどこまで広がったか、および残っている最新の検証成功ポイント
• rpo --days 30 --by-client - スケジュールされた実行ごとに復元ポイントが生成されたことを示す、クライアントごとの証跡

詳しい説明については、pain-point.mdを参照してください。

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）は、HTTPS 経由でリモート MCP サーバーにのみ接続します。そのためには、Proxmox MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードはトークンを確認しますが、リクエストサイズや時間の制限はまだありません。そのため、コネクターが再公開されるまでは、実行したり、トンネルの背後に配置したりしないでください。その理由については、mcp-install.mdのセキュリティに関する注意を参照してください。それまでは、Claude Desktop、Claude Code、または Codex を使用してください。

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

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

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

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

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

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

AI が Proxmox ホスト上の何かを停止、変更、削除することはできますか？

いいえ。CLI と MCP サーバーには、Proxmox VE と Proxmox Backup Server に対する読み取り（GET）呼び出ししか含まれていません。何かを開始、停止、移行、復元、プルーニング、削除するコマンドはありません。書き込みが行われるのはローカルファイルのみです。対象はクラスターリスト、保存済みトークン、ローカルミラー（エンドポイント単位の読み取りコマンドも、取得した内容をコメントも含めて保存し、更新します）、およびエージェントの学習ストアです。レスポンスキャッシュはありません。posture、backup coverage、verify-health、failures、capacity、restore-points、rpo は常に Proxmox からリアルタイムで読み取ります。エンドポイント単位の読み取りコマンドは、Proxmox に接続できない場合に限りローカルミラーから応答し、その旨を stderr と meta.source: local に示します。また、--data-source live が指定されている場合は処理を拒否します。ストレージ設定内のサードパーティ製ストレージプラグインのパスワードなど、秘密情報を含む名前のフィールドは、キャッシュ、保存、表示の前にマスキングされます。また、各 --cluster はそれぞれ独自のローカルストアを使用します。知っておくべき副作用がひとつあります。ストレージのステータスを読み取ると、Proxmox は有効なストレージをマウントします。これは、Proxmox 自身のステータスデーモンがすでに 10 秒ごとに行っている処理です。

必要な API トークンは何ですか？

各製品に、権限分離された API トークンが必要です。Proxmox Backup Server では / に Audit ロール（読み取り専用）を設定します。Proxmox VE では / に PVEAuditor を設定します。注意点がひとつあります。Proxmox VE がバックアップファイルを一覧表示できるのは、Datastore.AllocateSpace と VM.Backup の権限も持つトークンに限られます。そのため、バックアップが dir、NFS、CIFS ストレージにある場合、またはここで Backup Server を設定していない場合は、これら 2 つの権限を持つカスタムロールを追加してください。監査専用トークンは「storage not read」と報告され、ゲストは「no backups」ではなく unproven として扱われます。バックアップが Proxmox Backup Server にあり、PROXMOX_PBS_HOST が設定されている場合（PVE ストレージの server フィールドと同じ表記、つまり同じ IP アドレスまたはホスト名）、CLI は PBS API からバックアップを読み取るため、PVE トークンは監査専用のままで構いません。これが設定されていない場合、PBS ストレージは Proxmox VE 経由でのみ読み取られます。Proxmox VE はそのストレージに保存された PBS 認証情報を使って一覧表示するため、別の認証情報が所有するバックアップグループを見落とす可能性があります。その場合、リストアポイントはカウントされますが、そこにリストアポイントがないゲストは never ではなく unproven と報告され、該当クラスター上のバックアップジョブで保護されているゲストは、どれも green になりません（新しいゲストは、検証に失敗したより新しいバックアップが隠れている可能性があるため、archives-incomplete になります）。標準インストールでは、local ストレージもバックアップを受け付けます。監査専用トークンの場合、コンテンツタイプから「VZDump backup file」を削除するか、2 つの権限を付与するまでは、取得失敗として一覧表示されます。それまでは、新しいゲストの判定は変わりませんが、読み取り可能なリストアポイントがないゲスト、または古いリストアポイントしかないゲストは、読み取れないストレージにバックアップがある可能性があるため、never や stale ではなく unproven と報告されます。rpo では未実行のバックアップが unproven としてカウントされ、posture --fail-on-red は終了コード 1 で終了します。ロールは / に（伝播するように）設定し、その下には NoAccess や、より範囲の狭い ACL を設定しないでください。Proxmox は、トークンから見えないゲストやストレージをすべての一覧から除外します。CLI は grant の欠落や範囲の縮小を検出しますが、特定のゲストに明示的に設定された NoAccess は、どの読み取り処理でも検出できません。PVE トークンの形式は USER@REALM!TOKENID=SECRET です。PBS トークンでは、シークレットの前にコロンを使います。

Proxmox では自己署名証明書が使われています。証明書チェックを無効にする必要がありますか？

いいえ。そのためのオプションもありません。ノードの Certificates に表示される証明書の SHA-256 フィンガープリントを、PROXMOX_TLS_FINGERPRINT と PROXMOX_PBS_TLS_FINGERPRINT、またはクライアントごとのクラスター設定である clusters.toml に設定してピン留めしてください。不正な形式のピンはエラーとなり、黙って無視されることはありません。また、PVE のピンが PBS ホストの正当性を保証することはありません。

多数のクライアントクラスターを管理するには？

proxmox-cli clusters add を使って、クライアントごとにエントリーを追加します。PVE ホスト、任意の PBS ホストと名前空間、証明書のフィンガープリント、トークンを格納する環境変数の名前を指定します（トークン自体は絶対に指定しないでください）。フリートコマンドは、設定済みのすべてのクラスターに対して実行されます。--cluster または --client を指定すると、対象を1つに絞れます。MCP クライアントの場合は、これらのトークン変数も MCP サーバーの env ブロックに追加してください。共有 Backup Server では、クライアントクラスターごとに専用の PBS 名前空間を割り当て、該当するエントリーの pbs_namespace として宣言します（クライアントごとに別のデータストアを用意するだけでは不十分です。宣言された名前空間だけが、読み取れないクラスターの範囲を限定します）。クラスター間で VMID は重複するため、2つのクラスターが同じ名前空間に書き込むと、CLI はどちらのクラスターの vm/100 スナップショットなのか判別できず、重複を報告し、それらの復元ポイントを集計しません。読み取れないクラスターは、宣言された pbs_namespace のどこにでも書き込むものとみなされます。宣言されていない場合は、その PBS のどこにでも（エントリーに PBS の指定がない場合は、どの PBS にも）書き込むものとみなされます。そのため、名前空間を宣言しておけば、あるクライアントで障害が発生しても、他のクライアントのバックアップが隠れることはありません。

費用はかかりますか？

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

安全性モデル

このスキルが Proxmox に送信するリクエストはすべて読み取り専用のため、各ティアはお使いのマシンで何が起こるか、また出力がどこに送られるかを示しています。

ティア	例	推奨されるエージェントポリシー
読み取り（Proxmox）	posture、backup coverage、failures、verify-health、capacity、restore-points、rpo、およびすべての vm、ct、nodes、storage、tasks、cluster、pbs-* コマンド	許可
ローカルへの書き込み	sync、workflow archive、export、profile save、teach	許可
認証情報のルーティング（ローカル）	clusters add（各クライアントのトークンの保存先と、信頼する証明書）、auth set-token、auth logout	人間が実行します。いずれも MCP ツールではありません
マシン外へのデータ送信	任意のコマンドでの --deliver webhook:<url> または --deliver file:<path>、feedback --send、パブリック HTTPS エンドポイントにブリッジされた MCP サーバー	必ず人間が介在
Proxmox への書き込み（起動、停止、復元、プルーン、削除）	なし — このスキルに該当するコマンドはありません	このスキルでは実行できません

最も強力な制御手段は、トークンに付与するスコープです。Proxmox Backup Server 上のバックアップを扱う場合、両方のトークンを監査専用にできるため、仮に書き込みが送信されたとしても、Proxmox 自体が拒否します。PVE ストレージ上のバックアップを一覧表示するには、2つのバックアップ権限が必要です。このトレードオフについては governance.md で説明しています。ロックダウンの方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。モック応答を使って Proxmox VE および Proxmox Backup Server の API サーフェスに対する検証を済ませており、毎週の Build Sessions では、稼働中の自社クラスターで使用する MSP とともに検証を進めています。compoundingteams.com/build-sessions から参加登録してください。

---

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

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