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.

En este artículo
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.
Artículos relacionados
- MCP y agentesMejores servidores MCP para marketing en 2026Servidores MCP para marketing: analítica, anuncios, CRM, email y redes sociales, con lo que hace cada uno y cómo se conecta, según fuentes oficiales.Leer el artículo
- MCP y agentesPrecio de Claude Code: planes y costes (2026)¿Cuánto cuesta Claude Code? Depende de tu plan de Claude. Te explicamos qué incluyen Pro, Max, Team y la API y cómo seguir tu consumo (09-11-2026).Leer el artículo
- MCP y agentesClaude Code, Codex o Cursor: cuál elegirElige entre Claude Code, Codex y Cursor según tu forma de trabajar: qué es cada uno y dónde se usa, con datos de su documentación oficial.Leer el artículo
Llévalo a la práctica
- El gestor agéntico de redes socialesPrograma publicaciones en redes con Claude CodeConecta Clautia MCP a Claude Code. Tu agente redacta y programa en 10 redes (Google Business Profile incluido) desde la terminal.Leer la guía
- Funciones y redesServidor MCP y API para redes sociales que pone a tu agente de IA a trabajarConecta Claude Code, Codex, Cursor u otro agente compatible con MCP a Clautia con una clave de API. Redacta, programa y gestiona posts por MCP o API REST.Leer la guía
- El gestor agéntico de redes socialesConecta cualquier agente de IA a Clautia por MCPConecta cualquier agente al servidor MCP de Clautia con una URL y una clave de API. Mira si tu agente encaja, prueba la clave y gestiona confirmaciones.Leer la guía

