forked from agentify-sh/cursor-proxmox-mcp
-
Notifications
You must be signed in to change notification settings - Fork 0
Troubleshooting
wiki-sync edited this page Jul 19, 2026
·
2 revisions
| Symptom | Fix |
|---|---|
| Green MCP but only ~13–14 tools | Stale Cursor catalog or wrong package. Disable/Enable proxmox; quit Cursor fully; use uvx --from <checkout> cursor-proxmox-mcp or uvx cursor-proxmox-mcp
|
| Empty VM/CT lists | Token privsep with no ACL on user@realm!tokenid — call get_token_permissions
|
| Create “succeeded” but guest missing / start fails | Async UPID race — always wait_for_task after create_* (and clone/migrate/backup). Create ≠ ready; task errors (e.g. missing template) surface on wait |
| Agent treats create as app deploy |
create_lxc is OS template only — nesting ≠ Docker. Install apps post-start (Recipes) |
| Config change “did nothing” | Call get_guest_pending; reboot guest to apply hotplug-limited keys |
execute_lxc_command fails / HTTP 501 |
Needs opt-in ssh + paramiko (pct exec). 501 on /lxc/.../exec = stale MCP (pre-1.1.1) — reload/uvx --from checkout. Without SSH use ssh_public_keys at create or static IP only. |
| Host SSH auth failed / permission denied | Public key not on the Proxmox node authorized_keys (host SSH ≠ guest ssh_public_keys). Verify: ssh -i <key> user@host "pct version". See SETUP.md — SSH. |
Enabled ssh in config but tools still say not configured |
MCP reads config at process start — Disable/Enable the server (or quit Cursor). Also confirm ssh.enabled: true and paramiko/[ssh] extra. |
Wrong host for pct / connection timeout |
Set host_overrides to map node name → SSH IP when API host ≠ node address (e.g. "pve": "192.168.0.23"). Open 22/tcp from the Cursor host. |
Guest SSH auth failed after password=
|
Many templates block root password SSH. Pass ssh_public_keys on create, or set_lxc_password(enable_password_ssh=true) after start (needs host SSH). |
get_vms empty but containers exist |
Expected — get_vms is QEMU-only; use get_containers or get_cluster_resources
|
| LXC suspend/resume fails | CRIU best-effort; prefer shutdown_lxc / shutdown_guest
|
| Wrong package installed | Uninstall proxmox-mcp-server from Gethos; install cursor-proxmox-mcp
|
| SSL errors | Lab: verify_ssl: false in config (warned at startup); prod: fix CA / enable verify |
More: SETUP.md troubleshooting · SECURITY.md · Recipes.
cursor-proxmox-mcp
Repo