MCP con Claude: cómo conectar un MCP Server paso a paso

Para un servidor remoto

Necesitas la URL del servidor MCP y, si corresponde, las credenciales de autenticación necesarias. Claude utiliza la conexión remota desde la infraestructura correspondiente al servicio.

Para un servidor local

Necesitas el servidor instalado en tu equipo y la aplicación que vaya a ejecutarlo. Claude Desktop utiliza actualmente extensiones de escritorio para instalar servidores MCP locales.

Para Claude Code

Necesitas tener Claude Code instalado y disponer del comando necesario para iniciar el servidor, o bien de una URL para un servidor remoto.

Credenciales

Si el servidor utiliza autenticación, necesitarás el mecanismo de autenticación correspondiente, como OAuth o un token.

Paso 1: obtén la URL

Necesitas el endpoint del servidor MCP remoto. Debe ser la URL proporcionada por el servicio o por el desarrollador del servidor.

Paso 2: abre la configuración de conectores

En Claude, la documentación actual indica acceder a Personalizar → Conectores y utilizar Añadir conector personalizado.

Paso 3: introduce la URL

Introduce la URL del servidor MCP remoto y completa la configuración solicitada.

Paso 4: configura la autenticación

Si el servicio utiliza OAuth, sigue el proceso de autorización indicado por el propio conector. Algunas implementaciones pueden utilizar otros mecanismos de autenticación.

Paso 5: habilita el conector

Una vez configurado, puedes habilitar el conector para la conversación en la que quieres utilizarlo.

Instalar desde el directorio

En Claude Desktop puedes acceder a Configuración → Extensiones y explorar el directorio disponible. Las extensiones permiten instalar servidores MCP locales con un flujo similar al de una extensión.

Instalar una extensión personalizada

Si dispones de una extensión MCP local en formato .mcpb, la documentación actual permite instalarla desde Configuración → Extensiones → Configuración avanzada y seleccionar el archivo correspondiente.

Configuración

Después de instalar la extensión puedes configurar los campos solicitados, como claves API u otros parámetros que necesite el servidor.

Comprobar que funciona

La disponibilidad de las herramientas puede comprobarse desde la propia interfaz de Claude Desktop, utilizando el acceso a conectores y herramientas disponible en la conversación.

Servidor remoto HTTP

La documentación actual recomienda HTTP para servidores MCP remotos cuando está disponible.

claude mcp add --transport http notion https://mcp.notion.com/mcp

El formato general es:

claude mcp add --transport http <nombre> <url>

Servidor remoto con autenticación

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer TU_TOKEN"

Servidor local stdio

Para un servidor local que se inicia mediante un comando debes utilizar --transport stdio y colocar -- antes del comando que debe ejecutar Claude Code.

claude mcp add --transport stdio mi-servidor \
  -- npx -y @ejemplo/mcp-server

Servidor Python local

claude mcp add --transport stdio mi-servidor-python \
  -- python server.py

La separación mediante -- es importante porque permite que los argumentos posteriores sean enviados al proceso del servidor y no interpretados como opciones de Claude Code.

Haz una prueba concreta

Una buena prueba consiste en solicitar a Claude una tarea que requiera inequívocamente una capacidad del servidor. Por ejemplo, si conectaste una herramienta para consultar un sistema externo, formula una petición que necesite esos datos.

Claude puede decidir utilizar una herramienta cuando la petición corresponde con la descripción de la tool disponible. Una pregunta general sobre el servicio conectado no necesariamente provoca una llamada MCP.

Claude puede utilizar una herramienta MCP cuando la solicitud del usuario coincide con la capacidad descrita por esa herramienta y el servidor está correctamente conectado.

Por ejemplo, si conectas un servidor MCP que permite consultar un sistema de incidencias, una solicitud para buscar incidencias reales puede requerir una llamada a la herramienta.

En cambio, una pregunta puramente conceptual sobre cómo funciona ese sistema no necesariamente requiere utilizar el servidor.

Comprueba primero el servidor

Antes de culpar a Claude por un fallo de conexión, ejecuta el servidor directamente cuando sea posible y comprueba sus logs.

En Claude Code

Utiliza claude mcp list, claude mcp get nombre y /mcp para revisar el estado de la configuración.

La API de Anthropic permite definir un servidor MCP remoto mediante su URL y configurar el conjunto de herramientas que puede utilizarse desde una solicitud.

{
  "type": "url",
  "url": "https://example.com/mcp",
  "name": "mi-servidor"
}

El conector de la API está orientado a servidores MCP remotos. La documentación actual indica que esta superficie admite llamadas a tools y autenticación mediante Bearer/OAuth según la configuración del servidor.

Para conectar MCP con Claude primero debes identificar dónde se ejecuta el servidor.

Si es remoto, puedes utilizar un conector MCP personalizado mediante su URL y completar la autenticación necesaria.

Si es local, Claude Desktop dispone actualmente de extensiones de escritorio para instalar y administrar servidores MCP locales.

En Claude Code puedes registrar servidores remotos o locales desde la terminal utilizando claude mcp add.

Después de establecer la conexión debes comprobar que las herramientas aparecen correctamente y probar una solicitud que necesite realmente una de ellas.

Anthropic · Conectores personalizados usando MCP remoto

Anthropic · Servidores MCP locales en Claude Desktop

Claude Code · Conectar herramientas mediante MCP

Claude API · Conector MCP

Claude Platform · Servidores MCP remotos