MCP local para o Claude Code
konsolity mcp inicia um servidor MCP local na entrada e na saída padrão (stdio). Um agente Claude que roda na mesma máquina, o Claude Code por exemplo, o usa para listar os seus hosts e executar comandos neles, com exatamente as mesmas regras do konsolity run. Nada passa pelo conector Claude remoto: o agente fala diretamente com a CLI.
A máquina precisa estar ativada com o domínio mcp (e hosts, snippets para as ferramentas correspondentes).
Conectar o Claude Code
claude mcp add konsolity -- konsolity mcp
Verifique se o servidor é reconhecido:
claude mcp list
O Claude Code inicia o konsolity mcp a cada sessão e o encerra no final. Cada sessão MCP aberta aparece na lista de sessões CLI da conta e pode ser encerrada ali.
Ferramentas
| Ferramenta | Domínio | Função |
|---|---|---|
list_hosts |
hosts |
Hosts do escopo: identificador, rótulo, endereço, usuário, grupo. Nenhum segredo. |
list_snippets |
snippets |
Snippets do escopo: identificador, nome, grupo. |
run_command |
hosts, acesso completo |
Executa um comando num host do escopo, de acordo com as regras de comando. |
run_snippet |
snippets + hosts, acesso completo |
Executa um snippet num host do escopo. |
list_sessions |
sessions |
Sessões CLI em andamento na conta. |
Com acesso somente leitura, apenas as ferramentas de listagem são oferecidas.
As mesmas regras
- Host fora do escopo, comando que não corresponde a nenhuma regra: recusa, com uma mensagem clara para o agente e uma linha no registro.
- Comando destrutivo: confirmação no app ou no console antes de qualquer execução, mesmo com “Qualquer comando”.
- Tempo limite: limitado pelo tempo limite máximo da máquina (60 s por padrão, 1 h no máximo).
- Revogação ou encerramento de sessão: o comando em andamento é interrompido em menos de 5 segundos e o servidor MCP para.
Saída limitada
O resultado de uma ferramenta devolve o código de retorno, a duração, a saída padrão e a saída de erro, limitadas a 64 KiB cada uma. Além disso, a saída é truncada e o resultado avisa. Para obter a saída completa, use konsolity run num terminal, cuja saída não é limitada.
Três formas de conectar o Claude
konsolity mcp |
Conector Claude | konsolity serve |
|
|---|---|---|---|
| Claude usado | Claude Code (ou um agente) na mesma máquina | claude.ai, aplicativo Claude | claude.ai, aplicativo Claude |
| Transporte | stdio local | https://mcp.konsolity.com/mcp |
fila do conector, consultada pela máquina |
| Quem executa | a CLI nessa máquina | o app de computador aberto | a CLI como serviço, sem interface |
| Aprovação | escopo e regras da máquina | “Permitir uma vez” no app | escopo e regras da máquina |
| Documentação | esta página | Conector Claude | Serviço e armazenamento |
Em todos os casos, os comandos destrutivos vindos de uma máquina CLI aguardam a sua confirmação.