Claude Desktop y MCP: cómo configurarlo paso a paso (y alternativas con MCP Store)

Configurar Model Context Protocol (MCP) en Claude Desktop es la forma oficial de conectar Claude con tus herramientas externas: filesystem, GitHub, Gmail, Notion, Slack y decenas más. El proceso no es difícil, pero hay fricciones reales (edición de JSON manual, reinicios, secretos en texto plano) que conviene conocer antes de empezar.

Este artículo es un tutorial completo paso a paso, con los servidores MCP que de verdad vale la pena instalar primero, troubleshooting común y qué alternativas existen si buscas algo más ergonómico.

Qué necesitas antes de empezar

1. Claude Desktop instalado en Mac o Windows (no hay versión Linux oficial, ver Claude Desktop en Linux).

2. Node.js 18+ instalado (muchos servidores MCP son TypeScript y corren via npx).

3. Python 3.10+ si vas a usar servidores Python (con uvx recomendado).

4. Cuenta Claude gratuita o Pro.

5. 15 minutos la primera vez.

Paso 1 — Localiza el archivo de configuración

Claude Desktop lee MCP desde claude_desktop_config.json. Rutas:

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

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

La forma más rápida de abrirlo:

• En Claude Desktop: menú Claude → Settings → Developer → Edit Config.

• Esto abre el archivo en tu editor por defecto.

Si el archivo no existe, Claude Desktop lo crea vacío la primera vez.

Paso 2 — Estructura básica del JSON

El archivo tiene esta forma:

{
  "mcpServers": {
    "nombre-servidor-1": {
      "command": "...",
      "args": [...],
      "env": {}
    },
    "nombre-servidor-2": {
      "command": "...",
      "args": [...]
    }
  }
}

• mcpServers es el root.

• Cada entrada dentro es un servidor distinto con nombre arbitrario.

• command es el binario que ejecutas (normalmente npx o uvx).

• args son los argumentos al comando.

• env son variables de entorno (útil para API keys).

Paso 3 — Tu primer servidor: Filesystem

El servidor más útil para empezar: dar a Claude acceso a leer/escribir en una carpeta concreta de tu disco.

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

Cambia /Users/tu-usuario/Documents por la ruta que quieras exponer (en Windows usa rutas estilo C:\\Users\\tu-usuario\\Documents con doble backslash).

Importante: Claude tendrá acceso completo (lectura y escritura) dentro de esa carpeta. No apuntes a / o ~. Empieza con una carpeta específica.

Paso 4 — Reinicia Claude Desktop y verifica

Cierra completamente Claude Desktop (no solo minimizar — Cmd+Q en Mac, o cerrar desde barra de tareas en Windows). Reábrelo.

Abajo a la derecha del input de chat verás un icono de martillo 🔨 con un número. Ese número es cuántas tools MCP hay cargadas. Con filesystem, verás algo como "5 tools".

Prueba escribir: "Lista los PDFs en Documents ordenados por fecha". Claude usará la tool, te pedirá confirmación la primera vez y ejecutará.

Si ves un icono ⚠️ en vez de 🔨, hay un error. Menú Claude → Help → Check MCP Logs te lo muestra.

Paso 5 — Los 7 servidores de referencia oficial

Según la documentación oficial de MCP en 2026, los servidores reference mantenidos activamente por el proyecto son:

Los servidores Postgres, SQLite, Slack, Gmail y similares que existían como "reference" en versiones anteriores fueron archivados en 2025 para centralizar el catálogo en integraciones oficiales (mantenidas por cada empresa) y comunidad.

Paso 6 — Integraciones oficiales populares

Las integraciones oficiales las mantienen las propias empresas (GitHub, Cloudflare, Atlassian, etc.) en sus repos. Las más usadas en 2026:

• GitHub (@modelcontextprotocol/server-github): issues, PRs, búsquedas de repos.

• Notion (@notionhq/notion-mcp-server): buscar y modificar páginas Notion.

• Slack (mantenido por comunidad): mandar mensajes, leer canales.

• PostgreSQL (mantenido por comunidad): SQL read-only sobre tu BD.

• Puppeteer (comunidad): automatización de browser headless.

• Brave Search (Brave): búsqueda web con API key gratuita.

Ejemplo de config para GitHub:

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

Genera el token en github.com/settings/tokens con permisos repo + read:user.

Paso 7 — Configuración completa multi-servidor de ejemplo

Un setup realista para un developer con Claude Desktop:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/saul/proyectos"
      ]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "/Users/saul/proyectos/mi-repo"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    },
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Reinicia Claude Desktop tras guardar. Verás ~20+ tools cargadas en el icono martillo.

Troubleshooting común

"0 tools" o icono ⚠️ rojo

• Causa: JSON malformado. Un error sintáctico lo tira todo.

• Fix: valida el JSON con jq . claude_desktop_config.json o online en jsonlint.com.

Servidor no arranca

• Causa: npx o uvx no están en el PATH que Claude Desktop ve.

• Fix en Mac: usa ruta absoluta en command. Ej: "command": "/usr/local/bin/npx".

• Fix en Windows: asegúrate de que Node.js está instalado globalmente y reinicia terminal antes de abrir Claude.

"Permission denied" en filesystem

• Causa: ruta apunta a carpeta sin permisos de escritura, o en macOS tiene TCC bloqueando.

• Fix: usa carpeta dentro de tu home (~/Documents), da permisos explícitos en Mac en Settings → Privacy & Security → Files and Folders → Claude.

Token de GitHub rechazado

• Causa: token caducado, scopes insuficientes o personal access token "fine-grained" no compatible.

• Fix: genera un Classic personal access token con scopes repo, read:user, read:org. Los fine-grained a veces dan problemas con la API REST.

El servidor funciona pero Claude no usa la tool

• Causa: Claude a veces no se "da cuenta" de que tiene la tool disponible para esa query.

• Fix: menciona explícitamente la tool en el prompt: "Usa la tool de filesystem para...". Después empieza a usarla sola.

Secretos en JSON plano: el problema gordo

Claude Desktop guarda los tokens (GITHUB_PERSONAL_ACCESS_TOKEN, API keys de OpenAI, credenciales Slack, etc.) en texto plano dentro del JSON de config.

Consecuencias:

• Si tu Mac/PC se compromete, los tokens están expuestos.

• Si compartes la config para setup rápido, compartes secretos.

• No hay keychain del sistema integrado.

• No hay rotación automática.

Workaround: usa variables de entorno del shell (Claude Desktop no las hereda por defecto en Mac salvo que lo arranques desde terminal) o herramientas externas tipo direnv. Pero no hay solución clean.

Este es uno de los motivos por los que alternativas como Levante con MCP Store gestionan secretos en keychain del sistema por defecto.

Alternativas con MCP Store visual

Si después de este tutorial piensas "esto debería ser un clic", sí, hay clientes MCP que lo hacen:

Levante

App de escritorio Mac / Windows / Linux con MCP Store visual. Los mismos servidores que acabas de configurar en JSON, los instalas desde un catálogo con:

• Búsqueda por nombre.

• Rating y descripción.

• Gestión de secretos en keychain.

• Instalación en un clic.

• Mismo MCP sobre modelos OpenAI, Anthropic o locales.

Cursor

IDE con soporte MCP pensado para código. Catálogo limitado a herramientas relevantes para dev.

LibreChat / AnythingLLM (open source)

Clientes open source con soporte MCP básico, configuración también por JSON pero centralizada y con UI para editarla.

Detalle de opciones en Las mejores alternativas a Claude Desktop.

FAQ

¿MCP funciona con Claude Sonnet / Haiku o solo con Opus?
Funciona con todos los modelos de Claude que soportan tools: Sonnet 4.6, Opus 4.7 y Haiku 4.5. En Haiku, el razonamiento sobre cuándo usar qué tool es algo peor; para MCPs complejos, Sonnet va mejor.

¿Cuántos servidores MCP puedo cargar a la vez?
Sin límite duro. Con ~10 servidores activos funciona bien. A partir de 20+ tools totales, Claude empieza a tener más latencia decidiendo qué tool usar. Carga solo las que necesites.

¿Los servidores MCP consumen recursos aunque no los uses?
Sí — cada servidor es un proceso Node/Python corriendo en background mientras Claude Desktop está abierto. ~50-150 MB RAM por servidor típico. Desinstala los que no uses.

¿MCP funciona en Claude.ai (web)?
No. Solo en Claude Desktop y Claude Code. La web claude.ai no carga servidores MCP locales.

¿Puedo usar los mismos servidores MCP que configuré en Claude con Cursor o Cherry Studio?
Sí, el formato JSON es estándar. Con pequeñas adaptaciones de ruta, el mismo bloque mcpServers funciona en Cursor, Cherry Studio, Levante, etc. Es parte del valor del protocolo ser abierto.

¿Los servidores MCP pueden ser maliciosos?
Sí, técnicamente. Un servidor MCP es un binario que ejecutas con tus permisos de usuario. Puede leer/escribir archivos, llamar a APIs con tus credenciales. Instala solo servidores de autores reconocidos (oficial Anthropic, GitHub, Cloudflare, Notion, etc.) y revisa el código si es comunidad.

¿Hay forma de limitar qué puede hacer un servidor MCP?
Depende del servidor. filesystem tiene paths configurables. git permite repositorios específicos. Otros no tienen sandbox nativo. Si necesitas sandbox real, ejecuta Claude Desktop dentro de una VM o container.

Recapitulando

Configurar MCP en Claude Desktop es editar un JSON con uno o varios servidores, reiniciar la app y ver el icono martillo lleno de tools. Para la mayoría de casos, 5 servidores (filesystem, fetch, git, github, memory) cubren el 80% del uso práctico.

Las fricciones reales: secretos en texto plano, ausencia de Linux, edición manual sin catálogo visual. Si esas fricciones bloquean tu uso, el ecosistema tiene alternativas (Levante, Cursor, LibreChat).

Para entender MCP en profundidad antes o después de este tutorial: Model Context Protocol explicado y qué es un cliente MCP.

Fuentes verificadas: MCP servers oficiales (abril 2026), repo de referencia.