Conectar Claude a tus herramientas con MCP

Al terminar esta enseñanza, Claude Desktop va a poder leer, mover y organizar archivos de tu equipo sin que tengas que arrastrarlos al chat ni copiar su contenido a mano. Es el salto que separa al Claude que solo conversa del Claude que ejecuta tareas reales sobre tu disco: clasifica descargas, renombra fotos, busca un PDF perdido o lee tres documentos antes de redactar un informe. Y lo hace pidiéndote permiso antes de cada acción, así que mantienes el control en todo momento.

MCP, las siglas de Model Context Protocol, es el estándar abierto que Anthropic publicó para conectar modelos con herramientas externas. La pieza clave es el “servidor MCP”: un pequeño programa que expone capacidades concretas (acceder a tu sistema de archivos, hablar con GitHub, consultar una base de datos) y que el cliente, en este caso Claude Desktop, arranca y consulta cuando hace falta. En esta enseñanza vas a conectar el servidor oficial de filesystem, que es el más útil para empezar y el que mejor se entiende.

La preparación es liviana: unos 25 minutos contando descargas y el primer reinicio. Antes de empezar, ten Claude Desktop ya instalado y abierto al menos una vez, ten Node.js en su versión LTS y ten claro el nombre de tu usuario del sistema porque vas a escribirlo en la configuración. Si nunca tocaste un archivo JSON, no te preocupes: la estructura cabe en quince líneas y la copias tal cual.

Antes de empezar

Como dice el frontmatter, hace falta Claude Desktop, Node.js LTS y conocer tu nombre de usuario. Conviene además decidir desde el principio qué carpetas quieres exponer. La recomendación honesta es empezar con dos o tres bien acotadas (Escritorio, Descargas, una carpeta de trabajo) y nunca apuntar a la raíz del disco, a la carpeta del sistema ni a directorios que contengan credenciales o claves. MCP respeta lo que pongas en la configuración: si le das media máquina, podrá tocar media máquina.

Otra decisión previa útil: tener a mano un editor de texto plano decente (VS Code, Sublime, Notepad++ o el que uses) para abrir el JSON sin que el sistema operativo le añada extensiones raras. Editarlo desde dentro de Claude Desktop con el botón “Edit Config” también funciona y suele ser lo más cómodo la primera vez.

El recorrido completo

El primer paso, comprobar que Node responde, parece trivial y no lo es. La mayoría de servidores MCP del ecosistema se distribuyen como paquetes de npm y se arrancan con npx. Si Node no está en el PATH, Claude Desktop intentará lanzar el servidor, fallará en silencio y solo verás que el indicador de herramientas no aparece. Por eso conviene confirmarlo desde la terminal antes de seguir: si la versión sale impresa, todo bien; si no, instala la LTS desde nodejs.org y reabre la terminal para que el PATH se actualice.

El segundo paso, abrir el archivo de configuración, tiene una ruta distinta en cada sistema y eso suele confundir. Lo más rápido es entrar a Claude Desktop, ir a Configuración, abrir la pestaña Developer y pulsar “Edit Config”. Esa acción crea el archivo si todavía no existe y lo abre con tu editor por defecto. Si prefieres ir directo al fichero, las rutas exactas están en el frontmatter; en Mac fíjate en que “Application Support” lleva espacio y en Windows que %APPDATA% se expande solo si lo pegas en el explorador.

El tercer paso es el corazón de todo: añadir el servidor de filesystem con sus rutas. El JSON tiene tres claves anidadas (mcpServers, el nombre que tú eliges para ese servidor, y un objeto con command y args). El comando es npx; los argumentos son la bandera -y para aceptar la descarga sin preguntar, el paquete @modelcontextprotocol/server-filesystem y, a continuación, todas las rutas que quieras autorizar. Cada ruta es una carpeta independiente, así que puedes añadir tantas como necesites separándolas por comas. En Windows usa doble barra invertida (\\) porque la barra simple es carácter de escape en JSON; en Mac y Linux las rutas POSIX con barras normales no dan problema.

El cuarto paso, reiniciar Claude Desktop por completo, es donde se pierden muchas instalaciones. Cerrar la ventana no es suficiente: en Mac la aplicación sigue viva en la barra de menús superior y en Windows queda en la bandeja del sistema. Hay que salir del todo (Cmd+Q en Mac, clic derecho y salir en Windows) y volver a abrirla. Solo así el cliente vuelve a leer la configuración y arranca los servidores definidos. Cuando lo hace bien aparece un pequeño icono en la caja de mensajes que indica que hay herramientas MCP disponibles.

El quinto paso, probarlo, sirve para confirmar dos cosas a la vez: que el servidor responde y que entiendes el modelo de permisos. Pídele algo concreto que toque las carpetas autorizadas (listar lo que hay, crear una subcarpeta, mover archivos por tipo) y observa cómo Claude pide confirmación antes de cada acción sensible. Esa pausa no es un fallo, es la salvaguarda diseñada del protocolo: tú decides cuándo el modelo puede tocar tu disco.

Por debajo, el flujo es así: Claude Desktop arranca el proceso del servidor con npx, mantiene una conexión local viva mientras la app esté abierta y, cuando el modelo decide que necesita una herramienta, formula una llamada al servidor, recibe el resultado y lo incorpora a su contexto. No hay tráfico hacia los servidores de Anthropic con tus archivos completos; lo que viaja es la respuesta concreta que el servidor MCP devuelve, ya filtrada.

Cómo saber que cada parte funciona

Hay tres señales claras de que la cadena está sana. La primera es visual: en la caja de mensajes de Claude Desktop aparece el indicador de MCP con el número de herramientas cargadas. Si no sale nada, el servidor no arrancó. La segunda es funcional: al pedirle un listado de tu carpeta autorizada, Claude responde con nombres reales y, antes, te muestra el permiso a aprobar. La tercera es operativa: cuando le encargas una tarea de organización, los cambios aparecen en el Finder o el Explorador en tiempo real. Si alguna de las tres falla, vuelve al paso del JSON y del reinicio.

Una verificación extra útil es revisar los logs de Claude Desktop. En el menú de configuración, dentro de Developer, hay acceso a los registros del cliente: ahí se imprimen los errores de arranque de cada servidor MCP. Si algo no carga, suele aparecer una pista textual sobre qué falló (paquete no encontrado, ruta inválida, JSON mal formado).

Errores frecuentes y cómo salir de ellos

• node --version no devuelve nada. No tienes Node instalado o no está en el PATH. Instala la versión LTS desde nodejs.org, cierra y vuelve a abrir la terminal y prueba otra vez.
• No aparece el indicador de MCP tras reiniciar. No cerraste la aplicación de verdad. En Mac usa Cmd+Q y verifica que no quede el icono en la barra superior; en Windows revisa la bandeja del sistema antes de relanzar.
• El JSON da error de sintaxis. Casi siempre es una coma sobrante después del último elemento o comillas tipográficas que copió mal el navegador. Pega el contenido en un validador de JSON online o pídele al propio Claude que te lo revise.
• Claude responde que no encuentra la ruta. Comprueba que reemplazaste usuario por tu nombre real, que las mayúsculas coinciden y que en Windows usaste doble barra invertida en cada separador de carpeta.
• Pide permiso antes de cada operación y resulta pesado. Es intencional. Para tareas largas, agrupa varias acciones en un mismo pedido para reducir el número de permisos individuales.
• El primer arranque tarda muchísimo. La primera vez npx descarga el paquete del servidor. Es normal; los arranques siguientes son casi instantáneos porque queda cacheado.

Variaciones útiles

El mismo patrón sirve para servidores muy distintos. Si trabajas con repositorios, añade el servidor de GitHub en el mismo bloque mcpServers para que Claude lea issues, revise PRs y consulte commits sin salir del chat. Si necesitas buscar en la web, suma un servidor de búsqueda y combínalo con tus archivos locales para enriquecer informes. Si tu día gira alrededor de notas, el de Obsidian te deja convertir la bóveda en memoria viva del agente.

Para entornos compartidos (un equipo pequeño, una agencia) conviene mantener un archivo de configuración versionado en un repositorio interno con los servidores acordados, e instalarlo en cada máquina nueva como parte del onboarding. Así todos arrancan con el mismo set de capacidades y se evita el caos de configuraciones individuales que nadie documenta.

Siguiente paso

Cuando este flujo te resulte natural, da el salto a Claude Code y replica los mismos servidores con la enseñanza equipar-claude-code-skills-mcps. Para entender de raíz qué es MCP y por qué importa, pasa por que-es-mcp, y para profundizar en servidores concretos tienes fichas como filesystem, github y obsidian.