Saltar al contenido
← Todos los artículos

Cómo añadir un servidor MCP a Claude Code

Añade un servidor MCP a Claude Code con un comando: sintaxis HTTP y cabeceras, ámbitos local, de proyecto y de usuario, .mcp.json y un ejemplo con Clautia.

John Guerrero, con barba y gafas redondasPor John GuerreroActualizado el 9 de noviembre de 2026
Ilustración abstracta: un rack de servidores en el que un solo comando desliza una unidad nueva en su hueco

Preguntas frecuentes

¿Qué comando añade un servidor MCP a Claude Code?

Para un servidor remoto, ejecuta claude mcp add --transport http seguido de un nombre y la URL del servidor. Si el servidor necesita una clave, añade --header con una cabecera Authorization. Claude Code guarda el servidor y carga sus acciones en las sesiones nuevas.

¿Qué diferencia hay entre el ámbito local, el de proyecto y el de usuario?

El local es el predeterminado y vale solo para ti en el proyecto actual. El de proyecto escribe en un archivo .mcp.json en la raíz, para que lo comparta todo el equipo. El de usuario vale para ti en todos tus proyectos. Si un servidor está definido en varios ámbitos, el local gana al de proyecto y este al de usuario.

¿Cómo compruebo que un servidor está conectado?

Ejecuta claude mcp list en la terminal o escribe /mcp dentro de una sesión de Claude Code para ver el estado de cada servidor. Si el servidor pide iniciar sesión con OAuth, /mcp también se encarga.

¿Dónde guardo la clave de API de un servidor MCP?

En una variable de entorno, no en un archivo que subas al repositorio. En un .mcp.json de proyecto puedes escribir la cabecera como Bearer ${CLAUTIA_API_KEY} y Claude Code la expande desde tu entorno. Así cada persona del equipo define su propia clave.

¿Por qué Claude Code dice que un servidor no ha podido conectarse?

Las causas habituales son una URL incorrecta, una clave que falta o está revocada, una variable de entorno sin definir en la terminal donde arrancó Claude Code o un transporte equivocado. Prueba la URL y la clave con curl fuera del agente y abre una sesión nueva.

¿Cómo elimino un servidor MCP?

Ejecuta claude mcp remove seguido del nombre del servidor. Si antes quieres ver sus datos y su ámbito, usa claude mcp get con el nombre.

¿Puede Claude Code usar hoy el servidor MCP de Clautia?

Sí. Clautia documenta la configuración para Claude Code, Codex y Cursor. Creas una clave de API en Clautia y añades el servidor con una cabecera bearer. El comando completo está en el ejemplo de abajo y en la página de Claude Code.