$ man how-to/managing-mcp-servers

CODE

Las configuraciones de servidores MCP viven en archivos JSON. La ubicacion depende de tu herramienta: Cursor (nivel de proyecto): .cursor/mcp.json en la raiz de tu proyecto Cursor (global): ~/.cursor/mcp.json en tu directorio home Claude Code: ~/.claude/mcp.json o a nivel de proyecto .claude/mcp.json Las configuraciones a nivel de proyecto sobreescriben las configuraciones globales. Usa configuraciones globales para servidores que necesitas en cada proyecto (GitHub, Slack). Usa configuraciones a nivel de proyecto para servidores especificos de un proyecto. Ambos archivos comparten el mismo formato: un objeto JSON con una clave "mcpServers" que contiene un bloque por servidor. Cada bloque tiene un "command" (como iniciar el servidor), "args" (argumentos para el comando) y "env" (variables de entorno, generalmente API keys).

PATTERN

La habilidad /addmcp automatiza esto, pero entender el proceso manual ayuda cuando las cosas se rompen. 1. Encuentra el paquete npm para el servidor MCP. La mayoria se publican en npm con nombres como @company/mcp-server o mcp-server-toolname. 2. Obtener la API key de la configuracion o dashboard de la herramienta. 3. Agregar un nuevo bloque a tu mcp.json con el nombre del servidor, command (generalmente "npx"), args (el nombre del paquete con la bandera "-y") y env (tu API key). 4. Reiniciar tu editor para que tome la nueva configuracion. 5. Probar pidiendole a Claude que use la herramienta. "Lista mis canales de Slack" o "Muestra mis campanas de HeyReach." Si la prueba falla, el problema es casi siempre la API key (incorrecta o expirada) o el nombre del paquete (error tipografico o version incorrecta).

PRO TIP

Cuando un servidor MCP deja de funcionar, verifica estas cosas en orden: 1. API key: Ha expirado? La rotaste? Verifica el dashboard de la herramienta. 2. Sintaxis de configuracion: El JSON es valido? Una coma o corchete faltante rompe todo el archivo de configuracion, no solo un servidor. 3. Disponibilidad del paquete: Puedes ejecutar el comando npx manualmente en la terminal? Si falla ahi, falla en el IDE tambien. 4. Red: El servicio externo esta funcionando? Verifica la pagina de estado de la herramienta. 5. Limites de tasa: Llegaste al limite de tasa de la API? Algunos servicios limitan despues de muchas solicitudes. Agrega retrasos entre llamadas o reduce tamanos de lote. El problema mas comun por lejos son las API keys expiradas. Si un servidor funcionaba ayer y falla hoy, verifica la key primero. Ahorrate 20 minutos de depuracion empezando por lo obvio.

ANTI-PATTERN

No agregues servidores MCP que no uses activamente. Cada servidor agrega tiempo de arranque. Algunos servidores ejecutan procesos en segundo plano que consumen memoria. Si no estas usando el MCP de Figma a diario, eliminalo. Siempre puedes volver a agregarlo en 30 segundos. No hardcodees API keys en archivos que se hagan commit. El archivo mcp.json deberia estar en tu .gitignore. Si compartes un proyecto con colaboradores, crea un mcp.json.example con valores de marcador de posicion y agrega el mcp.json real a .gitignore. No instales cada servidor MCP de una lista de "los 50 mejores servidores MCP". Instala los que eliminen friccion de flujos de trabajo que ya haces. El valor de un servidor MCP se mide por cuantos pasos manuales elimina de tu proceso diario. Cero pasos manuales eliminados significa cero valor, sin importar que tan genial sea la herramienta.