Conéctese a los servidores MCP locales desde Claude Desktop

Los servidores MCP son programas que se ejecutan en su computadora y proporcionan capacidades específicas a Claude Desktop mediante un protocolo estandarizado, es decir, cada servidor expone herramientas que Claude puede usar para realizar acciones previa aprobación del usuario.

Requisitos:

1. Claude Desktop
2. Node.JS

Si Node.JS no está instalado, descarga desde la página oficial nodejs.org . Claude proporciona herramientas para:

• Lectura del contenido de archivos y las estructuras de directorios.
• Creación de nuevos archivos y directorios.
• Mover y renombrar archivos.
• Búsqueda de archivos por nombre o contenido.
• Consultar APIS externas.

Al instarlar Claude Desktop no se tendrá habilitado la opción multmodal de herramientas.

1. Configuración de Claude Desktop

Accede a la configuración de Claude Desktop.

Seleccionar Desarrollador y clin en Editar configuración.

Crea un nuevo archivo de configuración si no existe, o abre el archivo de configuración existente.

Validad el archivo desde la ruta:

• Windows :%APPDATA%\Claude\claude_desktop_config.json
• macOS :~/Library/Application Support/Claude/claude_desktop_config.json

2. Configuración del servidor de sistema de achivos

Remplaza el contenido JSON del archivo claude_desktop_config.json por el siguiente:

{

  "mcpServers": {

    "filesystem": {

      "command": "npx",

      "args": [

        "-y",

        "@modelcontextprotocol/server-filesystem",

        "C:\\Users\\User\\archivos-mcp"

      ]

    },

    "MiServidorPython": {

      "command": "D:\\Hadson.TECH\\LEARNING\\MCP-Learning\\.venv\\Scripts\\python.exe",

      "args": [

        "D:\\Hadson.TECH\\LEARNING\\MCP-Learning\\server-py.py"

      ]

    }

  }

El username debe ser emplaza por el nombre de usuario real de su equipo.

Se agregaron 2 MCP Server como filesystem y MiServidorPython que están listas para poder usarlas.

Desglose por servidor

filesystem

Campo	Valor	Función
command	npx	Ejecuta el paquete sin instalación global previa.
args[0-1]	-y, @modelcontextprotocol/server-filesystem	Auto-confirma la descarga e invoca el servidor oficial de MCP para operaciones de archivos.
args[2]	"C:\\Users\\User\\archivos-mcp"	Sandbox obligatorio: el servidor solo puede leer/escribir dentro de esta carpeta. User debe reemplazarse por el nombre real de usuario de Windows (whoami en PowerShell lo confirma).

MiServidorPython

Campo	Valor	Función
command	Ruta absoluta al python.exe del entorno virtual .venv	Evita depender del PATH del sistema; garantiza que se use el intérprete donde está instalado fastmcp.
args[0]	Ruta absoluta a server-py.py	Script del servidor construido con FastMCP, transporte stdio.

Notas técnicas relevantes que el artículo da por sentadas

• Doble backslash (\\): obligatorio en JSON dentro de rutas de Windows, ya que \ es carácter de escape.
• npx vs. ruta a python.exe: son dos formas válidas de command — un ejecutable en PATH (npx) o una ruta absoluta a un intérprete específico. Para Python es más robusto usar la ruta absoluta al venv, como se vio en la corrección del error ModuleNotFoundError: No module named 'fastmcp' de la conversación anterior.
• "Multimodal de herramientas" deshabilitado por defecto: se refiere a que, al instalar Claude Desktop, el soporte de conectores/MCP no viene activado — hay que habilitarlo explícitamente en Configuración → Desarrollador antes de editar el config.

Puede revisar el tutorial práctico donde desarrollamos el Servicio MCP MiServidorPython en Python utilizando FastMCP.

Finalmene reinicia Claude Desktop, tras un reinicio exitoso, valida la configuración de ambos Servidor MCP agregados y en estado Activo; clic en el botón + (del chat) inferior izquierda / Conectores (filesystem y MiServidorPython). Si no responde o no reconoce la herramienta, asegúrate de haber reiniciado completamente Claude Desktop tras modificar el archivo de configuración y verifica los registros (logs) de desarrollo si persiste el fallo.

Con estos pasos ya se tiene configurado los servicios MCP locales y listos para poder conectarse desde Claude Desktop y poder realizar acciones (consultas) según cada 

servicios MCP.

3. Pasos para realizar las consultas

1. Escribe tu petición normal en el chat:

Simplemente pídele a Claude lo que necesites relacionado con ese servicio (por ejemplo: "Busca los archivos de la carpeta X", "Consulta las ventas de la base de datos", "Revisa el clima en Lima" o "Saluda a Jaime").

Clic en Permitir una vez para poder ejecutar el Servicio MCP

Resultado de la prompt enviado como "Saluda a Jaime"

2. Autoriza el uso de la herramienta:

Cuando Claude decida usar el servicio MCP para responderte, aparecerá una notificación en la interfaz pidiéndote permiso (Allow / Deny) para ejecutar la herramienta.

3. Revisa el resultado:

Una vez que apruebes el acceso, Claude procesará los datos que devuelva el servidor MCP y te dará la respuesta directamente en la conversación.

Resumen

En este artículo explicamos cómo configurar servidores MCP locales en Claude Desktop, es decir, programas que corren en la propia computadora del usuario y le desde Claude agregamos capacidades (leer/crear archivos, mover/renombrar, buscar contenido, consultar APIs externas) mediante un protocolo estandarizado. La ejecución de cualquier herramienta requiere aprobación explícita del usuario en cada solicitud — Claude no actúa de forma autónoma sobre el sistema.

Los pasos cubiertos son:

1. Requisitos previos: tener instalado Claude Desktop y Node.js (necesario porque el servidor filesystem se ejecuta vía npx, el ejecutor de paquetes de Node).
2. Ubicar el archivo de configuración claude_desktop_config.json, accesible desde Configuración → Desarrollador → Editar configuración, con rutas distintas en Windows y macOS.
3. Declarar los servidores dentro del bloque mcpServers — en este caso dos: filesystem (servidor oficial de MCP para operar sobre una carpeta local) y MiServidorPython (el servidor personalizado en Python/FastMCP construido en el tutorial previo).
4. Reiniciar Claude Desktop por completo tras cualquier cambio al JSON, y verificar el estado "Activo" de ambos servidores desde el botón "+" → Conectores.
5. Flujo de uso: el usuario escribe una petición en lenguaje natural, Claude decide si necesita invocar una herramienta MCP, solicita autorización (Allow/Deny) antes de ejecutarla, y finalmente devuelve el resultado procesado dentro de la conversación.