GuíasMCP
Tutorial: conectar un servidor MCP a Claude Desktop
1. La declaración
{
"mcpServers": {
"stock": {
"command": "node",
"args": ["/Users/tu/mcp-stock/build/index.js"],
"env": { "STOCK_API_KEY": "..." }
}
}
}
2. Los pasos
- 1Abrir la configuraciónAjustes, Desarrollador, editar la configuración.
- 2Declarar el servidorComando, argumentos con ruta absoluta, variables.
- 3ReiniciarCerrar del todo la aplicación y volver a abrirla.
- 4ComprobarLas herramientas del servidor aparecen en la conversación.
3. Probar
Pide a Claude algo que necesite la herramienta («¿cuál es el stock de TSH-042?»). La aplicación muestra la llamada y te pide permiso antes de ejecutarla.
Los errores frecuentes
| Síntoma | Causa probable |
|---|---|
| Ninguna herramienta | JSON no válido o aplicación sin reiniciar |
| Servidor con error | Ruta relativa, o node no encontrado |
| La herramienta falla | Falta una variable de entorno |
Antes: crear el servidor en TypeScript.
Preguntas frecuentes
- ¿Dónde está el archivo de configuración?
- En Claude Desktop, menú de ajustes, sección para desarrolladores, botón para editar la configuración: abre el archivo correcto, en Mac y en Windows.
- Mi servidor no aparece, ¿qué compruebo?
- Que el JSON es válido, que la ruta es absoluta, que el comando se lanza solo en un terminal, y luego consulta los registros MCP indicados en los ajustes para desarrolladores.
- ¿Cómo paso una clave de API al servidor?
- En el campo env de su declaración. El archivo se queda en tu equipo: no lo compartas tal cual.