MCP local para Claude Code
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.