La entrada de un servidor MCP es un JSON pequeño con un modo de fallo implacable: si una clave está mal no hay error, el servidor simplemente no aparece. Cada transporte quiere una forma distinta —uno local necesita un comando y sus argumentos, uno remoto una URL y normalmente una cabecera— y mezclarlas produce un archivo que parece completo y no hace nada. Este creador pide solo los campos que usa el transporte elegido, avisa cuando hay un campo del otro relleno y señala probablemente el error más habitual del mundo real: una credencial viva escrita en un archivo que acaba en un repositorio. Emite tanto el archivo de configuración como el comando equivalente de una línea.
Características
Solo los campos que usa el transporte elegido
Avisa cuando hay un campo del otro transporte relleno
Señala un secreto con pinta de real escrito en el archivo, pero no un marcador
Avisa de HTTP sin cifrar hacia un host remoto, callado para localhost
Detecta argumentos metidos dentro del campo de comando
Variables de entorno y cabeceras como pares editables
Emite tanto el archivo de proyecto como la configuración de la app de escritorio
El comando equivalente, correctamente entrecomillado
Cómo usar Configuración de servidor MCP
Nombra el servidor: así se agrupan sus herramientas
Elige el transporte que usa
Rellena el comando y los argumentos, o la URL y las cabeceras
Copia el JSON en tu configuración, o ejecuta el comando
Ejemplo
Entrada
"command": "npx -y some-server"
Salida
Warning: looked up as a single executable with that name
La primera palabra es el comando; todo lo demás es un argumento.
Errores comunes y solución de problemas
El servidor no aparece nunca. — Normalmente una forma equivocada: una entrada stdio con url, o una remota con command. Ambas se señalan aquí, porque ninguna produce un error por sí sola.
No encuentra el comando. — Los argumentos van aparte. Pon npx en el comando y el resto en la lista de argumentos: un comando con espacios se busca como un único ejecutable con ese nombre.
Funciona en local y falla para los demás. — Suele ser una ruta absoluta de tu máquina en los argumentos, o una credencial de tu entorno que nadie más tiene.
Tengo un token en el archivo de configuración. — Referencia una variable de entorno. Un secreto con pinta de real se señala aquí, porque los archivos de configuración acaban en el repositorio.
Preguntas frecuentes
¿Qué transporte debería usar?
stdio para todo lo que ejecutes en local: el cliente lo arranca como proceso y habla por su entrada y salida estándar. HTTP para un servidor remoto. SSE existe sobre todo para servidores escritos antes de que HTTP fuese la opción habitual.
¿Dónde va el archivo de configuración?
Uno de proyecto vive en el repositorio para que todo el equipo tenga los mismos servidores; la app de escritorio tiene su propia configuración para los que quieras en todas partes. Se emiten ambas formas y se muestra la ruta.
¿Cómo mantengo un token fuera del archivo?
Escríbelo como referencia a una variable de entorno en vez del valor. La comprobación mira si el valor parece una credencial real o un marcador, y solo protesta por lo primero.
¿Uso el archivo o el comando?
Hacen lo mismo. El archivo va mejor cuando debe versionarse con el proyecto; el comando es más rápido para algo que estás probando. Ambos salen de los mismos campos.
¿Por qué importa el nombre del servidor?
Es la clave bajo la que se guarda la entrada y el espacio de nombres de sus herramientas, así que dos servidores no pueden compartirlo, y renombrarlo cambia cómo se referencian sus herramientas en todas partes.
Herramientas relacionadas
Esquema de herramienta MCP — Define una herramienta y obtén el JSON Schema, con el modo estricto revisado.