Cómo conectar servidores MCP a Claude Desktop

Servidores remotos: añadir un conector personalizado

Abre Claude Desktop, ve a Configuración y luego a Conectores, y pulsa Añadir conector personalizado. Ponle un nombre, pega la URL del servidor y confirma. Los conectores personalizados que usan MCP remoto están disponibles en los planes Free, Pro, Max, Team y Enterprise; una cuenta Free está limitada a un conector personalizado. En los planes Team y Enterprise, el propietario de la organización añade primero el conector en la configuración de la organización, y los miembros lo activan después desde su propia página de Conectores.

Los servidores que admiten OAuth te piden iniciar sesión y aprobar los permisos en el navegador la primera vez que los usas; no hace falta nada más. Una sección opcional de configuración avanzada acepta un ID de cliente y un secreto de OAuth para los servidores que exigen un cliente registrado previamente, algo que la mayoría de los servidores públicos no requiere. Para el servidor de HostTracker la URL es https://mcp.host-tracker.com/mcp; usa OAuth con registro dinámico de clientes, así que el conector solo guarda los permisos que apruebas, y no hay ninguna clave que pegar.

Los conectores se ejecutan desde el lado de Anthropic y no desde tu máquina, así que no pueden llegar a un servidor de tu red local, y son el mismo mecanismo que usan claude.ai y Cowork. El archivo de configuración que se describe a continuación es el equivalente local.

Servidores locales: editar claude_desktop_config.json

Abre Configuración, elige la pestaña Desarrollador y pulsa Editar configuración. Eso abre el archivo de configuración en tu editor, creándolo si todavía no existe. El archivo se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS y en %APPDATA%\Claude\claude_desktop_config.json en Windows; en la beta de Linux, usa el botón Editar configuración en lugar de adivinar la ruta. Cada servidor es una entrada bajo mcpServers con el comando que lo inicia y sus argumentos:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Guarda el archivo, cierra Claude Desktop por completo y vuelve a abrirlo; cerrar la ventana no basta, porque los servidores se lanzan cuando arranca la aplicación. En Windows, el entorno de ejecución del que depende el comando, como Node.js para npx, tiene que estar instalado y en el PATH que ve la aplicación de escritorio, así que un servidor que funciona bien en una terminal pero no desde la aplicación suele deberse a una diferencia de PATH.

Para comprobar que un servidor se cargó, pulsa el icono "Añadir archivos, conectores y más" en la parte inferior izquierda del cuadro de mensajes, pasa el ratón por Conectores y abre Gestionar conectores; el servidor aparece ahí con sus herramientas. La documentación más antigua llama a esto el icono del martillo, y la página de solución de problemas todavía usa ese nombre en un encabezado.

Extensiones del directorio

Configuración, luego Extensiones y después Explorar extensiones muestra un directorio seleccionado de servidores locales empaquetados como extensiones, que se instalan con un solo clic y se actualizan solas. Un paquete descargado se instala mediante Instalar extensión eligiendo el archivo; estos paquetes usan el formato .mcpb, que sustituyó al nombre anterior .dxt, y pueden envolver servidores en Node.js, Python o binarios. Los paquetes distribuidos de forma privada no se actualizan solos y hay que reinstalarlos a mano después de un cambio.

Dónde están los registros cuando no aparece nada

Claude Desktop escribe un registro general de conexión y uno por cada servidor. En macOS están en ~/Library/Logs/Claude/ como mcp.log y mcp-server-NAME.log; en Windows en %APPDATA%\Claude\logs. El archivo de cada servidor contiene la salida de error propia del servidor, que es donde queda registrado un módulo que falta, una ruta incorrecta o una credencial rechazada. Si el archivo está vacío, la aplicación nunca llegó a arrancar el comando, lo que apunta de nuevo al PATH o a un error de sintaxis JSON en el archivo de configuración.

Una aplicación, dos superficies

Claude Desktop ahora incluye una pestaña Code que ejecuta Claude Code dentro de la aplicación, junto a la pestaña Chat. Los servidores declarados en claude_desktop_config.json están disponibles tanto en la superficie de chat como en las sesiones locales de la pestaña Code, junto a los de ~/.claude.json y el .mcp.json de un proyecto; cuando el mismo nombre existe en ambos sitios, la pestaña Code toma la definición del archivo de escritorio. Claude Code independiente, el de línea de comandos, no lee el archivo de escritorio. Si configuraste primero los servidores en la aplicación de escritorio y quieres tenerlos en la terminal, claude mcp add-from-claude-desktop los importa en macOS y en Windows Subsystem for Linux, tal como se describe en cómo añadir un servidor MCP a Claude Code.

Un servidor de monitorización remoto como primer conector

Un servidor remoto es la forma más rápida de confirmar que el flujo de conectores funciona, ya que no hay nada que instalar y la respuesta se puede comprobar. Añade el servidor de HostTracker como conector personalizado, inicia sesión cuando se te pida y pregúntale a Claude si un sitio que conoces está activo; la respuesta debería citar una comprobación ejecutada desde los puntos de control de HostTracker en ubicaciones concretas, no una suposición. La página del servidor MCP enumera las 65 herramientas y los permisos que necesita cada una, desde comprobaciones instantáneas hasta actualizaciones de páginas de estado.