MCP local para Claude Code

Actualizado el 10 de noviembre de 2026

konsolity mcp lanza un servidor MCP local sobre la entrada y la salida estándar (stdio). Un agente de Claude que se ejecuta en la misma máquina, por ejemplo Claude Code, lo usa para listar tus hosts y ejecutar comandos en ellos, con exactamente las mismas reglas que konsolity run. Nada pasa por el conector Claude remoto: el agente habla directamente con la CLI.

La máquina debe estar activada con el ámbito mcp (y hosts, snippets para las herramientas correspondientes).

Conectar Claude Code

claude mcp add konsolity -- konsolity mcp

Comprueba que el servidor aparece:

claude mcp list

Claude Code lanza konsolity mcp en cada sesión y lo detiene al final. Cada sesión MCP abierta aparece en la lista de sesiones CLI de la cuenta, donde se puede terminar.

Herramientas

Herramienta Ámbito Función
list_hosts hosts Hosts del alcance: identificador, etiqueta, dirección, usuario, grupo. Ningún secreto.
list_snippets snippets Fragmentos del alcance: identificador, nombre, grupo.
run_command hosts, acceso completo Ejecuta un comando en un host del alcance, según las reglas de comandos.
run_snippet snippets + hosts, acceso completo Lanza un fragmento en un host del alcance.
list_sessions sessions Sesiones CLI en curso en la cuenta.

En solo lectura, solo se ofrecen las herramientas de listado.

Las mismas reglas

  • Host fuera del alcance, comando que no coincide con ninguna regla: rechazo, con un mensaje claro para el agente y una línea en el registro.
  • Comando destructivo: confirmación en la app o en la consola antes de cualquier ejecución, incluso con «Cualquier comando».
  • Tiempo límite: limitado por el tiempo máximo de la máquina (60 s por defecto, 1 h como máximo).
  • Revocación o fin de sesión: el comando en curso se detiene en menos de 5 segundos y el servidor MCP se cierra.

Salida limitada

El resultado de una herramienta devuelve el código de retorno, la duración, la salida estándar y la salida de error, limitadas a 64 KiB cada una. Por encima de ese tamaño, la salida se trunca y el resultado lo indica. Para obtener una salida completa, usa konsolity run en un terminal, cuya salida no está limitada.

Tres formas de conectar Claude

konsolity mcp Conector Claude konsolity serve
Claude utilizado Claude Code (o un agente) en la misma máquina claude.ai, app de Claude claude.ai, app de Claude
Transporte stdio local https://mcp.konsolity.com/mcp cola del conector, recogida por la máquina
Quién ejecuta la CLI en esta máquina la app de escritorio abierta la CLI como servicio, sin interfaz
Validación alcance y reglas de la máquina «Permitir una vez» en la app alcance y reglas de la máquina
Documentación esta página Conector Claude Servicio y almacenamiento

En todos los casos, los comandos destructivos que vienen de una máquina CLI esperan tu confirmación.