Skip to main content
ClaudeWave
4 min de lectura · 14/4/2026

Cómo instalar un MCP server en Claude Desktop

Guía paso a paso: instala cualquier MCP server en Claude Desktop o Claude Code en menos de 2 minutos. Mac, Windows y Linux cubiertos.

Paso 1: localiza el fichero de config

Cada cliente Claude con MCP lee un fichero JSON al arrancar. Aquí lo localizas:

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

Si el fichero no existe, créalo con un objeto JSON vacío: {}

Paso 2: añade la config del server

En cualquier página de MCP server de ClaudeWave, pulsa el botón Copiar config. Pega dentro de tu config existente, fusionando el objeto mcpServers:

{"mcpServers":{"server-existente":{...},"nuevo-server":{"command":"npx","args":["-y","@example/mcp-server"]}}}

Los placeholders como <api_token> deben sustituirse por valores reales. Las variables de entorno son más seguras que hardcodear secretos; algunos servers las leen del env.

Paso 3: reinicia Claude Desktop

Cierra la app por completo (Cmd+Q en Mac). Reábrela. El nuevo MCP server debería aparecer en la lista de tools (esquina inferior derecha del input).

Si no aparece, revisa los logs: Claude Desktop, Settings, Developer, Open Logs. Verás errores de conexión, comandos no encontrados o problemas de permisos.

Alternativa: Claude Code CLI

Si usas Claude Code (la CLI de terminal), puedes añadir MCP servers con: claude mcp add <nombre> <comando>. La config se guarda en ~/.claude.json. No requiere reinicio: la siguiente invocación de claude la recoge.

Problemas comunes

'Command not found' significa que falta el runtime. Para npx: brew install node. Para uvx: pip install uv. Para Docker: instala Docker Desktop.

'Permission denied' significa que el server necesita acceso al filesystem. En Mac, concede el permiso en Ajustes del sistema, Privacidad y seguridad, Archivos y carpetas, Claude.

'No tools available' significa que el server arrancó pero devolvió cero tools. Revisa el README del server para las env vars requeridas (API keys, paths, etc).

Preguntas frecuentes

¿Puedo usar MCP servers sin Claude Desktop?
Sí. Cualquier cliente compatible con MCP vale: Claude Code CLI, Cursor, Zed, Continue, Warp. El formato de config es casi idéntico entre ellos.
¿Cómo actualizo un MCP server?
npx y uvx descargan la última versión en cada arranque. Para docker: docker pull <imagen>. Para servers instalados a mano: git pull más npm install (o pip install --upgrade).
¿Puedo correr varios MCP servers a la vez?
Sí. Añade tantos como quieras al objeto mcpServers. Claude los coordina automáticamente. Nuestro Stack Builder genera configs combinadas por ti.
¿Quieres más guías como esta?
Explora el directorio Claude