Conectar un agente IA con MCP: proyecto AF

En este tercer proyecto del Laboratorio AF vamos a conectar un agente IA con MCP para trabajar con archivos locales de un ordenador Windows. Utilizamos Claude Desktop con el plan gratuito y un servidor MCP de archivos, configurado para acceder a una carpeta específica de pruebas.

Documentamos la instalación, la configuración de la conexión y seis pruebas prácticas de consulta, lectura y escritura. Comprobamos también el rechazo de una ruta fuera de la carpeta autorizada y revisamos directamente los archivos creados. El alcance de esta experiencia es una conexión MCP local; no configuramos una API independiente ni conectamos servicios externos en la nube.

1. Qué vamos a conectar y para qué sirve

Conectamos Claude Desktop con una carpeta de archivos locales mediante MCP, un protocolo que permite a una aplicación de IA utilizar herramientas proporcionadas por un servidor.

En nuestra configuración intervienen tres elementos:

• Claude Desktop: recibe nuestras instrucciones y solicita el uso de las herramientas.
• El servidor MCP de archivos: ofrece funciones para consultar carpetas, leer documentos y crear o modificar archivos.
• La carpeta de pruebas: contiene los archivos utilizados y delimita el acceso configurado para el servidor.

Esta conexión permite pedir al asistente que lea un archivo y resuma su contenido sin adjuntarlo manualmente al chat. También permite crear un documento en la carpeta autorizada, como comprobamos durante las pruebas.

Llamamos «archivos-af» a la conexión para identificarla dentro de Claude. El servidor dispone de herramientas de lectura y escritura: la configuración utilizada no es de solo lectura.

2. Herramientas utilizadas para conectar el agente IA con MCP

Para realizar esta conexión utilizamos:

• Un ordenador con Windows: donde instalamos la aplicación y guardamos los archivos de prueba.
• Claude Desktop con el plan gratuito: desde el que enviamos las peticiones y utilizamos la conexión.
• Node.js: necesario para ejecutar el servidor elegido. Tras instalarlo, comprobamos su disponibilidad con el comando node --version.
• El servidor @modelcontextprotocol/server-filesystem: proporciona las herramientas de acceso a archivos mediante MCP.
• Una carpeta llamada LaboratorioAF-Pruebas: creada específicamente para esta experiencia.
• El Bloc de notas y el Explorador de archivos: para preparar los textos y comprobar directamente los resultados.

La conexión se configuró en el archivo claude_desktop_config.json, conservando los ajustes que ya existían.

Realizamos pruebas con textos pequeños y respuestas breves para reducir el consumo del plan gratuito. No medimos los tokens utilizados ni evaluamos sus límites de uso.

3. Cómo configuramos la conexión MCP en Windows

Instalamos Claude Desktop e iniciamos sesión con una cuenta gratuita. Después accedimos a Configuración → Desarrollador → Editar configuración para localizar el archivo claude_desktop_config.json.

Antes de añadir el servidor, comprobamos si Node.js estaba disponible mediante este comando:

node --version

Windows no reconocía el comando. Instalamos Node.js y repetimos la comprobación en una ventana nueva hasta obtener una versión.

A continuación, creamos la carpeta LaboratorioAF-Pruebas dentro de nuestra carpeta de usuario y añadimos la sección mcpServers a la configuración de Claude, conservando los ajustes existentes.

El siguiente fragmento muestra la sección añadida. La ruta es un ejemplo: debe sustituirse por la ubicación real de la carpeta de pruebas de cada ordenador.

"mcpServers": {
  "archivos-af": {
    "command": "cmd",
    "args": [
      "/c",
      "npx",
      "-y",
      "@modelcontextprotocol/server-filesystem",
      "C:\\Users\\TU_USUARIO\\LaboratorioAF-Pruebas"
    ]
  }
}

Este fragmento debe integrarse dentro del objeto principal del archivo JSON, utilizando las comas necesarias para separarlo de otras secciones.

Tras guardar, tuvimos que cerrar Claude por completo y volver a abrirlo. Cuando la conexión «archivos-af» apareció en ejecución, comenzamos las pruebas.

Puedes consultar la documentación oficial de MCP sobre conexiones a servidores locales, que explica la configuración de Claude Desktop y un servidor de archivos.

4. Pruebas de funcionamiento de la conexión MCP

Realizamos seis pruebas con archivos de texto pequeños. Combinamos las respuestas de Claude con comprobaciones directas en el Explorador de archivos y el Bloc de notas.

La última prueba evaluó el cumplimiento de la instrucción de no modificar un archivo. No demuestra una protección técnica contra sobrescrituras. Del mismo modo, el rechazo de acceso se comprobó para una ruta concreta, sin realizar una auditoría completa del servidor.

5. Resultados de conectar un agente IA con MCP

La conexión «archivos-af» permitió utilizar herramientas sobre archivos locales desde Claude Desktop. Pudimos consultar la carpeta autorizada, leer unas notas y crear un archivo cuyo contenido comprobamos directamente en Windows.

Las pruebas también mostraron dos respuestas útiles: ante un archivo inexistente, Claude comunicó el error sin inventar su contenido; al intentar acceder a una ruta fuera de la carpeta configurada, el servidor rechazó la lectura.

Durante la instalación encontramos dos dificultades: Node.js no estaba disponible inicialmente y la conexión no apareció hasta cerrar Claude por completo y volver a abrirlo. Documentar estos pasos forma parte del resultado práctico del proyecto.

En la primera consulta observamos una solicitud de permiso para utilizar la herramienta y elegimos «Permitir una vez». No registramos con el mismo detalle las autorizaciones de todas las operaciones posteriores, por lo que no afirmamos que cada acción solicitara una confirmación nueva.

La experiencia demuestra una conexión MCP local funcionando en las condiciones probadas, con lectura y escritura en una carpeta específica. No evaluamos otros servidores, conexiones mediante APIs independientes ni automatizaciones sin intervención del usuario.

6. Limitaciones y precauciones de la conexión MCP

Conectar un agente IA con MCP amplía sus posibilidades de actuación. En esta experiencia, el servidor proporcionaba herramientas de lectura y escritura, por lo que debíamos revisar tanto las peticiones como sus resultados.

Estas son las principales limitaciones y precauciones:

• Acceso a una carpeta específica: utilizamos un directorio de pruebas, sin autorizar toda la carpeta personal ni el disco completo.
• Posibilidad de modificar archivos: pedir que no se modifique un documento es una instrucción al asistente, no un bloqueo técnico de escritura.
• Pruebas reducidas: trabajamos con textos pequeños. No evaluamos documentos extensos, archivos PDF, imágenes ni grandes cantidades de archivos.
• Privacidad: que el servidor se ejecute en el PC no significa que toda la conversación y el procesamiento de la IA sean locales. Deben revisarse las condiciones de la aplicación antes de utilizar información confidencial.
• Consumo sin medir: completamos las pruebas con el plan gratuito, pero no registramos los tokens ni podemos garantizar la misma disponibilidad en otras cuentas o fechas.

Como siguiente mejora, podríamos evaluar una configuración con permisos de solo lectura y registrar con más detalle las llamadas a herramientas y sus autorizaciones.

Las comprobaciones realizadas muestran el funcionamiento en nuestro caso. No constituyen una auditoría de seguridad ni garantizan que cualquier petición se ejecute correctamente.

7. Conclusión del proyecto de conexión MCP

Este proyecto nos ha permitido conectar un agente IA con MCP y comprobar cómo utiliza herramientas para trabajar con archivos locales desde Claude Desktop en Windows.

La experiencia incluyó la instalación, la configuración del servidor y seis pruebas prácticas. Verificamos directamente el contenido del archivo creado y su conservación posterior. También observamos el rechazo de una lectura fuera de la carpeta autorizada.

El aprendizaje principal es que una conexión debe evaluarse mediante acciones y resultados comprobables. Que el servidor aparezca en ejecución es el primer paso; después hay que revisar qué herramientas utiliza, a qué rutas accede y qué cambios realiza.

Esta primera versión queda como base para explorar otras conexiones. El alcance documentado es un servidor MCP local de archivos, utilizado bajo petición y con supervisión humana.

Este proyecto forma parte del Laboratorio de Agentes IA, donde documentamos la construcción de asistentes, las pruebas realizadas y los resultados observados.

Preguntas frecuentes sobre conectar un agente IA con MCP