MCP local para o Claude Code

Atualizado em 10 de novembro de 2026

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.