Server MCP

Il server MCP del Panel KVM collega un assistente IA ai Suoi VPS. MCP (Model Context Protocol) è lo standard aperto che consente agli assistenti di utilizzare servizi esterni: Lei chiede in linguaggio corrente l’elenco dei Suoi server, il loro carico della settimana, uno snapshot prima di un aggiornamento o l’apertura di una porta, e l’assistente esegue per Lei le chiamate al Panel KVM.

Il server è ospitato da LWS all’indirizzo https://panelkvm.lwspanel.com/mcp/v1: non c’è nulla da installare. Tutto si configura nel Panel KVM, nella pagina API / MCP, scheda Server MCP: lì sceglie il livello di permessi dell’assistente e i VPS che può gestire, e può interromperne l’accesso in qualsiasi momento. Ogni sua azione viene registrata.

Prima di iniziare

• L’account principale. La pagina API / MCP è riservata al titolare dell’account: i sotto-account non possono collegare un assistente.
• Un assistente compatibile con MCP «remoto»: Claude, ChatGPT, Claude Code, Cursor, VS Code, Gemini CLI, Codex CLI, Mistral, n8n o qualsiasi strumento compatibile con Streamable HTTP.
• Nient’altro. Il MCP funziona indipendentemente dall’API REST: non è necessario attivare l’API, creare una chiave API né dichiarare un indirizzo IP.

Attivare il MCP

1. Nel Panel KVM, apra la pagina API / MCP (menu a sinistra), poi la scheda Server MCP.
2. Attivi l’interruttore. Ogni attivazione e disattivazione Le viene confermata via e-mail.
3. Scelga i server gestibili dall’assistente: tutti i Suoi VPS, compresi quelli aggiunti in seguito, oppure una selezione. Per impostazione predefinita, non ne gestisce nessuno.
4. Controlli il livello di permessi: per impostazione predefinita, l’assistente è in sola lettura (vedere più avanti).

Collegare il Suo assistente

Due modi, a seconda dell’assistente:

• Claude e ChatGPT si collegano tramite autorizzazione (OAuth): basta l’indirizzo del server, nessun token da copiare. Lei dà il Suo consenso su una pagina del Panel KVM.
• Gli altri (Claude Code, Cursor, VS Code, n8n…) utilizzano il token MCP, che Lei genera nella scheda Server MCP e che inviano nell’intestazione Authorization: Bearer. Il suo valore viene mostrato una sola volta: lo copi al momento della generazione. Il pannello mostra inoltre, per ogni strumento, la configurazione pronta da copiare.

I diritti sono gli stessi nei due casi: il livello di permessi e i server gestibili del Suo accesso MCP.

Claude (claude.ai, applicazione desktop o mobile)

1. In Claude, apra Impostazioni › Connettori, poi aggiunga un connettore personalizzato.
2. Nome: LWS Panel KVM. Indirizzo: https://panelkvm.lwspanel.com/mcp/v1. Mantenga l’autenticazione proposta per impostazione predefinita, senza intestazione da inserire.
3. Claude apre la pagina di autorizzazione del Panel KVM: verifichi le informazioni, poi clicchi su Autorizzare. Il connettore è disponibile anche nell’applicazione desktop e su mobile.

ChatGPT

1. Su chatgpt.com, aggiunga un server MCP personalizzato (menu dei plugin o dei connettori, a seconda della versione). L’opzione dipende dal Suo abbonamento e dalle impostazioni del Suo spazio di lavoro.
2. Indirizzo del server: https://panelkvm.lwspanel.com/mcp/v1. Autenticazione: OAuth.
3. Clicchi su Connetti: ChatGPT apre la pagina di autorizzazione del Panel KVM, dove clicca su Autorizzare.

Se non ha effettuato l’accesso al Panel KVM, la pagina di autorizzazione La invita a passare dalla Sua area clienti LWS e ad aprire il Panel KVM da un VPS (Gestisci): viene riportato automaticamente all’autorizzazione, che resta valida per 10 minuti. La pagina indica il dominio dell’applicazione (claude.ai, chatgpt.com…): lo verifichi prima di autorizzare. Ogni nuova autorizzazione Le viene segnalata via e-mail.

Claude Code

In un terminale, sostituendo IL_SUO_TOKEN con il valore del token:

claude mcp add --transport http lwskvm https://panelkvm.lwspanel.com/mcp/v1 --header "Authorization: Bearer IL_SUO_TOKEN"

Cursor e altri editor

Aggiunga questo server al file di configurazione MCP dell’editor (per Cursor: ~/.cursor/mcp.json), poi lo riavvii:

{
  "mcpServers": {
    "lwskvm": {
      "url": "https://panelkvm.lwspanel.com/mcp/v1",
      "headers": { "Authorization": "Bearer IL_SUO_TOKEN" }
    }
  }
}

VS Code, Gemini CLI e Codex CLI hanno ciascuno il proprio formato di file: il pannello mostra quello giusto per ognuno.

n8n

1. Aggiunga al Suo agente IA lo strumento MCP Client Tool.
2. Endpoint: https://panelkvm.lwspanel.com/mcp/v1. Transport: HTTP Streamable.
3. Authentication: Bearer Auth, con il valore del token.

Scegliere cosa può fare l’assistente

Il Suo accesso MCP ha le proprie impostazioni, indipendenti da quelle dell’API:

• il livello di permessi, fra tre (vedere sotto);
• i server gestibili: un VPS fuori dall’elenco è invisibile per l’assistente;
• gli indirizzi IP autorizzati, facoltativi: lasci l’elenco vuoto per Claude e ChatGPT, che si collegano dalla propria infrastruttura.

Inizi dalla sola lettura e ampli solo se necessario. Ogni innalzamento del livello Le viene segnalato via e-mail, e il passaggio al livello Completo deve essere confermato con un codice inviato via e-mail al titolare dell’account. Il ritorno a un livello inferiore non lo richiede.

Gli strumenti di sola lettura non modificano nulla. Quelli di operatività agiscono senza distruggere nulla: avviare o arrestare un VPS, creare uno snapshot o un backup, gestire le regole del firewall, il reverse DNS, le immagini ISO e le chiavi SSH. Gli strumenti del livello Completo sono irreversibili o espongono il server: ritorno a uno snapshot, ripristino di un backup, disattivazione del firewall, modalità rescue, password root, reinstallazione. Uno strumento al di sopra del livello scelto non viene nemmeno proposto all’assistente.

Mantenere il controllo

• Conferma prima di ogni azione: l’assistente annuncia ciò che sta per fare e attende il Suo consenso. Per un’azione distruttiva (reinstallazione, password root, eliminazione di uno snapshot…), deve ricopiare una frase esatta, ad esempio rebuild 107596.
• Simulazione prima di modificare il firewall: regole aggiunte o rimosse, e un avviso se l’accesso SSH rischia di essere interrotto, senza applicare nulla.
• Cronologia delle chiamate: le ultime 50 chiamate degli ultimi 30 giorni (ora, strumento, origine, VPS, risultato, indirizzo IP), con filtri su azioni ed errori. Le azioni compaiono anche nel registro attività del Suo account.
• Applicazioni collegate: ogni assistente autorizzato tramite OAuth vi figura con il proprio dominio e il suo ultimo utilizzo. Revoca gli toglie l’accesso immediatamente.
• In qualsiasi momento, può rigenerare il token (gli strumenti che lo usano vengono scollegati) o interrompere l’accesso MCP con un interruttore.

Da sapere

• Un assistente può sbagliare: rilegga ciò che propone prima di una reinstallazione, di un ripristino o di una modifica del firewall.
• Il numero di chiamate è limitato per ora: 600 letture e 60 azioni per account, e 3 azioni pesanti (reinstallazione, ripristino, ritorno a uno snapshot, modalità rescue) per VPS, entro un massimo di 20 per l’account. Oltre questi limiti, l’assistente viene informato del tempo di attesa. Lo stato e le metriche di un VPS vengono aggiornati al massimo ogni 15 secondi.
• I testi che ha inserito nel pannello (commenti, descrizioni…) vengono segnalati all’assistente come dati, mai come istruzioni.
• Un’autorizzazione OAuth si rinnova da sola; dopo 30 giorni senza utilizzo, l’assistente Le chiede di autorizzarlo di nuovo.
• Ciò che il MCP restituisce all’assistente (elenco dei VPS, metriche…) viene trasmesso al suo fornitore, che lo tratta secondo le proprie condizioni. La cronologia, invece, non conserva mai il contenuto delle Sue richieste.
• LWS non Le chiederà mai il Suo token MCP.