Conectar MCP Server de Laravel con Claude Desktop en macOS

En este caso Node fue instalado usando nvm a través de Laravel Herd, lo que significa que npx y node no están en las rutas estándar del sistema.

Hay que indicarle a Claude Desktop:

• La ruta absoluta de npx (en lugar de solo "npx")
• La ruta del directorio de node inyectada como variable de entorno PATH

Paso 1 — Obtener la ruta de npx

Ejecuta en tu terminal:

which npx

Ejemplo de resultado:

/Users/jaime/Library/Application Support/Herd/config/nvm/versions/node/v22.22.0/bin/npx

Paso 2 — Obtener el directorio de node

Ejecuta:

which node

Ejemplo de resultado:

/Users/jaime/Library/Application Support/Herd/config/nvm/versions/node/v22.22.0/bin/node

Toma esa ruta y quita /node del final para quedarte solo con el directorio:

/Users/jaime/Library/Application Support/Herd/config/nvm/versions/node/v22.22.0/bin

Paso 3 — Editar claude_desktop_config.json

Abre el archivo de configuración de Claude Desktop:

~/Library/Application Support/Claude/claude_desktop_config.json

Agrega o edita la entrada del servidor MCP con la siguiente estructura:

{
  "mcpServers": {
    "mcp-vtiger": {
      "command": "/Users/TU_USUARIO/Library/Application Support/Herd/config/nvm/versions/node/v22.22.0/bin/npx",
      "args": [
        "mcp-remote",
        "https://example.com/tu/mcp/server"
      ],
      "env": {
        "PATH": "/Users/TU_USUARIO/Library/Application Support/Herd/config/nvm/versions/node/v22.22.0/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

La clave env.PATH combina:

• El directorio de tu versión de node (para que npx encuentre node internamente)
• Los paths estándar del sistema (/usr/local/bin:/usr/bin:/bin)

Paso 4 — Reiniciar Claude Desktop

Cierra Claude Desktop completamente.