Windows MCP — Instalar & Demo en vivo

Name: Windows MCP MCP Server
Author: CursorTouch

Por qué usarlo

Características clave

Acceso al árbol UI Automation — estructurado, no solo píxeles
Screenshot + click + type + combinaciones de teclas
Enumeración y foco de ventanas
Lanzamiento y cierre de procesos
Lectura/escritura del portapapeles
Compatible con Windows 10/11; no requiere derechos de administrador para la mayoría de apps

Demo en vivo

Cómo se ve en la práctica

windows-mcp-cursortouch.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "windows-mcp-cursortouch",
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "windows-mcp-cursortouch": {
      "command": {
        "path": "uvx",
        "args": [
          "windows-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add windows-mcp-cursortouch -- uvx windows-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Windows MCP

Automatizar una app LOB solo para Windows que no tiene API

👤 Ingenieros RPA cansados de las licencias de UiPath ⏱ ~60 min advanced

Cuándo usarlo: El proveedor de la app interna no expondrá una API; necesitas que Claude introduzca datos diariamente.

Requisitos previos

Windows 10/11 con la app de destino instalada — Instalación estándar
Python 3.10+ para uvx — winget install Python.Python.3.12

Flujo

Inspeccionar el árbol UI

Lanza la app BookingSystem.exe, luego vuelca el árbol UI de la ventana principal. Quiero ver los IDs de automatización.✓ Copiado

→ El árbol muestra controles con AutomationId — no solo botones sin nombre
Ejecutar el flujo principal una vez

Ahora: abre el diálogo Nueva Reserva, rellena cliente 'Acme Inc', fecha 2026-05-12, guarda. Toma una captura de pantalla al final.✓ Copiado

→ Reserva guardada; la captura de pantalla confirma
Generalizar y repetir

Lee /work/bookings.csv. Para cada fila, repite el flujo de reserva. Guarda capturas de pantalla en /work/runs/.✓ Copiado

→ Cada fila procesada; capturas de pantalla por reserva

Resultado: Automatización headless de una app de proveedor, reproducible desde un CSV.

Errores comunes

La app usa controles personalizados (p. ej. WinForms ListView sin AutomationId) — Recurre a clics por coordenadas en una posición fija de ventana; documenta la fragilidad
Un diálogo modal roba el foco en mitad del bucle — Siempre verifica la ventana activa antes de send_keys; aborta si es inesperada

Combinar con: filesystem

Extraer datos de Excel sin una API de Excel

👤 Analistas donde IT no habilitará COM/Office API ⏱ ~15 min intermediate

Cuándo usarlo: Puedes abrir Excel pero no hacerlo programáticamente.

Flujo

Abrir el archivo

Lanza Excel, abre C:\reports\Q2.xlsx, enfoca la hoja 'Sales'.✓ Copiado

→ El título de la ventana muestra el nombre del archivo
Copiar el rango

Selecciona A1:D200, copia al portapapeles, luego lee el texto del portapapeles.✓ Copiado

→ Tabla separada por tabulaciones devuelta
Guardar como CSV via filesystem

Parsea eso en filas y guarda en /tmp/Q2-sales.csv.✓ Copiado

→ CSV creado

Resultado: Datos de Excel en formato CSV sin tocar la API COM ni instalar paquetes de terceros.

Errores comunes

Los formatos del portapapeles varían entre versiones de Excel — Prueba CSV primero; cae en TSV via variantes del portapapeles

Combinar con: filesystem

Capturar un bug de escritorio para un compañero mientras estás concentrado

👤 Devs gestionando soporte ⏱ ~5 min beginner

Cuándo usarlo: Un fallo se reproduce en tu máquina Windows y quieres una captura limpia + instrucciones de repro.

Flujo

Reproducir y capturar

Toma una captura de pantalla de la ventana de la app activa. Guarda como bug.png.✓ Copiado

→ PNG escrito
Anotar pasos

Lista los últimos 5 elementos UI visibles con los que interactuaste — títulos de ventana, etiquetas de diálogo — para que pueda pegarlo en el ticket.✓ Copiado

→ Pasos de repro a nivel de elemento concretos

Resultado: Ticket de bug bien acotado sin alt-tab.

Errores comunes

La captura incluye información privada — Recorta solo la ventana activa, no el escritorio completo

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

windows-mcp-cursortouch + filesystem

Manejar una app de escritorio desde un CSV de entrada

Lee /work/orders.csv. Para cada fila, haz clic en la app de reservas.✓ Copiado

windows-mcp-cursortouch + github

Capturar un bug de escritorio y abrir un issue

Captura de pantalla de la ventana activa, luego crea un issue en GitHub con el PNG y los pasos para reproducirlo.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_windows	(ninguno)	Encontrar la app de destino	gratis
get_ui_tree	window_id?	Descubrimiento antes de hacer clic	gratis
click	automation_id \| x,y	Hacer clic en un control conocido	gratis
type_text	text: str	Introducir texto en el campo enfocado	gratis
send_keys	keys: str (p. ej. 'ctrl+s')	Hotkeys / modificadores	gratis
screenshot	window_id?, region?	Confirmación visual	gratis
launch_process	exe: str	Iniciar la app de destino	gratis
read_clipboard	(ninguno)	Después de copiar	gratis

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna — automatización local
Tokens por llamada: 50–500 (los volcados del árbol UI pueden ser más grandes)
Monetario: OSS gratuito
Consejo: Evita volcar el árbol UI completo en cada paso — acota por window_id

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: control de la sesión de escritorio local

Almacenamiento de credenciales: Ninguno — pero Claude puede ver lo que hay en pantalla

Salida de datos: Local; nada sale de la máquina a menos que también concedas un MCP de red

No conceder nunca: auto-lanzamiento de cuenta de administrador emparejamiento de acceso remoto

No ejecutes en una máquina dev con credenciales sensibles abiertas en pestañas del navegador — las capturas pueden capturarlas
Siempre previsualiza el árbol UI antes de emitir clics; valida la ventana de destino antes de send_keys

Resolución de problemas

Errores comunes y soluciones

Control no encontrado por automation_id

La app usa IDs dinámicos o sin IDs. Usa get_ui_tree y busca por jerarquía de nombre/rol

Verificar: Inspecciona con Microsoft inspect.exe

Los clics caen en la ventana incorrecta

Siempre llama set_focus en la ventana de destino antes de click; comprueba la ventana activa después

La instalación de uvx falla con error 'wheel'

Instala Visual C++ Build Tools; algunas dependencias de pywin32 las requieren

Alternativas

Windows MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
Anthropic Computer Use (píxeles)	Necesitas control basado en píxeles multiplataforma	Menos fiable en Windows que UIA; más frágil ante cambios de layout
AutoIt / PowerShell	Haces scripting fuera de un LLM	Sin capa de agente; solo scripting manual
Peekaboo (macOS)	Estás en macOS, no en Windows	Sistema operativo diferente; no intercambiable

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills