MCP locale per Claude Code
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.