MCP locale per Claude Code

Aggiornato il 10 novembre 2026

konsolity mcp avvia un server MCP locale su standard input e output (stdio). Un agente Claude in esecuzione sulla stessa macchina, ad esempio Claude Code, lo usa per elencare i tuoi host ed eseguirvi comandi, con esattamente le stesse regole di konsolity run. Nulla passa dal connettore Claude remoto: l'agente comunica direttamente con la CLI.

La macchina deve essere attivata con il dominio mcp (e hosts, snippets per gli strumenti corrispondenti).

Collegare Claude Code

claude mcp add konsolity -- konsolity mcp

Verifica che il server sia rilevato:

claude mcp list

Claude Code avvia konsolity mcp per ogni sessione e lo arresta alla fine. Ogni sessione MCP aperta compare nell'elenco delle sessioni CLI dell'account e da lì può essere terminata.

Strumenti

Strumento Dominio Ruolo
list_hosts hosts Host nell'ambito: identificativo, etichetta, indirizzo, utente, gruppo. Nessun segreto.
list_snippets snippets Snippet nell'ambito: identificativo, nome, gruppo.
run_command hosts, accesso completo Esegue un comando su un host nell'ambito, secondo le regole dei comandi.
run_snippet snippets + hosts, accesso completo Esegue uno snippet su un host nell'ambito.
list_sessions sessions Sessioni CLI in corso sull'account.

Con l'accesso in sola lettura vengono offerti solo gli strumenti di elenco.

Stesse regole

  • Host fuori dall'ambito, comando che non corrisponde a nessuna regola: rifiutato, con un messaggio chiaro per l'agente e una riga nel registro.
  • Comando distruttivo: conferma nell'app o sulla console prima di qualsiasi esecuzione, anche con «Qualsiasi comando».
  • Timeout: limitato dal timeout massimo della macchina (60 s per impostazione predefinita, 1 h al massimo).
  • Revoca o fine della sessione: il comando in corso viene interrotto in meno di 5 secondi e il server MCP si arresta.

Output limitato

Il risultato di uno strumento restituisce il codice di uscita, la durata, l'output standard e l'output di errore, limitati a 64 KiB ciascuno. Oltre questa soglia l'output viene troncato e il risultato lo segnala. Per l'output completo, usa konsolity run in un terminale, il cui output non è limitato.

Tre modi di collegare Claude

konsolity mcp Connettore Claude konsolity serve
Claude usato Claude Code (o un agente) sulla stessa macchina claude.ai, l'app Claude claude.ai, l'app Claude
Trasporto stdio locale https://mcp.konsolity.com/mcp coda del connettore, prelevata dalla macchina
Chi esegue la CLI su questa macchina l'app desktop aperta la CLI come servizio, senza interfaccia
Approvazione ambito e regole della macchina «Consenti una volta» nell'app ambito e regole della macchina
Documentazione questa pagina Connettore Claude Servizio e archiviazione

In ogni caso, i comandi distruttivi provenienti da una macchina CLI attendono la tua conferma.