Guia de instalacion de plugins MCP
Aprende a instalar y configurar servidores MCP (Model Context Protocol) para ampliar las capacidades de Claude con herramientas externas, fuentes de datos e integraciones.
El Model Context Protocol (MCP) es un estandar abierto creado por Anthropic que estandariza como los modelos de IA se conectan a fuentes de datos y herramientas externas. A menudo descrito como "el USB-C de la IA", MCP proporciona una interfaz universal para que Claude interactue con tus archivos locales, bases de datos, APIs y herramientas de desarrollo.
A partir de 2026, MCP cuenta con el soporte de Anthropic, OpenAI, Google y Microsoft, lo que lo convierte en el estandar de integracion de facto para agentes de IA. Actualmente hay mas de 593 servidores MCP disponibles en el ecosistema, desde paquetes oficiales de Anthropic hasta integraciones creadas por la comunidad.
Requisitos previos
Node.js (LTS)
Necesario para ejecutar la mayoria de los servidores MCP mediante npx. Descargalo desde nodejs.org.
Python / uv (Opcional)
Algunos servidores MCP estan basados en Python y usan uvx en lugar de npx.
Claude Desktop
La aplicacion Claude Desktop debe estar instalada. Disponible para macOS y Windows.
No se requiere suscripcion
Los servidores MCP funcionan con cualquier plan de Claude, incluido el nivel gratuito.
Ubicacion del archivo de configuracion
Los servidores MCP se configuran en claude_desktop_config.json. La ubicacion del archivo depende de tu sistema operativo:
~/Library/Application Support/Claude/claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json Consejo
No necesitas crear este archivo manualmente. Claude Desktop puede generarlo por ti; consulta los pasos de instalacion a continuacion.
Instalacion paso a paso
Abre Claude Desktop
Abre la aplicacion Claude Desktop en tu computadora.
Abre la configuracion
Haz clic en el menu hamburguesa → File → Settings (o usa el atajo de teclado).
Ve a la pestana Developer
En el panel de configuracion, haz clic en la pestana "Developer" en la barra lateral izquierda.
Haz clic en "Edit Config"
Esto abre (o crea) el archivo claude_desktop_config.json en tu editor de texto predeterminado.
Agrega la configuracion del servidor MCP
Agrega los servidores MCP deseados bajo la clave mcpServers (consulta el formato de configuracion a continuacion).
Guarda y reinicia
Guarda el archivo de configuracion y reinicia Claude Desktop completamente para que los cambios surtan efecto.
Verifica la instalacion
Busca el icono de martillo 🔨 en la interfaz de Claude Desktop. Al hacer clic en el se muestran todas las herramientas MCP disponibles.
Formato de configuracion
El archivo de configuracion utiliza una estructura JSON sencilla. Cada servidor MCP se define bajo la clave mcpServers:
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "@package/server-name"],
"env": {
"API_KEY": "your-api-key-here"
}
}
}
}{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/Users/username/Downloads"
]
}
}
}{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
}
},
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "your-brave-api-key"
}
}
}
}Servidores MCP populares
Estos son los servidores MCP mas utilizados en el ecosistema:
| Servidor | Paquete | Proposito |
|---|---|---|
| Filesystem | @modelcontextprotocol/server-filesystem | Leer/escribir archivos locales, crear documentos, organizar carpetas |
| GitHub | @modelcontextprotocol/server-github | Leer repositorios, inspeccionar PRs, rastrear flujos de trabajo |
| PostgreSQL | @modelcontextprotocol/server-postgres | Acceso de solo lectura a bases de datos con inspeccion de esquemas |
| Brave Search | @modelcontextprotocol/server-brave-search | Capacidades de busqueda web |
| Puppeteer | @modelcontextprotocol/server-puppeteer | Automatizacion del navegador y web scraping |
| Sequential Thinking | @modelcontextprotocol/server-sequential-thinking | Razonamiento dinamico y resolucion de problemas paso a paso |
| Slack | @anthropic/mcp-server-slack | Integracion con espacios de trabajo de Slack |
| Google Drive | @anthropic/mcp-server-gdrive | Integracion con Google Docs, Sheets y Drive |
| Docker | @anthropic/mcp-server-docker | Gestion y orquestacion de contenedores |
| Memory | @modelcontextprotocol/server-memory | Memoria persistente entre sesiones |
Protocolos de transporte
MCP admite diferentes mecanismos de transporte para la comunicacion entre Claude y los servidores MCP:
stdio (E/S estandar)
El transporte predeterminado para Claude Desktop. El cliente inicia el servidor MCP como un proceso local y se comunica mediante stdin/stdout. Esto es lo que definen los campos command y args en la configuracion.
StreamableHTTP
El protocolo recomendado para acceso web y remoto. Admite multiples clientes concurrentes y es el sucesor del transporte SSE, ahora obsoleto.
language Para servidores remotos/webSSE (Server-Sent Events)
Obsoleto en favor de StreamableHTTP. Evita usarlo para nuevas integraciones.
Consideraciones de seguridad
Importante
Los servidores MCP se ejecutan localmente con acceso a tu sistema. En enero de 2026, se descubrieron vulnerabilidades criticas en el servidor MCP oficial de Git de Anthropic. Sigue siempre las buenas practicas de seguridad.
Instala solo desde fuentes verificadas — Usa paquetes oficiales de Anthropic o servidores comunitarios reconocidos con mantenimiento activo.
Manten los servidores actualizados — Ejecuta npx @package/server-name regularmente para obtener los ultimos parches de seguridad.
Usa variables de entorno para secretos — Nunca escribas claves API directamente en el archivo de configuracion. Usa el campo env o variables de entorno del sistema.
Restringe el alcance del sistema de archivos — Al usar el servidor de archivos, otorga acceso solo a los directorios especificos que necesites.
Elimina los servidores que no uses — Cada servidor MCP aumenta tu superficie de ataque. Elimina los que no estes utilizando activamente.
Solucion de problemas
El icono de martillo no aparece despues de reiniciar expand_more
Esto generalmente significa que el archivo de configuracion tiene un error de sintaxis JSON. Problemas comunes:
- Comas faltantes o sobrantes entre las entradas de servidores
- Corchetes o llaves sin cerrar
- Uso de comillas simples en lugar de comillas dobles
Valida tu JSON en jsonlint.com o usa node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"
El servidor MCP no se inicia expand_more
Verifica lo siguiente:
- Asegurate de que Node.js este instalado y que
npxeste disponible en tu PATH - Intenta ejecutar el comando npx manualmente en tu terminal para ver los errores
- Verifica que el nombre del paquete sea correcto (los errores tipograficos son comunes)
- Para servidores que requieren claves API, verifica que la clave sea valida y este correctamente configurada en el campo
env
Errores de permiso denegado expand_more
Los servidores MCP heredan los permisos del proceso de Claude Desktop:
- En macOS, revisa Ajustes del Sistema → Privacidad y Seguridad para los permisos correspondientes
- Asegurate de que los directorios especificados en la configuracion sean accesibles para tu cuenta de usuario
- Para el servidor de archivos, verifica que las rutas en
argsexistan y sean legibles
Explora el ecosistema MCP
Con mas de 593 servidores MCP disponibles, es muy probable que exista un servidor para tu caso de uso. Explora el directorio oficial de servidores MCP en modelcontextprotocol.io o consulta las listas curadas por la comunidad en GitHub para ver las ultimas incorporaciones.