Terminal — Extensión de Claude Desktop para Linux

Una extensión de Claude Desktop que proporciona a Claude acceso a la terminal, al sistema de archivos y a trabajos en segundo plano en tu máquina Linux local.

Resuelve una carencia en la versión de Linux de Claude Desktop donde los servidores MCP al estilo claude_desktop_config.json no se cargan (ese mecanismo es exclusivo de macOS/Windows); en Linux, la única forma de añadir herramientas es mediante extensiones instalables.

⚠️ Seguridad — lee esto primero

Instalar esta extensión otorga a Claude acceso ilimitado a la shell en tu cuenta de usuario. Cualquier cosa que tu usuario pueda hacer desde una terminal, Claude puede hacerlo a través de esta herramienta: leer cualquier archivo que tu usuario pueda leer, modificar cualquier cosa que pueda modificar, instalar software, abrir conexiones de red, etc.

Trata la instalación de esto de la misma manera que tratarías dar a alguien una sesión SSH a tu máquina. No la instales en máquinas con datos confidenciales que no querrías que Claude viera o en sistemas compartidos.

Existe una lista de denegación de seguridad mínima integrada que rechaza un puñado de comandos de una sola línea obviamente destructivos (rm -rf /, rm -rf ~, bombas fork, dd/mkfs en dispositivos de disco sin procesar, shutdown/reboot). Esta es una red de seguridad de último recurso, no un entorno aislado (sandbox). Un comando determinado puede eludirla trivialmente. Existe para que un momento de falta de atención no borre tu directorio personal.

Para endurecer las restricciones, edita la matriz DENYLIST en la parte superior de server.js y vuelve a compilar. Para eliminarlas por completo, establece DENYLIST = [] y vuelve a compilar.

Related MCP server: claude-linux-mcp

Qué hace

Expone 8 herramientas a Claude:

El estado de ejecución (transcripciones, archivos temporales de trabajo) reside en /tmp/claude-term-mcp/ y se borra al reiniciar.

Instalación

1. Descarga el archivo Terminal.mcpb más reciente desde la página de Releases.

2. Abre Claude Desktop → Settings → Extensions.

3. Desplázate hasta la sección Extension Developer en la parte inferior. Haz clic en Install Extension y selecciona el archivo Terminal.mcpb que descargaste.

4. Claude Desktop mostrará los detalles de la extensión con una advertencia roja de "información del desarrollador no verificada por Anthropic". Verifica que confías en la fuente y luego haz clic en Install.

5. En el momento de la instalación, Claude Desktop te pedirá un Default working directory (directorio de trabajo predeterminado): aquí es donde se ejecutan los comandos de shell cuando Claude no especifica uno. Elige tu carpeta principal de proyectos o déjalo vacío para que sea tu directorio personal.

6. De vuelta en All extensions, asegúrate de que Terminal esté activado.

7. En un chat, abre el selector de conectores/herramientas y habilita Terminal para esa conversación.

Puedes cambiar el directorio de trabajo predeterminado más tarde desde Settings → Extensions → Terminal.

Requisitos

• Claude Desktop ≥ 0.10.0 en Linux (también probado en macOS)

• Node.js ≥ 16 (Claude Desktop incluye un Node reciente que utiliza para ejecutar la extensión, por lo que no se requiere un Node del sistema)

• bash en PATH

No hay paso de npm install: la extensión es Node puro sin dependencias.

Configuración

Toda la configuración se realiza a través de la interfaz de usuario de Claude Desktop en el momento de la instalación o en Settings → Extensions → Terminal.

Para personalizar la lista de denegación u otro comportamiento, edita server.js y vuelve a compilar (ver más abajo).

Problemas conocidos

Banner amarillo: "Tool result could not be submitted. The request may have expired or the connection was interrupted." Esto aparece en cada turno que activa el paso de carga dinámica de herramientas de Claude. El 404 es sobre el envío del resultado de la búsqueda de herramientas al backend de Anthropic, no sobre la herramienta MCP en sí: tu llamada a la herramienta se ejecuta y devuelve correctamente inmediatamente después del banner. Es cosmético. El mismo problema también afecta a la extensión Filesystem estándar. Probablemente sea un desajuste de protocolo cliente↔backend que se solucionará en una futura versión de Claude Desktop.

Compilar desde el código fuente

git clone https://github.com/LukeLamb/claude-terminal-mcp
cd claude-terminal-mcp

# Edit whatever you want in server.js / manifest.json.
# If you change the tool surface, update both places.

# Bump the version in manifest.json so Claude Desktop treats the install as an update.

# Build the bundle:
zip -j Terminal.mcpb manifest.json package.json server.js

# Then install Terminal.mcpb via Claude Desktop → Settings → Extensions → Install Extension.

Desinstalación

Settings → Extensions → All extensions → Terminal → Remove.

Política de privacidad

Ningún dato sale de tu máquina. Esta extensión se ejecuta completamente de forma local:

• Recopilación de datos: Ninguna. La extensión no llama a casa, no emite telemetría ni realiza ninguna solicitud de red por sí misma. Todas las llamadas de red que observes serán las que tú le pidas a Claude que ejecute (por ejemplo, curl, wget, git push).

• Uso y almacenamiento de datos: Las transcripciones de comandos (stdin excluido, stdout + stderr + código de salida) se escriben en /tmp/claude-term-mcp/runs/<timestamp>.log para que Claude pueda hacer referencia a ellas más tarde en la misma conversación. El estado del trabajo en segundo plano (comando, pid, archivos de registro stdout/stderr, código de salida, estado) se escribe en /tmp/claude-term-mcp/jobs/<job-id>/.

• Compartir con terceros: Ninguno. Nada es transmitido nunca a Anthropic, al autor de la extensión o a terceros por esta extensión. (Claude Desktop en sí mismo envía por separado las entradas/salidas de las herramientas a Anthropic como parte del flujo normal de chat; esa es la relación de Anthropic contigo, no la de esta extensión).

• Retención: /tmp/claude-term-mcp/ se borra en cada reinicio. Para borrarlo manualmente: rm -rf /tmp/claude-term-mcp.

• Alcance de los permisos: Los comandos se ejecutan con los permisos de tu propio usuario, igual que si los escribieras en una terminal.

• Contacto / preguntas: Abre un issue en https://github.com/LukeLamb/claude-terminal-mcp/issues.

Licencia

MIT. Úsalo libremente, se agradece la atribución, sin garantía.