Cómo instalar y configurar un MCP server en VS Code para Claude.

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los asistentes de IA como Claude acceder a herramientas externas, bases de datos o APIs directamente desde tu editor de código. Al instalar un MCP server en VS Code, transformas a Claude en un agente capaz de ejecutar comandos, leer archivos, interactuar con tu sistema de archivos o incluso conectarse a servicios como GitHub, todo sin salir del editor.

La gran ventaja es que dejas de tener un "chatbot" y obtienes un asistente que puede actuar sobre tu código real. Por ejemplo, puedes pedirle que revise un archivo de configuración, que ejecute un test o que te muestre el contenido de una carpeta, y Claude lo hará a través del MCP server. Esto es especialmente útil para desarrolladores que trabajan con proyectos grandes y necesitan respuestas contextualizadas.

💡 Tip: Asegúrate de tener instalado Node.js (v18 o superior) y VS Code con la extensión de Claude (o usar Claude Desktop con integración). El MCP server funciona como un puente entre Claude y tu máquina, así que necesitas permisos de ejecución.

Requisitos previos antes de instalar el MCP Server

Antes de lanzarte a la instalación, verifica que tienes todo lo necesario. Esto te ahorrará problemas de compatibilidad y errores raros a mitad del proceso.

RequisitoVersión mínimaComprobación Node.jsv18.0.0node --version npmv9.0.0npm --version VS Code1.85.0Ayuda > Acerca de Claude (extensión o app)Última versiónVerificar en marketplace Si no tienes Node.js, descárgalo desde la web oficial o usa un gestor de versiones como nvm. Personalmente recomiendo nvm porque te permite cambiar de versión fácilmente si trabajas con múltiples proyectos.

Paso a paso: Instalación del MCP Server en VS Code

1. Instalar el paquete MCP desde npm

El MCP server más popular para desarrollo es @modelcontextprotocol/server-filesystem, que permite a Claude leer y escribir archivos locales. También existen otros como server-github o server-postgres, pero para empezar, el de sistema de archivos es el más útil.

Abre tu terminal y ejecuta:

BASHnpm install -g @modelcontextprotocol/server-filesystem Esto instalará el servidor de forma global. Si prefieres no usar -g, puedes instalarlo localmente en tu proyecto, pero la instalación global es más práctica porque el servidor estará disponible para cualquier proyecto que abras en VS Code.

2. Configurar VS Code para usar el MCP Server

VS Code no sabe por sí solo que debe conectar Claude con el MCP server. Necesitas indicarle la configuración en el archivo settings.json del usuario o del proyecto.

Ve a: Archivo > Preferencias > Ajustes y busca "mcp". O directamente edita el JSON:

JSON{ "mcp.servers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/ruta/a/tu/proyecto" ] } } } Reemplaza /ruta/a/tu/proyecto con la carpeta raíz de tu proyecto. Si trabajas con varios proyectos, puedes crear configuraciones específicas en cada workspace.

3. Verificar que el servidor está funcionando

Para comprobar que todo está correcto, abre la paleta de comandos (Ctrl+Mayús+P o Cmd+Mayús+P) y escribe "MCP: List Servers". Deberías ver el servidor "filesystem" en la lista. Si aparece, ¡ya estás listo!

💡 Tip: Si el servidor no aparece, revisa que la ruta en args sea absoluta. Errores típicos son usar rutas relativas o no tener permisos de escritura en la carpeta indicada. Prueba con una carpeta simple como /tmp/prueba para descartar problemas.

Configuración avanzada: conectando Claude con tu MCP Server

Una vez que el servidor está activo, necesitas que Claude lo use. Si tienes la extensión de Claude para VS Code, la configuración es automática: Claude detecta los MCP servers disponibles y los ofrece como herramientas cuando haces consultas.

Para Claude Desktop (la app independiente), la configuración es manual. Debes editar el archivo claude_desktop_config.json que suele estar en:

• Windows: %APPDATA%\Claude\
• macOS: ~/Library/Application Support/Claude/
• Linux: ~/.config/Claude/

Dentro de ese archivo, añade la configuración del MCP server:

JSON{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/ruta/a/tu/proyecto" ] } } } Reinicia Claude y verás que ahora puede ejecutar comandos como "listar archivos", "leer este fichero" o "crear un archivo de prueba".

Ejemplo práctico: usa Claude para gestionar archivos

Ahora que todo está configurado, vamos a probarlo con un prompt real. Abre VS Code, activa Claude y pídele algo concreto:

PROMPTUsa el MCP server para listar los archivos de la carpeta raíz del proyecto. Luego, lee el contenido del archivo package.json y dime qué dependencias tiene. Finalmente, crea un archivo llamado 'notas.txt' con un resumen de las dependencias que encontraste. Si todo funciona, Claude ejecutará tres acciones secuenciales: listar, leer y escribir. Verás en la interfaz de Claude cómo va mostrando los resultados de cada paso. Esto demuestra el poder del MCP: Claude no solo te responde, sino que interactúa con tu sistema.

💡 Tip: Puedes restringir el acceso del MCP server a una carpeta específica para mayor seguridad. Por ejemplo, si solo quieres que Claude toque la carpeta src, cambia la ruta en la configuración. Así evitas que modifique archivos sensibles del sistema.

Solución de problemas comunes

No todo es perfecto la primera vez. Aquí tienes los errores más frecuentes y cómo solucionarlos:

ProblemaCausa probableSolución El servidor no aparece en la listaRuta incorrecta o npm no instalado globalmenteVerifica que npx funciona en terminal. Usa npx --version Claude no ejecuta las herramientasFalta permiso o la extensión no está actualizadaReinstala la extensión de Claude y reinicia VS Code Error "EACCES: permission denied"No tienes permisos de escritura en la carpetaCambia la ruta a una carpeta donde tengas permisos o ejecuta VS Code como administrador El MCP server se cuelgaVersión antigua de Node.jsActualiza Node.js a v18 o superior Si después de todo sigues teniendo problemas, revisa los logs de VS Code (Ayuda > Alternar herramientas de desarrollo) y busca errores relacionados con "mcp". También puedes ejecutar el servidor manualmente en terminal para ver si hay errores de conexión.

Con este setup, tendrás a Claude trabajando como un asistente real dentro de tu flujo de desarrollo. Ya no es solo un chat: es una herramienta que lee, escribe y ejecuta en tu nombre. Experimenta con diferentes MCP servers (GitHub, bases de datos, APIs) y verás cómo se multiplica tu productividad.