Creando un Servidor MCP que se Instale a sí Mismo: Tres Hosts, Tres Mecanismos, Contratiempos

La configuración de servidores MCP a menudo implica editar manualmente un archivo JSON, y cada host utiliza un archivo y formato diferente. Esa fricción impide que los desarrolladores ejecuten servidores que de otro modo usarían. Este artículo desglosa tres hosts, sus mecanismos de instalación y los problemas que te hacen tropezar.

Tres hosts, tres mecanismos

• VS Code: Tiene una API real: registerMcpServerDefinitionProvider. Declara un proveedor en package.json y devuelve la definición del servidor en tiempo de ejecución. VS Code muestra un aviso de consentimiento. Sin edición de archivos de configuración. Es la opción más limpia, pero requiere enviar una extensión de VS Code.
• Cursor: No tiene API nativa. Escribe .cursor/mcp.json directamente con la clave raíz mcpServers.
• Claude Code: Usa la CLI. No escribas el archivo manualmente. Ejecuta, por ejemplo:
  claude mcp add --transport stdio --scope <user|local> --env … <name> -- node <path>

Seis problemas a evitar

1. Ese archivo JSON no es tuyo. El mcp.json de Cursor contiene otros servidores del usuario. Lee, combina tu entrada, conserva las claves no relacionadas: no sobrescribas.
2. Sobrevive a un archivo malformado. Si el archivo existe pero es JSON inválido, no lo trates como vacío y sobrescribas. Lo mismo para errores de lectura/permiso: relanza. Tratar "no se pudo leer" como "no hay nada" corromperá configuraciones.
3. Respaldar y escribir atómicamente. Copia el archivo existente antes de tocarlo, escribe en un archivo temporal y luego renómbralo sobre el destino. Un mcp.json a medio escribir rompe el editor.
4. Instalar dos veces debe ser un no-op, no un error. La CLI de Claude da error si la entrada ya existe, así que remove luego add. Para hosts de archivo, clave por nombre de servidor y reemplaza en su lugar. Re-ejecutar debe converger, no duplicar.
5. El ámbito lo cambia todo. La instalación a nivel de usuario vs. proyecto cambia dónde se guarda la configuración y qué necesita el servidor (por ejemplo, directorio de datos explícito vs. descubrimiento ascendente). Elige deliberadamente.
6. Eres responsable de mantenerte actualizado. La versión registrada se desvía de lo que distribuyes. Añade una verificación: "¿lo instalado sigue siendo la versión que empaqueto?" y una ruta de reinstalación limpia. Un botón muestra el estado: instalar, actualizar o actualizado.

La lección principal: la configuración manual falla porque un humano pegando un fragmento no conoce la ruta absoluta, el ámbito correcto, las variables de entorno ni cómo fusionar de forma segura. El código de instalación sí.