Requisitos previos
- Tener instalado Claude Desktop / Cursor / VS Code
- El runtime que necesite el server que vas a instalar (la mayoría necesita Node.js o Python; algunos requieren dependencias extra)
- Tener listas las credenciales de API (p. ej., el token de GitHub) — las necesitarás durante la configuración
Claude Desktop
Flujo gráfico:
- Abre Claude Desktop → Settings
- Entra en Developer → pulsa Edit Config
- Añade tu server en la sección
mcpServersdeclaude_desktop_config.json:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "tu-token" }
}
}
}
Guarda el archivo y reinicia Claude Desktop. Tu nueva herramienta aparecerá en la lista de herramientas de la barra lateral izquierda. Consulta siempre el README del server para el comando y los argumentos exactos.
Cursor
- Abre la paleta de comandos (
Ctrl+Shift+P/Cmd+Shift+P) - Busca y selecciona Cursor Settings > MCP
- Pulsa Add New MCP Server, elige el tipo de transporte (stdio o SSE) y rellena el comando/los argumentos
VS Code
- Instala la extensión MCP Client (o usa Copilot / extensiones con soporte MCP integrado)
- Configura
mcpServersen los ajustes de la extensión con el mismo formato JSON que Claude Desktop - Recarga la ventana de VS Code para que los cambios surtan efecto
Los diseños de la interfaz pueden cambiar entre versiones de cliente — consulta siempre la documentación oficial para los pasos exactos; la estructura del comando/JSON siempre sigue el README del server.
Resolución de errores comunes
| Error | Causa | Solución |
|---|---|---|
| command not found | El runtime de Node/Python no está instalado o no está en el PATH | Instala el runtime y reinicia el cliente |
| 401 / 403 | Credenciales de API inválidas o caducadas | Regenera el token y revisa dos veces tu configuración de entorno |
| Connection refused | Dirección del server SSE incorrecta o el servicio no se está ejecutando | Verifica la URL + el puerto y confirma que el server está en línea |
| Tool not found | Los cambios de configuración no cargaron porque el cliente no se reinició | Reinicia por completo la aplicación del cliente tras guardar la configuración |
Notas de seguridad
- Los tokens se guardan solo en tu archivo de configuración local — nunca subas el archivo a Git (recuerda añadir
.gitignore) - Instala solo servers de proyectos de confianza y con muchas estrellas — los servers sin revisar podrían exfiltrar tus datos
- Concede servers de alto permiso solo cuando sea absolutamente necesario