Proxmox·GethosTheWalrus

Proxmox MCP — подключение и инструкция

Proxmox MCP подключает агента к Proxmox VE для чтения состояния узлов, виртуальных машин, контейнеров и доступных операций инфраструктуры.

РазработкаЛокальноAPI-ключ

Что умеет этот сервер

01

Proxmox MCP подключает агента к Proxmox VE для чтения состояния узлов, виртуальных машин, контейнеров и доступных операций инфраструктуры.

02

Community-проект поддерживает API token и пароль, обычный и routing-режим.

03

Прочитай список узлов и параметры одной тестовой VM.

Задача для знакомства

Через Proxmox MCP покажи узлы и состояние тестовой VM. Машины, диски, сеть и firewall не меняй.

Уточнить результат

Проверь кластер, VMID, роль токена и сертификат. В routing-режиме сначала найди инструмент, затем прочитай его входные параметры.

Как подключить

Выберите подходящий способ

Подключить Proxmox MCP

Добавь uvx proxmox-mcp-server. Настрой PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_NAME и PROXMOX_TOKEN_VALUE. Для первого чтения включи PROXMOX_READ_ONLY=true, PROXMOX_DISABLE_RAW_API=true и настрой проверку TLS вместо копирования отключённой проверки из примера.

Что понадобится

  • uv/uvx либо Docker, адрес Proxmox VE и отдельная учётная запись с ограниченными правами.
  1. 01

    Подготовь окружение

    uv/uvx либо Docker, адрес Proxmox VE и отдельная учётная запись с ограниченными правами.

  2. 02

    Установи и настрой

    Добавь uvx proxmox-mcp-server. Настрой PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_NAME и PROXMOX_TOKEN_VALUE. Для первого чтения включи PROXMOX_READ_ONLY=true, PROXMOX_DISABLE_RAW_API=true и настрой проверку TLS вместо копирования отключённой проверки из примера.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Команда сервера — доступы и read-only настраиваются отдельно

uvx proxmox-mcp-server

Первый запрос — пример для чата агента

Через Proxmox MCP покажи узлы и состояние тестовой VM. Машины, диски, сеть и firewall не меняй.

Как проверить

Проверь кластер, VMID, роль токена и сертификат. В routing-режиме сначала найди инструмент, затем прочитай его входные параметры.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет Proxmox

Proxmox MCP подключает агента к Proxmox VE для чтения состояния узлов, виртуальных машин, контейнеров и доступных операций инфраструктуры.

Community-проект поддерживает API token и пароль, обычный и routing-режим. Read-only в сервере — дополнительный барьер; фактические разрешения задаёт Proxmox.

Что подготовить перед подключением

uv/uvx либо Docker, адрес Proxmox VE и отдельная учётная запись с ограниченными правами.

Как установить и подключить

Добавь uvx proxmox-mcp-server. Настрой PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_NAME и PROXMOX_TOKEN_VALUE. Для первого чтения включи PROXMOX_READ_ONLY=true, PROXMOX_DISABLE_RAW_API=true и настрой проверку TLS вместо копирования отключённой проверки из примера.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай список узлов и параметры одной тестовой VM. Уточни node и VMID перед любым действием, затем сравни состояние в панели Proxmox.

Как проверить результат и решить проблемы

Проверь кластер, VMID, роль токена и сертификат. В routing-режиме сначала найди инструмент, затем прочитай его входные параметры.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Перезапуск, удаление, storage и firewall влияют на реальные машины. Read-only-флаг не заменяет минимальные права API и резервные копии.

Исходники и документация

Репозиторий: GethosTheWalrus/proxmox-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о Proxmox

Proxmox MCP подключает агента к Proxmox VE для чтения состояния узлов, виртуальных машин, контейнеров и доступных операций инфраструктуры.
Вернуться в библиотеку