Cómo conectar un MCP en Claude Code, paso a paso

Conectar un MCP a Claude Code cabe en una línea: claude mcp add mi-servidor -- npx -y @paquete/mcp-server. Quien busca claude code mcp normalmente ya usa Claude Code a diario y quiere que hable con algo de fuera: una base de datos, un repositorio de GitHub, un sistema interno de la empresa. Lo que suele faltar no es el comando, es entender qué protocolo es este y dónde encaja frente a un skill.

¿Cómo funciona Claude Code?

Claude Code es la interfaz de línea de comandos de Anthropic: se instala con un comando, se lanza con claude dentro de un proyecto y desde ahí lee archivos, ejecuta comandos y hace commits en la misma sesión de terminal. Por defecto solo ve lo que hay en el proyecto. Para que hable con un sistema externo (una API, una base de datos, un servicio de terceros) necesita un conector, y ese conector es un servidor MCP.

Qué es un servidor MCP y para qué sirve

MCP son las siglas de Model Context Protocol, un protocolo abierto creado por Anthropic (hoy gobernado por la Agentic AI Foundation) que estandariza cómo un modelo se conecta a herramientas y datos externos. Antes de MCP, cada integración (Slack, una base de datos, un CRM) exigía su propio código a medida. Con MCP, el servidor expone sus herramientas con un formato común y cualquier cliente compatible, Claude Code incluido, las descubre y las usa sin escribir ese puente a mano.

Una búsqueda habitual con esta misma intención es claude skills mcp server: cómo montar un servidor MCP propio para que lo use un skill, en vez de instalar uno ya publicado. La keyword hermana, skills mcp claude code, es la misma pregunta en otro orden. En ambos casos la respuesta es la misma: un servidor MCP es un proceso aparte (puede correr en local o en remoto) que declara sus herramientas una vez, y Claude Code se conecta a él como cliente.

Cómo conectar un servidor MCP en Claude Code

El comando base es claude mcp add, seguido del nombre que le quieras dar a la conexión y de cómo arrancarlo:

1
claude mcp add mi-servidor -- npx -y @paquete/mcp-server

Ese comando registra un servidor local que se lanza como proceso (stdio). Si el servidor vive en remoto, el transporte a usar es HTTP (SSE está obsoleto y se mantiene solo por compatibilidad) y el flag cambia:

1
claude mcp add --transport http mi-servidor https://mi-servidor.com/mcp

Con la conexión registrada, claude mcp list muestra todos los servidores activos y, dentro de una sesión, el comando /mcp lista las herramientas que cada uno expone y su estado de conexión. La primera vez que Claude quiera usar una de esas herramientas, pide autorización explícita, igual que con cualquier otra acción sensible.

Algunos servidores necesitan una clave de API. Se pasa con -e:

1
claude mcp add mi-servidor -e API_KEY=xxxx -- npx -y @paquete/mcp-server

Si ya tienes servidores MCP configurados en Claude Desktop, claude mcp add-from-claude-desktop los importa sin volver a escribir cada uno (disponible en macOS y WSL).

Alcance y permisos: dónde vive cada conexión

Cada conexión se registra en uno de tres alcances, y la diferencia importa más de lo que parece a primera vista:

• Local (por defecto): solo para ti, solo en este proyecto. No se comparte ni se sube al repositorio.
• Project: se guarda en un archivo .mcp.json en la raíz del proyecto, pensado para subir a git y compartir con el equipo.
• User: global, aplica a todos tus proyectos en esta máquina.

El alcance se fija con --scope local|project|user. En nuestra experiencia, el error más habitual es subir a .mcp.json un servidor que lleva una clave de API en texto plano: ese archivo se comparte con todo el equipo (y con quien clone el repositorio), así que las credenciales van en variables de entorno, nunca escritas dentro del propio archivo de configuración.

Skills vs MCP en Claude Code: cuándo usar cada uno

La duda de fondo, skills vs mcp claude, no tiene una respuesta genérica: dependen de si el trabajo es razonar y ejecutar pasos, o conectarse a un sistema que ya existe fuera de Claude Code. Un skill es una carpeta con instrucciones, scripts y plantillas que fija cómo Claude resuelve una tarea repetida: la lógica vive dentro del proyecto y la escribes tú. Un servidor MCP es al revés, un puente hacia algo que ya existe y que no vas a reescribir: la base de datos de producción, el Jira de la empresa, el CRM. No compiten entre sí. Un skill bien construido llama a un MCP cuando el paso que necesita es “habla con este sistema externo”, en vez de intentar reimplementar esa conexión con código propio.

La pregunta útil no es cuál de los dos usar en general, es de dónde viene el dato o la acción que necesitas: si vive dentro del proyecto y la tarea se repite igual cada vez, un skill. Si vive fuera y ya tiene una API, un MCP.

Problemas habituales al conectar un MCP

La mayoría de fallos entran en tres categorías. Si claude mcp list no muestra el servidor recién añadido, casi siempre es un error de sintaxis en el comando de arranque, no del protocolo en sí: conviene probar ese mismo comando fuera de Claude Code primero. Si el servidor aparece pero sus herramientas no salen en /mcp, el servidor ha fallado al arrancar (revisa sus logs) o exige una autenticación que todavía no se completó. Y si un servidor remoto usa OAuth, el token puede caducar; se renueva abriendo /mcp y eligiendo Re-authenticate en ese servidor, o con el comando claude mcp login <nombre>.

Con esos tres puntos cubiertos, conectar un MCP en Claude Code es un comando y una decisión de alcance, no una integración que haya que programar desde cero.