Cómo Configurar Servidores MCP en Claude Code, Claude Desktop y Cursor

Los servidores MCP amplían lo que las herramientas AI pueden hacer — dándoles acceso a archivos, bases de datos, GitHub y más. El proceso de configuración varía ligeramente entre herramientas, y la documentación puede estar dispersa.

Esta guía lo cubre todo en un solo lugar: cómo configurar servidores MCP en Claude Desktop, Claude Code, Cursor, Windsurf y ChatGPT Desktop, más los problemas más comunes con los que te vas a encontrar.

---

Lo Que Necesitas

• Node.js 18 o superior (comprueba: node --version)
• La herramienta AI que estás configurando (Claude Desktop, Claude Code, Cursor, etc.)
• Unos 10 minutos

La mayoría de servidores MCP se distribuyen como paquetes npm y se ejecutan con npx. No necesitas instalarlos globalmente — npx lo gestiona automáticamente.

---

Configuración de Claude Desktop

Claude Desktop usa un archivo de configuración JSON que lista todos tus servidores MCP.

Paso 1: Encuentra el archivo de configuración

SO	Ruta
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

Si el archivo no existe, créalo.

Paso 2: Añade tus servidores

Aquí hay un ejemplo completo con tres servidores — acceso a filesystem, GitHub y Planu para gestión de specs:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_tu_token_aqui"
      }
    },
    "planu": {
      "command": "npx",
      "args": ["--prefer-online", "-y", "@planu/cli@latest"]
    }
  }
}

Paso 3: Reinicia Claude Desktop

Después de guardar el archivo de configuración, cierra Claude Desktop completamente y vuelve a abrirlo. Verás un icono de martillo en la parte inferior de la interfaz de chat cuando los servidores MCP estén activos.

Verificar la conexión

Escribe "lista las herramientas disponibles" en una nueva conversación de Claude Desktop. Claude describirá qué herramientas están disponibles desde tus servidores MCP.

---

Configuración de Claude Code (Recomendado)

Claude Code tiene la configuración MCP más sencilla — un solo comando.

Añadir un servidor:

claude mcp add planu -- npx -y @planu/cli@latest

Sintaxis general:

claude mcp add <nombre> -- <comando> [args...]

Listar servidores configurados:

claude mcp list

Eliminar un servidor:

claude mcp remove <nombre>

Añadir un servidor con variables de entorno:

claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_tu_token -- npx -y @modelcontextprotocol/server-github

Claude Code guarda la configuración MCP en ~/.claude/config.json. Los comandos claude mcp son la forma recomendada de editar esto — no edites el JSON directamente a menos que sepas lo que haces.

Configuración MCP a nivel de proyecto

Claude Code también soporta servidores MCP a nivel de proyecto mediante un archivo .mcp.json en la raíz de tu proyecto. Esto es útil para servidores específicos de un proyecto (como una conexión a base de datos):

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

Haz commit de este archivo en tu repo para que todo el equipo tenga la misma configuración de servidores.

---

Configuración de Cursor

Cursor gestiona los servidores MCP a través de su UI de settings o un archivo de configuración.

Opción A: A través de la configuración de Cursor

1. Abre Cursor → Settings → Features → MCP
2. Haz clic en "Add New MCP Server"
3. Introduce el nombre y el comando del servidor
4. Haz clic en Save y reinicia Cursor

Opción B: Archivo de configuración

Cursor lee desde ~/.cursor/mcp.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tu/ruta/de/proyecto"]
    },
    "planu": {
      "command": "npx",
      "args": ["--prefer-online", "-y", "@planu/cli@latest"]
    }
  }
}

Después de guardar, reinicia Cursor. El indicador MCP en la barra de estado muestra cuántos servidores están conectados.

Modo Agent requerido en Cursor

Las herramientas MCP solo están disponibles cuando usas el modo Agent de Cursor (antes llamado Composer). No funcionan en el chat normal ni en los modos de edición inline.

---

Configuración de Windsurf

Windsurf (de Codeium) usa un enfoque similar de configuración JSON.

Ubicación del archivo de configuración: ~/.windsurf/mcp_config.json

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "tu_api_key"
      }
    },
    "planu": {
      "command": "npx",
      "args": ["--prefer-online", "-y", "@planu/cli@latest"]
    }
  }
}

Reinicia Windsurf después de guardar. Los servidores MCP son accesibles desde el panel del agente Cascade.

---

Configuración de ChatGPT Desktop

ChatGPT Desktop (OpenAI) añadió soporte MCP a principios de 2026. La configuración se gestiona a través de la configuración de la app.

Archivo de configuración: ~/Library/Application Support/ChatGPT/mcp_config.json (macOS)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tu/ruta/de/proyecto"]
    }
  }
}

Ve a ChatGPT Desktop → Settings → Advanced → MCP Servers para gestionar las configuraciones a través de la UI.

---

Solución de Problemas Frecuentes

"Server failed to start" o no aparecen herramientas

1. Comprueba que Node.js está instalado: node --version (necesita 18+)
2. Intenta ejecutar el servidor manualmente para ver el error:

   npx -y @planu/cli@latest

3. Comprueba que npx está en tu PATH. Si instalaste Node vía nvm, asegúrate de que el shell que lanza tu herramienta AI usa el mismo PATH.

Las herramientas aparecen pero no funcionan

• Las variables de entorno pueden no estar definidas. En Claude Desktop, deben estar en el bloque env dentro de mcpServers, no como variables de entorno del sistema.
• Las rutas de archivo deben ser absolutas. ~/projects no funciona — usa /workspace/projects.

npx es lento en la primera ejecución

La primera vez que ejecutas un servidor MCP con npx -y, descarga el paquete. Los arranques posteriores son rápidos. Si el tiempo de arranque es una preocupación, instala el paquete globalmente:

npm install -g @planu/cli

Luego usa planu como comando en lugar de npx -y @planu/cli@latest.

Errores de permisos en macOS

Algunos servidores MCP requieren permisos de filesystem. Ve a Ajustes del Sistema → Privacidad y Seguridad → Archivos y Carpetas, y asegúrate de que tu herramienta AI (Claude Desktop, Cursor, etc.) tiene acceso a los directorios que necesita tu servidor MCP.

---

Referencia Rápida

Herramienta	Archivo de configuración	Notas
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json	Reiniciar app después de cambios
Claude Code	~/.claude/config.json (usa claude mcp add)	Soporta .mcp.json a nivel de proyecto
Cursor	~/.cursor/mcp.json	Modo Agent requerido
Windsurf	~/.windsurf/mcp_config.json	Panel del agente Cascade
ChatGPT Desktop	~/Library/Application Support/ChatGPT/mcp_config.json	Ruta macOS

---

Próximos Pasos

Ahora que tus servidores MCP están funcionando:

• Los 10 Mejores Servidores MCP para Desarrolladores en 2026 — qué servidores merece la pena instalar
• Primeros Pasos con Planu — configura la gestión de specs para tu flujo AI
• Guía de Flujo de Trabajo SDD — cómo estructurar el trabajo entre sesiones