Cómo configurar un servidor MCP paso a paso (Claude, Cursor, Levante)

Configurar un servidor MCP en 2026 sigue siendo, para muchos clientes, editar un archivo JSON y reiniciar la app. Este artículo te lleva del "qué es esto" al "funciona en mi setup" en los tres clientes MCP más usados: Claude Desktop, Cursor y Levante — con tres casos reales, captura a captura, y errores típicos al final.

Antes de empezar: los 3 tipos de configuración

En casi todos los clientes MCP, la configuración sigue esta lógica:

1. Archivo JSON con entradas en mcpServers.

2. Cada servidor define command, args y opcionalmente env.

3. Reinicio del cliente para cargar la nueva config.

Si entiendes ese patrón, saltar entre clientes es cuestión de saber dónde vive el archivo.

Ejemplo 1: Filesystem en Claude Desktop

Objetivo: dar a Claude acceso de lectura/escritura a tu carpeta de proyectos.

Paso 1 — Abre la config

Menú Claude → Settings → Developer → Edit Config abre:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Paso 2 — Añade el servidor

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/tu-usuario/proyectos"
      ]
    }
  }
}

Cambia la ruta por la que quieras. En Windows escapa backslashes: "C:\\Users\\tu-usuario\\proyectos".

Paso 3 — Reinicia Claude Desktop

Cmd+Q en Mac (no solo minimizar). Alt+F4 en Windows. Reabre.

Paso 4 — Verifica

Icono 🔨 abajo a la derecha del input muestra "5 tools" (read, write, list, create_directory, move).

Pide: "Lista los archivos .md en /Users/tu-usuario/proyectos/notas".

Claude ejecuta y pide confirmación la primera vez.

Detalle completo: Claude Desktop y MCP: configuración paso a paso.

Ejemplo 2: GitHub en Cursor

Objetivo: que Cursor pueda crear issues y buscar en repos de tu GitHub desde el chat.

Paso 1 — Genera token GitHub

Ve a github.com/settings/tokens/new.

• Nota: "Cursor MCP".

• Expiration: 90 días.

• Scopes: repo, read:user, read:org.

• Generate token y copia el ghp_... (solo se muestra una vez).

Paso 2 — Abre config de Cursor

En Cursor: menú Cursor → Settings → MCP (o Ctrl+,). En 2026, Cursor tiene UI propia para añadir servidores MCP, pero también acepta edición directa del archivo.

El archivo vive en:

• Mac: ~/Library/Application Support/Cursor/User/mcp.json

• Windows: %APPDATA%\Cursor\User\mcp.json

Paso 3 — Añade el servidor

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_TU_TOKEN_AQUI"
      }
    }
  }
}

Paso 4 — Recarga MCP

En Cursor: Command Palette (Cmd+Shift+P) → Reload MCP Servers. No hace falta reiniciar toda la app como Claude Desktop.

Paso 5 — Verifica

En el chat de Cursor: "Lista mis repos en GitHub ordenados por estrellas".

Cursor usa la tool y devuelve la lista. Si no: revisa logs en Settings → MCP → View Logs.

Ejemplo 3: Slack en Levante

Objetivo: mandar mensajes y leer canales de Slack desde Levante (Mac/Windows/Linux).

Levante tiene MCP Store visual. La diferencia con Claude Desktop y Cursor: no editas JSON; buscas el servidor en el catálogo y haces clic.

Paso 1 — Abre el MCP Store

En Levante: MCP Store en el sidebar.

Paso 2 — Busca "Slack"

El catálogo muestra:

• Nombre del servidor

• Autor (oficial / comunidad)

• Descripción

• Ratings y descargas

Paso 3 — Instala

Click en Install. Levante:

1. Descarga el servidor.

2. Pide los secretos necesarios (Slack Bot Token, Team ID).

3. Guarda los tokens en el keychain del sistema (no en JSON plano).

4. Lanza el proceso del servidor.

5. Aparece como "conectado" en el sidebar.

Paso 4 — Verifica

En el chat: "Manda 'reunión en 5 min' al canal #equipo-dev de Slack".

Levante ejecuta, muestra el mensaje que va a enviar, te pide confirmación y lo manda.

No hay reinicio de la app. No hay JSON que editar. El trade-off: menos flexibilidad si el servidor que quieres no está en el catálogo — pero el catálogo cubre los ~100 servidores más usados.

Detalle: MCP Store.

Tabla comparativa de los 3 clientes

Ninguno es estrictamente mejor — dependen del caso.

Transports: stdio vs HTTP/SSE

Los servidores MCP soportan tres transports:

• stdio (estándar): el cliente lanza el servidor como proceso local y se comunican por stdin/stdout. Lo más común. Todos los ejemplos arriba son stdio.

• SSE / HTTP streamable (servidor remoto): el servidor corre en otra máquina (o en un contenedor) y el cliente se conecta via HTTP. Útil para:

  • Servidores compartidos entre múltiples usuarios (un MCP central para toda la empresa).

  • Servidores que requieren recursos que no quieres en cada máquina (una BD interna, APIs con IP allowlisting).

Ejemplo stdio (ya visto)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
    }
  }
}

Ejemplo HTTP/SSE

{
  "mcpServers": {
    "mi-servidor-remoto": {
      "url": "https://mcp.miempresa.com/sse",
      "headers": {
        "Authorization": "Bearer tu-token"
      }
    }
  }
}

Claude Desktop, Cursor y Levante soportan los dos transports. Para la mayoría de usos personales, stdio basta.

Troubleshooting común

"0 tools" después de añadir servidor

1. Valida el JSON: jq . tu-config.json. Un coma sobrante rompe todo.

2. Revisa logs: en Claude Help → View Logs, en Cursor panel MCP, en Levante sidebar.

3. Ejecuta el comando manualmente: copia el command + args en terminal. Si falla ahí, es el servidor, no el cliente.

"spawn npx ENOENT"

• Causa: npx no está en el PATH que ve la app.

• Fix: usa ruta absoluta. Encuentra con which npx (suele ser /usr/local/bin/npx o /opt/homebrew/bin/npx).

Servidor Python con uvx no arranca

• Causa: uvx no instalado.

• Fix: instala uv con curl -LsSf https://astral.sh/uv/install.sh | sh.

El servidor arranca pero Claude no usa la tool

• A veces Claude ignora una tool disponible si el prompt no sugiere usarla.

• Fix rápido: menciona la tool en el prompt. "Usa el servidor filesystem para listar...". Después suele usarla sola.

"Too many tools" o latencia alta

• Si cargas 30+ servidores, Claude tarda en decidir qué usar.

• Fix: desinstala los que no uses. Activa solo los que necesitas en cada momento.

Tokens rechazados (GitHub, Slack, Notion)

• Casi siempre: scope insuficiente o token expirado.

• Fix: genera token nuevo con scopes mínimos necesarios documentados en el repo del servidor.

Buenas prácticas

1. Empieza con 3-5 servidores máximo

No instales todo el catálogo de golpe. Filesystem + fetch + GitHub + memory cubren el 80% de casos. Añade más solo cuando tengas necesidad clara.

2. Usa tokens con scope mínimo

Para GitHub, no des admin:org si solo necesitas leer issues. Menos scope = menos exposición si el token se filtra.

3. Rota secretos periódicamente

Al menos cada 90 días. Marca en calendario. Si usas Levante, keychain facilita rotación; en Claude Desktop/Cursor es manual.

4. Documenta tu config

Si compartes setup con un equipo, mantén un repo interno con la config de referencia (sin secretos). Ahorra a cada nuevo miembro el copy-paste manual.

5. Audita servidores antes de instalar

Si es comunidad: mira el repo. Quién lo mantiene. Último commit. Issues abiertos. Si es un servidor de alguien con 2 stars y 6 meses sin actualizar, no lo instales con tokens de producción.

FAQ

¿Puedo usar el mismo servidor MCP desde Claude Desktop y Cursor a la vez?
Sí. El servidor es un proceso independiente. Cada cliente lanza su propia instancia cuando lo necesita. No hay conflicto salvo que el servidor tenga estado compartido (ej: una BD donde ambos escriban).

¿Qué pasa si configuro mal el JSON?
Claude Desktop ignora el archivo roto y no carga ningún servidor (verás ⚠️). Cursor muestra error específico en el panel MCP. Levante al ser UI no expone directamente JSON, así que este problema no aplica.

¿Los cambios en el JSON se aplican sin reiniciar?
Claude Desktop requiere reinicio completo. Cursor tiene reload MCP vía command palette. Levante aplica cambios en caliente.

¿Puedo usar servidores MCP con la API de Claude o Claude Code (CLI)?
Sí. Claude Code tiene su propio sistema de MCP con config parecida. La API permite pasar tools con su schema pero no es exactamente MCP — MCP asume cliente+servidor, la API es call-response.

¿Hay servidores MCP para uso empresarial (gobierno de equipo, audit logs)?
No estándar. Cada cliente lo maneja distinto. Levante tiene política centralizada de servidores MCP aprobados para organización. Claude Desktop y Cursor lo dejan por usuario.

¿Puedo crear mi propio servidor MCP?
Sí. SDKs oficiales en TypeScript, Python, Go, Rust y Java. Un servidor MCP simple son ~50-100 líneas. Empieza por el Everything server como referencia: enseña las 3 primitivas (tools, resources, prompts) en ejemplos mínimos.

¿MCP remoto (HTTP/SSE) es seguro?
Depende de cómo lo configures. Necesitas TLS obligatorio, autenticación (bearer token o OAuth), y allowlisting de orígenes. Para uso interno en empresa con VPN, es razonable; para expuesto a internet, añade capas de seguridad estándar de APIs.

Recapitulando

Configurar un servidor MCP no es difícil — es edición de JSON y reinicio en Claude Desktop/Cursor, o un clic en Levante. Lo que cansa es repetir ese proceso 10 veces para 10 servidores, gestionar secretos en texto plano y mantener configs sincronizadas entre equipos.

Para uso individual técnico, Claude Desktop y Cursor van bien. Para usuarios que valoran ergonomía o equipos que necesitan gobernanza, clientes con catálogo visual como Levante tienen ventaja clara.

Para profundizar en MCP como protocolo: Model Context Protocol explicado. Para elegir cliente: qué es un cliente MCP. Para la configuración específica de Claude Desktop con más detalle: Claude Desktop y MCP.

Fuentes verificadas: MCP servers oficiales, repo de referencia.