MCP en Claude: conectores, Claude Desktop y Claude Code

En corto: en claude.ai y Claude Desktop un servidor MCP remoto se añade como conector personalizado — pegas la URL, entras y listo. En Claude Code, con un solo claude mcp add --transport http o una entrada en .mcp.json. Abajo están los dos caminos paso a paso, con URLs reales de servidores que puedes conectar ahora mismo.

Si todavía no tienes claro qué es MCP ni en qué se diferencia un servidor remoto de uno local, empieza por el repaso de los servidores MCP: son cinco minutos de lectura.

Dónde se conecta MCP en Claude

Camino 1. Un conector en claude.ai y Claude Desktop

El conector se configura una vez en tu cuenta de Claude y después funciona en todas partes donde hayas entrado: en el navegador, en Desktop y en el móvil.

1. Abre Ajustes → Connectors.
2. Pulsa Add custom connector, ponle un nombre y pega la URL del servidor, por ejemplo https://twelver.app/api/mcp/v1/web-search.
3. Pulsa Connect: se abre una ventana de acceso. Entra en tu cuenta de Twelver y concede el acceso.
4. En un chat nuevo, abre el menú de herramientas y comprueba que el conector está activo. Pídele: «busca en internet qué ha sacado Claude esta semana» y llamará a web-search.

Un detalle que explica casi todas las quejas de «no se conecta»: la conexión con el servidor la abren los servidores de Anthropic, no tu ordenador. Por eso con un conector sólo se alcanzan servidores accesibles desde internet: un servidor en localhost no se puede añadir así, y para eso están Claude Code o Claude Desktop con configuración local.

Camino 2. Claude Code: claude mcp add

En Claude Code un servidor remoto se añade con un comando. La opción --transport http es obligatoria: sin ella el comando espera un proceso local.

claude mcp add --transport http twelver-web-search https://twelver.app/api/mcp/v1/web-search
claude mcp add --transport http twelver-image https://twelver.app/api/mcp/v1/image-generation

Después arranca claude y ejecuta /mcp: los servidores nuevos aparecen marcados como pendientes de acceso. Elige el servidor, entra desde el navegador y las herramientas aparecen en la sesión. Esa misma lista de /mcp muestra qué servidores hay conectados y cuántas herramientas tiene cada uno.

Dónde se guarda la configuración: tres ámbitos

Entrar con clave en lugar de OAuth

OAuth es cómodo, pero necesita navegador y cuenta registrada, y el token dura 7 días: después hay que repetir el acceso. Para un servidor sin navegador, para CI o simplemente para «configurar y olvidarse», es más práctica una clave en la cabecera Authorization. El botón de abajo emite una, sin registro:

claude mcp add --transport http --scope user twelver-web-search https://twelver.app/api/mcp/v1/web-search \
  --header "Authorization: Bearer sk-<tu-clave>"

En un .mcp.json de proyecto es mejor no poner la clave en el archivo: acabará en git. Claude Code expande variables de entorno dentro de ese archivo, así que la clave puede vivir en TWELVER_API_KEY:

{
  "mcpServers": {
    "twelver-web-search": {
      "type": "http",
      "url": "https://twelver.app/api/mcp/v1/web-search",
      "headers": {
        "Authorization": "Bearer ${TWELVER_API_KEY}"
      }
    }
  }
}

Herramientas lentas: generación de vídeo y timeouts

La búsqueda responde en segundos; la generación de vídeo tarda minutos: el servidor mantiene la llamada abierta hasta que el clip está listo. Si Claude Code corta la llamada antes, sube el timeout de ese servidor con el campo timeout (en milisegundos), o el de todos con la variable MCP_TOOL_TIMEOUT:

{
  "mcpServers": {
    "twelver-video": {
      "type": "http",
      "url": "https://twelver.app/api/mcp/v1/seedance-video-generation",
      "timeout": 600000
    }
  }
}

Qué llega exactamente como respuesta a una generación y cómo trabajar con ello está en el capítulo generación de imágenes y vídeo en Claude.

Arma tu propio conjunto

Marca las herramientas y abajo aparecerán las URLs de conector, una por conjunto. Esas mismas URLs sirven para claude mcp add en Claude Code.

Si no funciona

¿No trabajas sólo en Claude? El mismo esquema para Cursor, Codex y OpenCode.