Tutorial

Cómo configurar servidores MCP en Windows

La mayoría de las guías para configurar MCP dan por hecho un Mac y un archivo JSON. Esta es para Windows, con Conduit, una aplicación de escritorio de IA gratuita y de código abierto, como cliente: qué instalar, qué escribir en cada campo y qué significan los errores cuando un servidor no arranca.

Introducción

El Model Context Protocol (MCP) permite a una aplicación de IA usar herramientas de otros programas: leer y escribir archivos, buscar en documentación, consultar una base de datos, abrir incidencias. Cada conjunto de herramientas viene de un servidor MCP. Un servidor local es un programa que la aplicación inicia en tu ordenador, normalmente con npx (Node.js) o uvx (Python). Un servidor remoto se ejecuta en otro sitio y se alcanza por URL.

En Windows, los servidores locales fallan por unos pocos motivos previsibles: el entorno de ejecución no está instalado o no está en el PATH, la aplicación intenta ejecutar un script de shell como si fuera un programa, o la ruta de una carpeta contiene un espacio. Este tutorial evita cada uno de ellos.

Instalarás Node.js y uv, añadirás el servidor oficial Filesystem con npx y el servidor Fetch con uvx, y añadirás Microsoft Learn, un servidor remoto para la documentación de Microsoft. Después los usarás desde un chat, aprobarás una herramienta que cambia un archivo y verás cómo es un servidor que no arranca y cómo se arregla. En Conduit, los servidores MCP se llaman conectores.

Puntos clave

Requisitos previos

Para seguir este tutorial necesitarás:

Paso 1: instalar Node.js y uv

La mayoría de los servidores MCP locales son paquetes de Node.js, que se inician con npx, o paquetes de Python, que se inician con uvx. En este paso instalarás los dos entornos de ejecución.

Abre PowerShell y ejecuta:

winget install OpenJS.NodeJS.LTS
winget install astral-sh.uv

uv descarga la versión de Python que necesita cada servidor, así que no tienes que instalar Python por separado. Cierra PowerShell, abre una ventana nueva y comprueba que se encuentran los dos:

npx --version
uvx --version

Cada uno imprime un número de versión. Si PowerShell dice que no reconoce el comando, cierra la sesión de Windows y vuelve a iniciarla, para que se aplique el nuevo PATH, e inténtalo de nuevo.

Por último, cierra Conduit y ábrelo otra vez, también desde la bandeja si sigue ejecutándose ahí. Un programa ve el PATH con el que se inició, así que un Conduit que estaba abierto durante las instalaciones todavía no encuentra npx ni uvx.

A continuación añadirás el primer servidor.

Paso 2: añadir un servidor local con npx

El servidor Filesystem da al asistente herramientas para listar, leer, buscar y escribir archivos, pero solo dentro de las carpetas que nombres. En este paso lo añadirás para una carpeta.

Elige Contexto en la barra lateral, después Conectores arriba y luego Añadir conector. El panel tiene tres formas de añadir un servidor: Registro oficial de MCP, Servidor remoto por URL y Comando local. En Comando local, rellena:

  1. Nombre del conector: Filesystem.
  2. Comando: npx.
  3. Argumentos: -y @modelcontextprotocol/server-filesystem C:\Users\Public\Documents\Northwind, con tu propia carpeta al final. -y deja que npx descargue el paquete sin preguntar.

Deja Env vacío; este servidor no necesita claves. Elige Añadir conector local. El conector aparece en la lista como detenido. Elige Iniciar.

El primer inicio tarda un poco más mientras npx descarga el paquete. Después el estado cambia a activo y se enumeran las herramientas del servidor, cada una marcada con lo que hace:

Las herramientas Solo lee se ejecutan sin preguntar. Las herramientas Hace cambios, pregunta antes piden tu aprobación cada vez, hasta que le dices a Conduit que la recuerde. Conduit toma estas etiquetas de lo que el servidor declara sobre cada herramienta.

Conduit inicia el servidor sin ventana de consola. El comando se ejecuta directamente, nunca a través de un shell, y por eso npx funciona aquí sin cmd /c: Conduit busca el nombre en el PATH por sí mismo y encuentra npx.cmd.

A continuación añadirás un servidor de Python.

Paso 3: añadir un servidor local con uvx

Los servidores de Python funcionan igual, con uvx como comando. En este paso añadirás el servidor Fetch, que descarga una página web y la convierte en Markdown.

Elige Añadir conector otra vez. En Comando local, escribe Fetch como nombre, uvx como comando y mcp-server-fetch como argumentos:

Elige Añadir conector local y después Iniciar. El primer inicio descarga el servidor y sus paquetes de Python, lo que tarda unos segundos, y el conector pasa a activo con una herramienta, fetch.

Nota: Conduit ya tiene su propia búsqueda web y lectura de páginas. Fetch está aquí como ejemplo de servidor de Python; cualquier servidor publicado para uvx se añade de la misma forma.

A continuación añadirás un servidor que se ejecuta en remoto.

Paso 4: añadir un servidor remoto

Un servidor remoto no necesita nada instalado. En este paso añadirás Microsoft Learn, el servidor oficial de Microsoft para buscar en su documentación, que no necesita cuenta.

Puedes encontrar servidores remotos en el registro oficial de MCP. En Añadir conector, escribe una palabra en Registro oficial de MCP y elige Buscar:

Instalar añade un servidor de la lista. El registro está abierto a cualquiera, así que comprueba quién publica un servidor antes de instalarlo. Si conoces la dirección del servidor, puedes añadirlo directamente. En Servidor remoto por URL, escribe Microsoft Learn como nombre y https://learn.microsoft.com/api/mcp como URL:

Elige Añadir conector remoto y después Iniciar. El conector pasa a activo con tres herramientas para buscar en la documentación, encontrar ejemplos de código y leer una página, todas marcadas Solo lee.

Un servidor remoto que necesita una cuenta muestra iniciar sesión en lugar de arrancar. Elige Iniciar sesión en el conector, termina de iniciar sesión en tu navegador y Conduit guarda el acceso que se le dio.

A continuación usarás los servidores en un chat.

Paso 5: usar los servidores en un chat

En este paso harás una pregunta que responde un conector y después pedirás un cambio que necesita tu aprobación.

Elige Chats y Nuevo chat. Conduit le da al modelo una forma de buscar las herramientas de los conectores cuando las necesita, así que no tienes que activar nada. La forma más fiable de conseguir que se use un servidor concreto es nombrarlo. Envía:

Usa el conector Microsoft Learn: ¿cómo compruebo qué versión de PowerShell tengo
y cómo la actualizo en Windows 11? Incluye los enlaces de las páginas que uses.

Cada llamada a una herramienta es una línea de la respuesta, con el conector y el nombre de la herramienta, lo que se pidió y cuánto tardó. Haz clic en una para ver exactamente qué se envió y qué volvió. Las búsquedas solo leen, así que se ejecutaron sin preguntar.

Ahora pide algo que cambie un archivo. En un chat nuevo, envía:

Usa el conector Filesystem: enumera los archivos de C:\Users\Public\Documents\Northwind
y después crea ahí un archivo llamado reading-list.md que enumere cada PDF con una
descripción de una línea de lo que probablemente trata, a partir de su nombre.

Listar la carpeta solo lee, así que se ejecuta. Escribir el archivo se detiene y te espera:

El aviso muestra la herramienta, la descripción que da de ella el propio servidor y los datos que se van a enviar, incluidos la ruta y el contenido que se va a escribir. Denegar lo detiene. Marca Recordar para este chat para que esta herramienta pueda volver a ejecutarse en este chat sin preguntar, o Permitir siempre esta herramienta para todos los chats, y después elige Aprobar y ejecutar.

El archivo ya está en la carpeta. Para revisar o retirar más adelante una aprobación recordada, abre el conector en la página Conectores y usa Olvidar en Aprobaciones de herramientas recordadas.

Paso 6: arreglar un servidor que no arranca

En este paso verás cómo es un servidor que falla y cómo averiguar por qué.

Un servidor que termina en cuanto arranca aparece como caído, con el motivo que vio Conduit:

connector stdout closed (child exited) significa que el servidor arrancó y después se cerró, normalmente con un error que imprimió. Para ver ese error, ejecuta el mismo comando con los mismos argumentos en PowerShell. Para el conector anterior:

npx -y @modelcontextprotocol/server-filesystem C:\Users\Public\Shared Files
Warning: Cannot access directory C:\Users\Public\Shared, skipping
Error: None of the specified directories are accessible

La ruta contiene un espacio, así que llegó como dos argumentos, C:\Users\Public\Shared y Files, y ninguno es una carpeta. Las causas que más encuentran los usuarios de Windows:

Lo que ves Causa Solución
spawn 'npx' failed Node.js no está instalado, o Conduit se inició antes de instalarlo. Instálalo (paso 1), cierra Conduit por completo y ábrelo otra vez.
El comando se rechaza El comando es un shell, como cmd, powershell o wsl. Conduit no ejecuta comandos a través de un shell. Pon el programa en sí en Comando: npx, uvx, node, python o la ruta completa de un .exe.
caído con un argumento de carpeta La ruta contiene un espacio. Los Argumentos se separan en cada espacio. Usa una carpeta cuya ruta no tenga espacios, como C:\Users\Public\Documents\Projects.
caído en un servidor que necesita una clave Falta la clave. Añádela a Env como una línea KEY=VALUE, con el nombre de variable de la documentación del servidor.

Para cambiar el comando o los argumentos de un conector, añádelo otra vez con los valores nuevos, abre después el antiguo y elige Revocar, lo que lo detiene y desactiva sus herramientas.

Preguntas

¿Necesito Node.js y Python para usar servidores MCP?

Solo para los servidores locales escritos en ellos. Un servidor que se inicia con npx necesita Node.js, y uno que se inicia con uvx necesita uv, que descarga su propio Python. Los servidores remotos, añadidos por URL o desde el registro, se ejecutan en otro sitio y no necesitan nada instalado. Conduit en sí no necesita ninguno de los dos.

¿Puedo reutilizar mi configuración MCP de Claude Desktop?

No importando el archivo, pero sirven los mismos valores. Para cada servidor de claude_desktop_config.json, pon command en Comando, los elementos de args en Argumentos separados por espacios, y cada entrada de env como una línea KEY=VALUE en Env.

¿Puedo añadir un servidor remoto que necesite una clave de API?

Solo si inicia sesión con OAuth. Conduit inicia sesión en los servidores remotos con OAuth a través de tu navegador, con el botón Iniciar sesión del conector, y todavía no tiene un campo para una cabecera con clave de API. Un servidor que también se ejecuta en local suele recibir su clave como variable de entorno, que puedes definir en Env.

¿Un servidor MCP se ejecuta con mis permisos?

Sí. Un servidor local es un programa de tu ordenador y puede hacer todo lo que puede hacer tu cuenta de Windows, así que añade solo servidores de confianza, de fuentes que conozcas. Conduit pregunta antes de ejecutar cualquier herramienta que cambie algo, pero es el propio servidor el que decide qué hace cada herramienta.

¿Funciona en macOS y Linux?

Sí. La página Conectores es igual en todas las plataformas. Instala Node.js y uv con tu gestor de paquetes en lugar de winget, y usa rutas como /Users/tu-usuario/Documents; el resto del tutorial se aplica tal cual.

Conclusión

En este tutorial instalaste Node.js y uv, añadiste un servidor MCP local con npx y otro con uvx, añadiste un servidor remoto por URL y desde el registro, los usaste desde un chat, aprobaste una herramienta que escribe un archivo y diagnosticaste un servidor que no arrancaba.

Los mismos tres campos, comando, argumentos y entorno, son todo lo que necesita cualquier servidor local, así que los servidores del registro de MCP y de los README de proyectos se pueden configurar igual. Para ir más lejos, consulta estas guías:

Descargar Conduit

Los datos sobre Conduit corresponden a la última versión y se pueden comprobar en la documentación y el código fuente. ¿Encontraste un error? Avísanos y lo corregiremos.

Relacionados