GuíasMCP

Tutorial: conectar un servidor MCP a Claude Desktop

Por el equipo de Banzai LabsActualizado el 2 min de lectura

{"mcpServers": {"crm": { … }}}claude_desktop_config.jsonHerramienta crm usadaUn archivo de ajustes, un reinicio, y Claude ve tus herramientas
Declarado en el archivo de configuración, el servidor MCP aparece en 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

  1. 1Abrir la configuraciónAjustes, Desarrollador, editar la configuración.
  2. 2Declarar el servidorComando, argumentos con ruta absoluta, variables.
  3. 3ReiniciarCerrar del todo la aplicación y volver a abrirla.
  4. 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.

Para leer después

Todas las guías