Conexión de Claude MCP Linux al servidor: configuración SSH
Aunque le encargues a Claude trabajo en tu servidor Linux, tu archivo de clave SSH nunca sale de tu PC. Claude MCP Linux es la conexión al servidor que une a Claude con la terminal y los archivos de tu servidor Linux por SSH. Esta guía explica lo que viaja y lo que no, y después los pasos de configuración.
Claude MCP(Model Context Protocol) es el estándar que usa Claude para conectarse a herramientas y datos externos, y un servidor MCPes el programa que ofrece funciones según ese estándar. El concepto y la configuración de conectores en Claude Desktop están en Conceptos básicos de Claude MCP (artículo aparte).
Ⅰ. ¿Qué es un servidor Claude MCP Linux?
Al conectar MCP a Claude Desktop, Claude lee archivos de tu PC y ejecuta tareas. Una conexión de Claude MCP Linux traslada ese objetivo a un servidor Linux remoto por SSH: los comandos se ejecutan en el servidor y solo los resultados vuelven a Claude.
No hay que abrir nada nuevo en el servidor. Usas el mismo SSH y la misma clave de siempre; lo único que cambia es que quien escribe los comandos pasa a ser Claude en lugar de una persona. Lo que puede ejecutar y ver depende de los permisos de la cuenta de acceso.
Ⅱ. Configuración de Claude MCP Linux
La configuración tiene cuatro pasos, desde la prueba de conexión SSH hasta la revisión de errores de conexión. Necesitas ⓐ la app Claude Desktop, ⓑ los datos de acceso al servidor (dirección del host, cuenta y puerto) y un archivo de clave (.pem), y ⓒ Node.js para ejecutar el paquete del servidor MCP en tu PC.
Puedes ver los pasos 1️⃣–4️⃣ de una vez en el simulador o revisarlos en el índice.
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-de-tu-servidor",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\ruta-de-la-clave\\miclave.pem"
]
}
1️⃣ Prueba de conexión SSH
Para registrar el servidor en Claude, prueba la conexión SSH desde tu PC y prepara lo necesario.
~]# 2️⃣ Registrar el SSH MCP Server
SSH MCP Server solo se puede registrar en la app, no en la web. Abre la app de Claude y ve a [Configuración › Desarrollador].
Pulsa [Editar configuración].
Se abre la carpeta que contiene claude_desktop_config.json.
Abre el archivo con un editor de texto como el Bloc de notas o EditPlus y revisa su contenido.
En la línea 47 de la imagen, escribe una coma después de [}] (,) y pega la entrada.
La entrada que debes pegar está abajo. Sustituye [--host] por la dirección del servidor, [--port] por el puerto SSH (22 por defecto), [--username] por la cuenta de acceso y [--privateKey] por la ruta completa del archivo de clave (.pem).
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-de-tu-servidor",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\ruta-de-la-clave\\miclave.pem"
]
}En Windows, pon commanden cmd en lugar de npx y añade /c como primer elemento de args. En macOS o Linux, pon npx directamente en command y quita /c.
Si el archivo no tiene la entrada mcpServers, no hay dónde pegar. En ese caso, deja todo el archivo así.
{
"mcpServers": {
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-de-tu-servidor",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\ruta-de-la-clave\\miclave.pem"
]
}
}
}Cuando termines, pulsa Ctrl + S para guardar.
3️⃣ Permisos de herramientas y primera ejecución
Reinicia la app de Claude.Si la pantalla no cambia, fuerza el cierre en el Administrador de tareas y vuelve a abrirla; si aparece un error, consulta el paso 4️⃣.
Pedí a Claude que ejecutara el comando hostname como prueba sencilla.
4️⃣ Error de conexión: Node.js no instalado
Al revisarlo con [Ver registros], el error se debía a que la carpeta de Node.js (C:\Program Files\nodejs) no estaba instalada.
Para instalar Node.js, abre https://nodejs.org/ko/downloaden el navegador.
Descarga el archivo .msi para Windows e instálalo.
Déjala sin marcar y pulsa Next. Pregunta si quieres instalar además las herramientas de compilación de C/C++; el paquete SSH MCP no las necesita y, si la marcas, también se instalan Chocolatey y las herramientas de compilación de Visual Studio.
Cierra Claude por completo, incluido el proceso en segundo plano, y vuelve a abrirlo.
Al revisar de nuevo el registro, el mensaje había cambiado a «no conectado».
Escribe comandos de diagnóstico en una ventana de CMD para averiguar la causa.
A partir de aquí, Claude puede ayudarte a resolverlo, así que te recomiendo revisar el error directamente y solucionarlo con su ayuda.
Ⅲ. Preguntas frecuentes
ℹ️ Aviso de afiliados
El contenido de este sitio incluye enlaces de afiliado. Cuando un visitante compra un producto o servicio a través de uno de ellos, el sitio recibe una comisión del vendedor. El importe que paga el comprador(baja durante las promociones ↓)no aumenta. Los precios, descuentos y existencias publicados corresponden al momento de redacción y pueden variar, así que confírmalos con el vendedor antes de comprar. Los productos se eligen y evalúan con criterios propios, y las comisiones no influyen en el orden ni en el contenido de las reseñas.