Cheatsheet de Servidores MCP: Conceptos, Configuraciones, Servidores Útiles y Depuración

Referencia práctica del Model Context Protocol: conceptos en una tabla, configuraciones listas para copiar en Claude Desktop y Cursor, los servidores que instalar primero, reglas de seguridad y depuración.

🧪

Ejecuta y Edita este Código en Vivo Sin instalaciones locales. Soporta Python 3, JS y SQL.

▶ Probar en Playground →

1. Conceptos en 60 segundos

MCP es el estándar abierto para que los asistentes de IA llamen herramientas reales (archivos, bases de datos, navegadores, APIs) por un enchufe.

Término	Qué significa
Host	La app de IA que usas: Claude Desktop, Cursor, Claude Code, VS Code, Windsurf…
Client	El conector dentro del host que habla con un servidor (1 cliente ↔ 1 servidor)
Server	Programa que expone capacidades de forma estándar; local (stdio) o remoto (HTTP)
Tools	Acciones que el modelo puede llamar: read_file, query_database, create_issue…
Resources	Datos de solo lectura como contexto: archivos, esquemas, documentos
Transporte stdio	El host lanza el servidor como subproceso por stdin/stdout; opción local por defecto
Streamable HTTP	Servidor remoto en una URL; el host conecta por HTTPS, con OAuth o token

2. Configuración: Claude Desktop

Archivo: en macOS, ~/Library/Application Support/Claude/claude_desktop_config.json; en Windows, %APPDATA%\Claude\claude_desktop_config.json. Tras editarlo, reinicia la app.

CODE SNIPPET

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem",
               "/Users/you/projects", "/Users/you/notes"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token" }
    }
  }
}

3. Configuración: Cursor

Proyecto: .cursor/mcp.json en el repo; global: ~/.cursor/mcp.json. Los remotos usan url en vez de command.

CODE SNIPPET

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "my-remote-server": {
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

En Claude Code, edita los mismos archivos o usa claude mcp add nombre -- comando…; la cheatsheet de Claude Code trae los comandos exactos.

4. Servidores útiles para instalar primero

Para empezar: Filesystem + GitHub + Playwright; añade más solo ante una capacidad concreta que falte.

Servidor	Qué le da al modelo	Instalación (stdio)
Filesystem	Lectura y escritura en las carpetas que autorizas	`npx -y @modelcontextprotocol/server-filesystem /path`
GitHub	Issues, PRs, búsqueda en repos y revisiones	`npx -y @modelcontextprotocol/server-github` + token en env
Playwright	Un navegador real: navegar, clics, capturas	`npx -y @playwright/mcp@latest`
Fetch	Convierte páginas web a markdown limpio	`uvx mcp-server-fetch`
Memory	Grafo de conocimiento persistente entre sesiones	`npx -y @modelcontextprotocol/server-memory`
Postgres / SQLite	Consulta tu base de datos en lenguaje natural	`npx -y @modelcontextprotocol/server-postgres <url>`
Context7	Documentación de librerías actualizada por versión	`npx -y @upstash/context7-mcp`

5. Reglas de seguridad (no negociables)

Autoriza lo mínimo: a Filesystem, una carpeta de proyecto, no tu directorio personal; a las bases de datos, solo lectura.
Los secretos viven en env, nunca en prompts ni en repos. Clave real en un commit → rótala; borrarlo no basta.
Instala solo servidores inspeccionables: oficiales y editores conocidos; uno cualquiera corre con tus permisos.
Vigila las llamadas: aprueba escrituras y borrados con deliberación; ojo al prompt injection.

6. Depuración: los arreglos que resuelven casi todo

Flujo que ahorra horas: terminal primero (¿el comando corre?), Inspector después (¿responden?), cliente al final (¿la configuración es correcta?).

Síntoma	Comprobación / comando
El servidor no aparece en el cliente	JSON válido (una coma final lo rompe), ruta correcta y reinicia la app host: MCP carga al arrancar
El servidor npx no arranca	Ejecuta el comando exacto en una terminal: `npx -y @modelcontextprotocol/server-filesystem /tmp`; si falla ahí, corrige Node (18+) o el paquete
Arranca pero las herramientas no se disparan	Errores de handshake en el panel/logs MCP; el servidor no debe imprimir logs en stdout (en stdio van a stderr)
Errores de autenticación	La variable debe coincidir exactamente con el README del servidor, y el token necesita los permisos pedidos
Funciona en un cliente y no en otro	Los transportes difieren; puede faltar soporte HTTP remoto o de autenticación: prueba en el MCP Inspector
Inspeccionar cualquier servidor	`npx @modelcontextprotocol/inspector`: interfaz para llamar herramientas a mano y ver peticiones y respuestas en crudo