Cómo instalar un servidor MCP en Claude

El Model Context Protocol (MCP) es un estándar abierto de Anthropic que permite a Claude conectarse a fuentes de datos y herramientas externas: sistemas de archivos, bases de datos, APIs o repositorios. En lugar de copiar y pegar contexto manualmente, Claude invoca 'servidores MCP' que exponen recursos y herramientas de forma segura. Un servidor MCP es simplemente un proceso local (o remoto) que habla el protocolo. Claude Desktop actúa como cliente: lanza esos servidores al arrancar y les pide datos cuando lo necesita. En este tutorial instalaremos el servidor oficial 'filesystem', que da a Claude acceso controlado a una carpeta concreta de tu disco. Antes de empezar confirma que tienes Claude Desktop (no la versión web, que aún no soporta MCP local) y Node.js. Comprueba Node con el comando siguiente. Si tienes v18 o superior, estás listo. En España y LATAM la instalación es idéntica; solo cambia la ruta del archivo de configuración según tu sistema operativo.

node --version
npm --version

Claude Desktop lee su configuración de MCP desde un archivo JSON llamado claude_desktop_config.json. La ubicación depende del sistema operativo. Si el archivo no existe todavía, lo crearás tú mismo en la misma carpeta. En macOS está en ~/Library/Application Support/Claude/. En Windows, en %APPDATA%\Claude\. La forma más rápida de abrir la carpeta correcta es desde la propia app: menú Claude > Settings (Ajustes) > Developer > Edit Config. Ese botón abre directamente el archivo en tu editor por defecto y crea la estructura básica si no existía. Si prefieres la terminal, usa los comandos de abajo para abrir o crear el archivo. Trabajar desde Settings > Developer es lo más seguro porque garantiza que editas el archivo que la app realmente lee, evitando el error clásico de editar una copia en la ruta equivocada.

# macOS
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows (PowerShell)
notepad $env:APPDATA\Claude\claude_desktop_config.json

Ahora declararemos el servidor dentro de la clave mcpServers. Cada servidor tiene un nombre (lo eliges tú), un comando para lanzarlo y sus argumentos. Para el servidor filesystem usaremos npx, que descarga y ejecuta el paquete oficial sin instalación previa. En args, el último argumento es la ruta de la carpeta a la que Claude tendrá acceso. Cambia /Users/tu-usuario/Documentos/claude-mcp por una ruta real de tu equipo. Recomiendo crear una carpeta dedicada para pruebas en lugar de exponer todo tu disco. Puedes añadir varias rutas separándolas como argumentos adicionales. Pega el JSON de abajo respetando la estructura exacta. Si ya tenías otros servidores configurados, añade solo la entrada 'filesystem' dentro del objeto mcpServers sin borrar los demás. Guarda el archivo cuando termines.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/tu-usuario/Documentos/claude-mcp"
      ]
    }
  }
}

Claude Desktop solo lee la configuración de MCP al arrancar, así que necesitas reiniciar la aplicación por completo para que detecte el nuevo servidor. Cerrar la ventana no basta: la app suele quedar residente en la barra de menú (macOS) o en la bandeja del sistema (Windows). En macOS, usa Cmd+Q o clic derecho en el icono del Dock > Salir. En Windows, clic derecho en el icono de la bandeja > Quit. Después vuelve a abrir Claude. Durante el primer arranque, npx descargará el paquete del servidor filesystem, lo que puede tardar unos segundos; es normal que la primera vez sea más lenta. Si tu conexión es lenta o estás detrás de un proxy corporativo, la descarga de npx podría fallar en silencio. En ese caso, ejecuta el paquete manualmente una vez desde la terminal para cachearlo antes de reiniciar Claude.

# Cachear el servidor manualmente (opcional, ayuda con conexiones lentas)
npx -y @modelcontextprotocol/server-filesystem /Users/tu-usuario/Documentos/claude-mcp

Al reabrir Claude Desktop, busca el icono de herramientas (un pequeño control deslizante o icono de enchufe) en la esquina inferior de la caja de texto del chat. Al pulsarlo verás la lista de servidores MCP conectados y las herramientas que exponen. Para filesystem verás acciones como read_file, write_file, list_directory o search_files. La mejor prueba es funcional: escribe a Claude una petición que requiera acceder a la carpeta. Por ejemplo, pídele que liste los archivos del directorio configurado. Claude te pedirá permiso para usar la herramienta la primera vez; aprueba la acción y verás el resultado real de tu sistema de archivos. Si las herramientas aparecen y Claude devuelve el contenido correcto de tu carpeta, la instalación funciona. Este mismo patrón sirve para cualquier otro servidor MCP: la verificación siempre es 'aparece en el panel de herramientas' más 'responde con datos reales'.

Si el servidor no aparece, revisa los logs de MCP, donde Claude registra por qué falló el arranque de cada servidor. En macOS están en ~/Library/Logs/Claude/ y en Windows en %APPDATA%\Claude\logs\. El archivo mcp.log y los mcp-server-*.log te dirán si fue un problema de comando no encontrado, ruta inválida o error de protocolo. Los tres fallos más frecuentes: (1) 'command not found: npx', que se soluciona instalando Node correctamente o usando la ruta absoluta a npx; (2) JSON mal formado, que detectas validando el archivo con jq o un linter; (3) ruta de carpeta inexistente, que impide arrancar el servidor filesystem. Corrige, guarda y reinicia Claude por completo tras cada cambio. Una vez domines este flujo, instalar servidores más potentes (GitHub, Postgres, Brave Search o los que crees tú mismo) sigue exactamente los mismos pasos.

# Validar el JSON de configuración (macOS/Linux)
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq .

# Ver los logs de MCP en tiempo real (macOS)
tail -f ~/Library/Logs/Claude/mcp.log