Cómo instalar un servidor MCP en Claude Desktop (Windows, macOS y Linux)

Activar tu primer servidor MCP en Claude Desktop toma menos de 5 minutos. Esta guía cubre Windows, macOS y Linux con ejemplos reales para Filesystem, GitHub y Brave Search.

Requisitos previos

  • Claude Desktop (descarga desde claude.ai/download).
  • Node.js 20+ (para servidores que usan npx) y/o uv (para servidores Python).
  • Una API key si el servidor lo requiere (GitHub, Brave, Slack, etc.).

Localizar el archivo de configuración

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

Configuración básica con 3 servidores

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/tuusuario/proyectos"]
    },
    "github": {
      "command": "docker",
      "args": ["run","-i","--rm","-e","GITHUB_PERSONAL_ACCESS_TOKEN","ghcr.io/github/github-mcp-server"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" }
    },
    "brave": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "tu_api_key_brave" }
    }
  }
}

Verificación

  1. Cierra completamente Claude Desktop (en macOS, Cmd+Q; en Windows, desde la bandeja del sistema).
  2. Vuelve a abrirlo. Verás un ícono 🔌 abajo del prompt.
  3. Haz click en el ícono y comprueba que aparecen los servers en verde.
  4. Pregunta a Claude: “Lista los archivos de mi proyecto”. Debería usar filesystem.

Troubleshooting

  • “Server failed to start”: el comando no existe. Instala Node con brew install node o uv con curl -LsSf https://astral.sh/uv/install.sh | sh.
  • El servidor aparece pero no responde: revisa los logs en ~/Library/Logs/Claude/mcp-*.log (macOS) o %APPDATA%ClaudeLogs (Windows).
  • JSON inválido: usa jq o jsonlint.com para validar antes de guardar.

Siguientes pasos