Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

ProxmoxMCP-Plus

von RekklesNAVersion 0.7.2i★ 661iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.RekklesNA/proxmox-mcp-plus

So installierst du es

What it does

Proxmox VE MCP server for VMs, LXCs, snapshots, backups, storage, and cluster operations.

  • Connects Läuft auf deinem Computer
  • Account or key Needs PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE · 2 settings to fill in (PROXMOX_HOST, PROXMOX_USER)
  • Category Sonstiges

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit43/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert55/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: 5 (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte ProxmoxMCP-Plus. Folge https://mcp.popnx.com/i/rekklesna-proxmox-mcp-plus.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 18. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von ProxmoxMCP-Plus (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (PROXMOX_HOST, PROXMOX_USER) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server ProxmoxMCP-Plus für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "proxmox-plus": { "command": "uvx", "args": [ "proxmox-mcp-plus" ], "env": { "PROXMOX_HOST": "your-value", "PROXMOX_USER": "your-value", "PROXMOX_TOKEN_NAME": "your-value", "PROXMOX_TOKEN_VALUE": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_HOST, PROXMOX_USER "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von ProxmoxMCP-Plus wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Bei ProxmoxMCP-Plus registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von ProxmoxMCP-Plus öffnen ↗

  3. 2 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • PROXMOX_HOST Hostname oder IP-Adresse des Proxmox-VE-API-Endpunkts.
      Englisches Original anzeigenHostname or IP address of the Proxmox VE API endpoint.
    • PROXMOX_USER Proxmox-Benutzername mit Realm, zum Beispiel root@pam.
      Englisches Original anzeigenProxmox username with realm, for example root@pam.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  5. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "proxmox-plus": {
          "command": "uvx",
          "args": [
            "proxmox-mcp-plus"
          ],
          "env": {
            "PROXMOX_HOST": "your-value",
            "PROXMOX_USER": "your-value",
            "PROXMOX_TOKEN_NAME": "your-value",
            "PROXMOX_TOKEN_VALUE": "your-value"
          }
        }
      }
    }

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. Claude beenden und neu öffnen

  7. Ausprobieren

    Nutze ProxmoxMCP-Plus und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es ProxmoxMCP-Plus nutzt, oder ein Werkzeug von ProxmoxMCP-Plus in der Antwort zeigt, bist du verbunden

8 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • PROXMOX_MCP_CONFIG Optionaler Pfad zu einer JSON-Konfigurationsdatei. Falls gesetzt, wird die Dateikonfiguration vor der Umgebungsvariablen-Ausweichlösung verwendet.
    Englisches Original anzeigenOptional path to a JSON config file. If set, file config is used before environment variable fallback.
  • PROXMOX_PORT Proxmox-API-Port. Standardwert ist 8006.
    Englisches Original anzeigenProxmox API port. Defaults to 8006.
  • PROXMOX_VERIFY_SSL Auf true setzen, um TLS-Zertifikate zu prüfen, oder auf false für Testumgebungen mit selbstsignierten Zertifikaten.
    Englisches Original anzeigenSet to true to verify TLS certificates, or false for self-signed lab environments.
  • PROXMOX_DEV_MODE Auf true setzen, wenn verify_ssl=false in einer Testumgebung mit selbstsignierten Zertifikaten verwendet wird.
    Englisches Original anzeigenSet to true when using verify_ssl=false in a self-signed lab environment.
  • PROXMOX_SERVICE Proxmox-Diensttyp. Standardwert ist PVE.
    Englisches Original anzeigenProxmox service type. Defaults to PVE.
  • MCP_TOOL_ALLOWLIST Optionale, durch Kommas getrennte exakte Werkzeugnamen, die freigegeben werden. Nicht zusammen mit MCP_TOOL_DENYLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
  • MCP_TOOL_DENYLIST Optionale, durch Kommas getrennte exakte Werkzeugnamen, die ausgeblendet werden. Nicht zusammen mit MCP_TOOL_ALLOWLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
  • LOG_LEVEL Ausführlichkeitsstufe des Server-Logs. Standardwert ist INFO.
    Englisches Original anzeigenServer log verbosity. Defaults to INFO.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann ProxmoxMCP-Plus noch nicht verbinden

ProxmoxMCP-Plus läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die ProxmoxMCP-Plus verbinden kann

  • Du brauchst einen Schlüssel von ProxmoxMCP-Plus (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (PROXMOX_HOST, PROXMOX_USER) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Du brauchst einen Schlüssel von ProxmoxMCP-Plus (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (PROXMOX_HOST, PROXMOX_USER) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von ProxmoxMCP-Plus (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (PROXMOX_HOST, PROXMOX_USER) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von ProxmoxMCP-Plus (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (PROXMOX_HOST, PROXMOX_USER) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

B · Andere in Sonstiges, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von ProxmoxMCP-Plus (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (PROXMOX_HOST, PROXMOX_USER) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server ProxmoxMCP-Plus für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user proxmox-plus --env PROXMOX_HOST=your-value --env PROXMOX_USER=your-value --env PROXMOX_TOKEN_NAME=your-value --env PROXMOX_TOKEN_VALUE=your-value -- uvx proxmox-mcp-plus 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_HOST, PROXMOX_USER "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von ProxmoxMCP-Plus wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Bei ProxmoxMCP-Plus registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von ProxmoxMCP-Plus öffnen ↗

  3. 2 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • PROXMOX_HOST Hostname oder IP-Adresse des Proxmox-VE-API-Endpunkts.
      Englisches Original anzeigenHostname or IP address of the Proxmox VE API endpoint.
    • PROXMOX_USER Proxmox-Benutzername mit Realm, zum Beispiel root@pam.
      Englisches Original anzeigenProxmox username with realm, for example root@pam.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  5. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user proxmox-plus --env PROXMOX_HOST=your-value --env PROXMOX_USER=your-value --env PROXMOX_TOKEN_NAME=your-value --env PROXMOX_TOKEN_VALUE=your-value -- uvx proxmox-mcp-plus

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. /mcp in Claude Code eingeben

    ProxmoxMCP-Plus sollte in der Liste als verbunden erscheinen

  7. Ausprobieren

    Nutze ProxmoxMCP-Plus und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es ProxmoxMCP-Plus nutzt, oder ein Werkzeug von ProxmoxMCP-Plus in der Antwort zeigt, bist du verbunden

8 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • PROXMOX_MCP_CONFIG Optionaler Pfad zu einer JSON-Konfigurationsdatei. Falls gesetzt, wird die Dateikonfiguration vor der Umgebungsvariablen-Ausweichlösung verwendet.
    Englisches Original anzeigenOptional path to a JSON config file. If set, file config is used before environment variable fallback.
  • PROXMOX_PORT Proxmox-API-Port. Standardwert ist 8006.
    Englisches Original anzeigenProxmox API port. Defaults to 8006.
  • PROXMOX_VERIFY_SSL Auf true setzen, um TLS-Zertifikate zu prüfen, oder auf false für Testumgebungen mit selbstsignierten Zertifikaten.
    Englisches Original anzeigenSet to true to verify TLS certificates, or false for self-signed lab environments.
  • PROXMOX_DEV_MODE Auf true setzen, wenn verify_ssl=false in einer Testumgebung mit selbstsignierten Zertifikaten verwendet wird.
    Englisches Original anzeigenSet to true when using verify_ssl=false in a self-signed lab environment.
  • PROXMOX_SERVICE Proxmox-Diensttyp. Standardwert ist PVE.
    Englisches Original anzeigenProxmox service type. Defaults to PVE.
  • MCP_TOOL_ALLOWLIST Optionale, durch Kommas getrennte exakte Werkzeugnamen, die freigegeben werden. Nicht zusammen mit MCP_TOOL_DENYLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
  • MCP_TOOL_DENYLIST Optionale, durch Kommas getrennte exakte Werkzeugnamen, die ausgeblendet werden. Nicht zusammen mit MCP_TOOL_ALLOWLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
  • LOG_LEVEL Ausführlichkeitsstufe des Server-Logs. Standardwert ist INFO.
    Englisches Original anzeigenServer log verbosity. Defaults to INFO.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von ProxmoxMCP-Plus (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (PROXMOX_HOST, PROXMOX_USER) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server ProxmoxMCP-Plus für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "proxmox-plus": { "command": "uvx", "args": [ "proxmox-mcp-plus" ], "env": { "PROXMOX_HOST": "your-value", "PROXMOX_USER": "your-value", "PROXMOX_TOKEN_NAME": "your-value", "PROXMOX_TOKEN_VALUE": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_HOST, PROXMOX_USER "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von ProxmoxMCP-Plus wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Bei ProxmoxMCP-Plus registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von ProxmoxMCP-Plus öffnen ↗

  3. 2 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • PROXMOX_HOST Hostname oder IP-Adresse des Proxmox-VE-API-Endpunkts.
      Englisches Original anzeigenHostname or IP address of the Proxmox VE API endpoint.
    • PROXMOX_USER Proxmox-Benutzername mit Realm, zum Beispiel root@pam.
      Englisches Original anzeigenProxmox username with realm, for example root@pam.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von ProxmoxMCP-Plus ist PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_HOST, PROXMOX_USER leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in Cursor im Agent-Modus öffnen

  7. Ausprobieren

    Nutze ProxmoxMCP-Plus und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es ProxmoxMCP-Plus nutzt, oder ein Werkzeug von ProxmoxMCP-Plus in der Antwort zeigt, bist du verbunden

8 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • PROXMOX_MCP_CONFIG Optionaler Pfad zu einer JSON-Konfigurationsdatei. Falls gesetzt, wird die Dateikonfiguration vor der Umgebungsvariablen-Ausweichlösung verwendet.
    Englisches Original anzeigenOptional path to a JSON config file. If set, file config is used before environment variable fallback.
  • PROXMOX_PORT Proxmox-API-Port. Standardwert ist 8006.
    Englisches Original anzeigenProxmox API port. Defaults to 8006.
  • PROXMOX_VERIFY_SSL Auf true setzen, um TLS-Zertifikate zu prüfen, oder auf false für Testumgebungen mit selbstsignierten Zertifikaten.
    Englisches Original anzeigenSet to true to verify TLS certificates, or false for self-signed lab environments.
  • PROXMOX_DEV_MODE Auf true setzen, wenn verify_ssl=false in einer Testumgebung mit selbstsignierten Zertifikaten verwendet wird.
    Englisches Original anzeigenSet to true when using verify_ssl=false in a self-signed lab environment.
  • PROXMOX_SERVICE Proxmox-Diensttyp. Standardwert ist PVE.
    Englisches Original anzeigenProxmox service type. Defaults to PVE.
  • MCP_TOOL_ALLOWLIST Optionale, durch Kommas getrennte exakte Werkzeugnamen, die freigegeben werden. Nicht zusammen mit MCP_TOOL_DENYLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
  • MCP_TOOL_DENYLIST Optionale, durch Kommas getrennte exakte Werkzeugnamen, die ausgeblendet werden. Nicht zusammen mit MCP_TOOL_ALLOWLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
  • LOG_LEVEL Ausführlichkeitsstufe des Server-Logs. Standardwert ist INFO.
    Englisches Original anzeigenServer log verbosity. Defaults to INFO.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von ProxmoxMCP-Plus (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (PROXMOX_HOST, PROXMOX_USER) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server ProxmoxMCP-Plus für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "proxmox-plus": { "type": "stdio", "command": "uvx", "args": [ "proxmox-mcp-plus" ], "env": { "PROXMOX_HOST": "your-value", "PROXMOX_USER": "your-value", "PROXMOX_TOKEN_NAME": "your-value", "PROXMOX_TOKEN_VALUE": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_HOST, PROXMOX_USER "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von ProxmoxMCP-Plus wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. uv installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    uv --version
    • Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst

    Download-Seite von uv öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version

    Einmal installieren, gilt für alles, was uv braucht

  2. Bei ProxmoxMCP-Plus registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von ProxmoxMCP-Plus öffnen ↗

  3. 2 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • PROXMOX_HOST Hostname oder IP-Adresse des Proxmox-VE-API-Endpunkts.
      Englisches Original anzeigenHostname or IP address of the Proxmox VE API endpoint.
    • PROXMOX_USER Proxmox-Benutzername mit Realm, zum Beispiel root@pam.
      Englisches Original anzeigenProxmox username with realm, for example root@pam.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von ProxmoxMCP-Plus ist PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_HOST, PROXMOX_USER leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in VS Code im Agent-Modus öffnen

  7. Ausprobieren

    Nutze ProxmoxMCP-Plus und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es ProxmoxMCP-Plus nutzt, oder ein Werkzeug von ProxmoxMCP-Plus in der Antwort zeigt, bist du verbunden

8 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • PROXMOX_MCP_CONFIG Optionaler Pfad zu einer JSON-Konfigurationsdatei. Falls gesetzt, wird die Dateikonfiguration vor der Umgebungsvariablen-Ausweichlösung verwendet.
    Englisches Original anzeigenOptional path to a JSON config file. If set, file config is used before environment variable fallback.
  • PROXMOX_PORT Proxmox-API-Port. Standardwert ist 8006.
    Englisches Original anzeigenProxmox API port. Defaults to 8006.
  • PROXMOX_VERIFY_SSL Auf true setzen, um TLS-Zertifikate zu prüfen, oder auf false für Testumgebungen mit selbstsignierten Zertifikaten.
    Englisches Original anzeigenSet to true to verify TLS certificates, or false for self-signed lab environments.
  • PROXMOX_DEV_MODE Auf true setzen, wenn verify_ssl=false in einer Testumgebung mit selbstsignierten Zertifikaten verwendet wird.
    Englisches Original anzeigenSet to true when using verify_ssl=false in a self-signed lab environment.
  • PROXMOX_SERVICE Proxmox-Diensttyp. Standardwert ist PVE.
    Englisches Original anzeigenProxmox service type. Defaults to PVE.
  • MCP_TOOL_ALLOWLIST Optionale, durch Kommas getrennte exakte Werkzeugnamen, die freigegeben werden. Nicht zusammen mit MCP_TOOL_DENYLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
  • MCP_TOOL_DENYLIST Optionale, durch Kommas getrennte exakte Werkzeugnamen, die ausgeblendet werden. Nicht zusammen mit MCP_TOOL_ALLOWLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
  • LOG_LEVEL Ausführlichkeitsstufe des Server-Logs. Standardwert ist INFO.
    Englisches Original anzeigenServer log verbosity. Defaults to INFO.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die ProxmoxMCP-Plus nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user proxmox-plus --env PROXMOX_HOST=your-value --env PROXMOX_USER=your-value --env PROXMOX_TOKEN_NAME=your-value --env PROXMOX_TOKEN_VALUE=your-value -- uvx proxmox-mcp-plus

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "proxmox-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_HOST": "your-value",
        "PROXMOX_USER": "your-value",
        "PROXMOX_TOKEN_NAME": "your-value",
        "PROXMOX_TOKEN_VALUE": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "proxmox-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_HOST": "your-value",
        "PROXMOX_USER": "your-value",
        "PROXMOX_TOKEN_NAME": "your-value",
        "PROXMOX_TOKEN_VALUE": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "proxmox-plus": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_HOST": "your-value",
        "PROXMOX_USER": "your-value",
        "PROXMOX_TOKEN_NAME": "your-value",
        "PROXMOX_TOKEN_VALUE": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • PROXMOX_MCP_CONFIG env
    Optionaler Pfad zu einer JSON-Konfigurationsdatei. Falls gesetzt, wird die Dateikonfiguration vor der Umgebungsvariablen-Ausweichlösung verwendet.
    Englisches Original anzeigenOptional path to a JSON config file. If set, file config is used before environment variable fallback.
  • PROXMOX_HOST erforderlich env
    Hostname oder IP-Adresse des Proxmox-VE-API-Endpunkts.
    Englisches Original anzeigenHostname or IP address of the Proxmox VE API endpoint.
  • PROXMOX_USER erforderlich env
    Proxmox-Benutzername mit Realm, zum Beispiel root@pam.
    Englisches Original anzeigenProxmox username with realm, for example root@pam.
  • PROXMOX_TOKEN_NAME geheim erforderlich env
    Name des Proxmox-API-Tokens.
    Englisches Original anzeigenName of the Proxmox API token.
  • PROXMOX_TOKEN_VALUE geheim erforderlich env
    Geheimer Wert des Proxmox-API-Tokens.
    Englisches Original anzeigenSecret value of the Proxmox API token.
  • PROXMOX_PORT env
    Proxmox-API-Port. Standardwert ist 8006.
    Englisches Original anzeigenProxmox API port. Defaults to 8006.
  • PROXMOX_VERIFY_SSL env
    Auf true setzen, um TLS-Zertifikate zu prüfen, oder auf false für Testumgebungen mit selbstsignierten Zertifikaten.
    Englisches Original anzeigenSet to true to verify TLS certificates, or false for self-signed lab environments.
  • PROXMOX_DEV_MODE env
    Auf true setzen, wenn verify_ssl=false in einer Testumgebung mit selbstsignierten Zertifikaten verwendet wird.
    Englisches Original anzeigenSet to true when using verify_ssl=false in a self-signed lab environment.
  • PROXMOX_SERVICE env
    Proxmox-Diensttyp. Standardwert ist PVE.
    Englisches Original anzeigenProxmox service type. Defaults to PVE.
  • MCP_TOOL_ALLOWLIST env
    Optionale, durch Kommas getrennte exakte Werkzeugnamen, die freigegeben werden. Nicht zusammen mit MCP_TOOL_DENYLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
  • MCP_TOOL_DENYLIST env
    Optionale, durch Kommas getrennte exakte Werkzeugnamen, die ausgeblendet werden. Nicht zusammen mit MCP_TOOL_ALLOWLIST setzen.
    Englisches Original anzeigenOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
  • LOG_LEVEL env
    Ausführlichkeitsstufe des Server-Logs. Standardwert ist INFO.
    Englisches Original anzeigenServer log verbosity. Defaults to INFO.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
2.548/Wo.
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.7.2
Kategoriei
Sonstiges
In der Registry veröffentlichti
18. Nov. 2026
Code zuletzt geänderti
16. Nov. 2026
Entwickler
RekklesNA
Pakete
pypi: proxmox-mcp-plus
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 18. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto RekklesNA bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vorgestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/rekklesna-proxmox-mcp-plus.svg)](https://mcp.popnx.com/en/servers/rekklesna-proxmox-mcp-plus)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 99 % der anderen 20575 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 99 % der anderen 20575 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 20575 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist ProxmoxMCP-Plus sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vorgestern geändert, und die neueste Version (0.7.2) kam heute in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

von koala73Weit verbreitet★ 90.840Aktualisiert vorgestern

Läuft in der Cloud✓ vom Dienst · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

von openstatusHQWeit verbreitet★ 9274Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

von JanDeDobbeleerWeit verbreitet★ 23.768 Sterne des ganzen ReposAktualisiert vor 29 Tagen

Läuft in der Cloud✓ vom Dienst · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

von Klavis-AIWachsend★ 5826Aktualisiert vor 14 Monaten

Läuft in der CloudRepo archiviert✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

von jitsucomWeit verbreitet★ 5135Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · jitsu.com
Im Vergleich mit ähnlichen
Dieser
ProxmoxMCP-Plus
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen3/34/44/44/41/44/4
LizenzMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

ProxmoxMCP-Plus

Operate Proxmox VE from MCP clients, AI agents, and OpenAPI tooling through one security-conscious control plane for VMs, LXCs, snapshots, backups, ISOs, container commands, and persistent long-running jobs.

Quick Start | Client Install | Demo | Tools | Safety | Scenarios | Docs | Wiki

MCP and OpenAPI are alternative entry points into the same workflows and may run in separate processes. Solid arrows show requests and execution; dashed arrows show persisted job and audit state. Approval gates, SSH execution and MCP HTTP OAuth depend on configuration. Select the diagram to view it at full size.

Why ProxmoxMCP-Plus

ProxmoxMCP-Plus sits between AI clients and Proxmox VE so operators do not have to stitch together raw API calls, one-off shell scripts, and custom job polling for every workflow.

It exposes the same operational surface in two ways:

  • MCP for Claude Desktop, Cursor, VS Code, Open WebUI, Codex, and other MCP-capable agents
  • OpenAPI for HTTP automation, dashboards, internal tools, and no-code workflows

What you get:

  • VM and LXC lifecycle actions
  • snapshot create, rollback, and delete
  • backup and restore workflows
  • ISO download and cleanup
  • node, storage, and cluster inspection
  • SSH-backed container command execution with guardrails
  • opt-in guarded Proxmox node SSH commands
  • persistent job tracking for async Proxmox tasks

What Makes It Different

PriorityHow the project handles it
Dual access pathsNative MCP for agent workflows and OpenAPI for standard HTTP automation
Proxmox-oriented workflowsDay-2 VM, LXC, snapshot, backup, ISO, storage, and cluster operations
Long-running operationsStable job_ids, Proxmox UPID tracking, polling, retry, cancel, and audit history
Safer executionProxmox API tokens, OpenAPI bearer auth, command policy, approval tokens, TLS validation, and MCP HTTP Host/Origin controls
Real validationUnit, integration, Docker/OpenAPI, and live Proxmox e2e entry points are documented in the repo

Quick Start

1. Prepare Proxmox Credentials

Create a Proxmox API token with only the permissions your workflows need. Then create the local config file:

cp proxmox-config/config.example.json proxmox-config/config.json

Then edit proxmox-config/config.json with your environment. At minimum, it needs:

  • proxmox.host
  • proxmox.port
  • auth.user
  • auth.token_name
  • auth.token_value

Add an ssh section as well if you want container command execution. Add a jobs section if you want job state persisted somewhere other than the default local SQLite file.

For real live verification, use a separate proxmox-config/config.live.json created from proxmox-config/config.live.example.json. Do not point live e2e at a placeholder or local-only config.json unless you intentionally run a local API tunnel there.

Optional job persistence config:

{

"jobs": { "sqlite_path": "proxmox-jobs.sqlite3" } }

Optional tool exposure filtering can reduce the schemas sent to MCP clients. It is disabled by default, so existing configurations continue to expose every available tool. Configure exactly one mode under mcp:

{

"mcp": { "tool_allowlist": ["get_nodes", "get_vms", "get_containers", "get_storage"] } }

Alternatively, use tool_denylist, or the comma-separated environment variables MCP_TOOL_ALLOWLIST and MCP_TOOL_DENYLIST. Do not configure both modes. Environment selection replaces the file-level filtering mode. An empty allowlist exposes no tools; an empty denylist hides none. Exact lowercase tool names are required, and unknown names fail startup so a typo cannot silently widen access. Restart or reconnect the MCP server after changing the filter.

2. Choose One Runtime Path
PathBest forStart commandVerify
MCP stdio from PyPIClaude Desktop, Cursor, VS Code, Codex, local agentsuvx proxmox-mcp-plusclient lists get_nodes, get_vms, and job tools
Native MCP HTTP from Dockerremote MCP clients that support Streamable HTTPdocker compose --profile mcp-http up -d proxmox-mcp-httpconnect to http://localhost:8000/mcp
OpenAPI bridge from DockerHTTP clients, dashboards, scripts, no-code toolsdocker compose --profile openapi up -d proxmox-mcp-apicurl -f http://localhost:8811/livez

Docker examples publish host ports on 127.0.0.1 by default; Compose modes are opt-in. Set only the selected mode's key: MCP_API_KEY for native HTTP or PROXMOX_API_KEY for OpenAPI. See Compose deployment and upgrade notes for reverse proxies, tunnels, explicit LAN bindings and container recreation.

MCP stdio with PyPI
uvx proxmox-mcp-plus

Or install it first:

pip install proxmox-mcp-plus

proxmox-mcp-plus

Use this path when the MCP client launches a local stdio server.

Code Mode (opt-in)

Code Mode is disabled by default to preserve the legacy full tool catalog. Enable it with mcp.code_mode: true in the config file or MCP_CODE_MODE=true. When enabled, MCP exposes three tools instead: proxmox_code_search, proxmox_code_get_schema, and proxmox_code_execute. Code execution runs in an isolated sandbox and reaches domain tools through the existing validation, policy, and approval path. Discovery uses the filtered runtime catalog, so it also works in installed wheels. For example:

await call_tool("get_nodes", {"target": "default"})

The final expression is returned as data.result; tool results use MCP JSON content blocks (and structured content where supplied). Use proxmox_code_get_schema for arguments, including target and approval tokens. Scripts have no filesystem or network access except registered tool calls. Limits: 64,000 source characters, 100 MB sandbox memory, 25 tool calls, 16 KB final JSON, and two concurrent executions. Execution has a 30-second budget; cancelling or failing a script does not roll back tool side effects. Do not automatically retry a failed mutation script.

Optional worker reuse: set mcp.code_mode_pool_reuse: true or MCP_CODE_MODE_POOL_REUSE=true. The default remains one fresh worker per execution. Reuse keeps up to two workers for the server lifetime, recycles each after 100 checkouts, and starts a new sandbox session per request. Globals, approvals, output collectors and call limits are not shared between requests. HTTP clients share the server-owned pool; disconnecting a client does not close it. Run python scripts/benchmark_code_mode.py to measure local startup overhead; this is a microbenchmark, not an estimate of Proxmox operation latency.

Native MCP HTTP with Docker

Use this path when a remote MCP client supports Streamable HTTP:

export MCP_API_KEY="$(openssl rand -hex 32)"

docker run --rm -p 127.0.0.1:8000:8000 \ -e PROXMOX_MCP_MODE=mcp-http \ -e MCP_HOST=0.0.0.0 \ -e MCP_PORT=8000 \ -e MCP_TRANSPORT=STREAMABLE_HTTP \ -e MCP_API_KEY="$MCP_API_KEY" \ -v "$(pwd)/proxmox-config/config.json:/app/proxmox-config/config.json:ro" \ ghcr.io/rekklesna/proxmoxmcp-plus:latest

Point MCP clients at:

http://127.0.0.1:8000/mcp

For remote clients, use the configured proxy/tunnel URL or explicitly widen the host binding as described in Docker deployment.

Send Authorization: Bearer with every native MCP HTTP request. The key is independent of Proxmox credentials. Native Streamable HTTP and SSE require a key by default. For an endpoint protected by an external access-control layer such as Tailscale ACLs, explicitly set MCP_ALLOW_UNAUTHENTICATED_HTTP=true or mcp.allow_unauthenticated_http: true in JSON configuration. This allows keyless startup and logs a warning; it does not configure or verify the external access controls. A configured MCP_API_KEY is always enforced, even with opt-out. This setting does not change OpenAPI authentication or DNS rebinding protection.

OAuth browser gate for MCP clients

Native MCP HTTP can optionally expose an OAuth authorization-code flow with PKCE while keeping MCP_API_KEY as the only human credential an operator has to manage. OAuth protocol handling is delegated to the MCP Python SDK (mcp>=1.30.0,<2), while ProxmoxMCP-Plus provides the API-key consent policy and persistent OAuth state.

OAuth state is stored in PostgreSQL. This allows multiple MCP server instances or hosts, when deployed explicitly, to share registered clients, authorization codes, access tokens, refresh tokens, refresh-token replay protection, and login-rate-limit state without relying on a local filesystem.

The client starts at the SDK /authorize endpoint. After the SDK validates the client, redirect URI, scope, PKCE request, and resource, the browser is redirected to /oauth/consent on the same MCP origin. The user reviews the client name, redirect origin, and requested scopes, then enters MCP_API_KEY. The API key is never placed in a URL and is never returned to the OAuth client.

Required OAuth settings:

export MCP_API_KEY="$(openssl rand -hex 32)"

Replace with the database user's password.

export MCP_OAUTH_DATABASE_URL='postgresql://proxmox_oauth: @postgres.example:5432/proxmox_oauth'

Example server:

docker run --rm -p 127.0.0.1:8000:8000 \

-e PROXMOX_MCP_MODE=mcp-http \ -e MCP_HOST=0.0.0.0 \ -e MCP_PORT=8000 \ -e MCP_TRANSPORT=STREAMABLE_HTTP \ -e MCP_API_KEY="$MCP_API_KEY" \ -e MCP_OAUTH_ENABLED=true \ -e MCP_OAUTH_ISSUER=https://mcp.example.com \ -e MCP_OAUTH_DATABASE_URL="$MCP_OAUTH_DATABASE_URL" \ -e MCP_ALLOWED_HOSTS=mcp.example.com:*,localhost:* \ -e MCP_ALLOWED_ORIGINS=https://mcp.example.com \ -v "$(pwd)/proxmox-config/config.json:/app/proxmox-config/config.json:ro" \ ghcr.io/rekklesna/proxmoxmcp-plus:latest

Then connect the OAuth-capable client to:

https://mcp.example.com/mcp

OAuth mode exposes these endpoints on the same public origin:

  • /.well-known/oauth-protected-resource/mcp - RFC 9728 protected-resource metadata
  • /.well-known/oauth-authorization-server - SDK authorization-server metadata
  • /register - SDK dynamic client registration (DCR)
  • /authorize - SDK authorization endpoint
  • /token - SDK authorization-code/refresh-token exchange
  • `

Nur der Anfang wird gezeigt; den Rest findest du im Repo