Qué es MCP
MCP (Model Context Protocol) es el estándar que permite a Claude Code conectarse a herramientas y datos externos: una base de datos, el correo, un gestor de tareas, un navegador. Sin MCP, Claude solo ve tus archivos y la terminal. Con MCP puedes pedirle cosas como «busca los correos de 10 usuarios que usaron esta función en nuestra base de datos» o «crea borradores en Gmail para invitarlos», ejemplos de la documentación oficial.
Añadir un servidor remoto (HTTP)
La mayoría de servicios actuales se añaden con una dirección web. La forma general y un ejemplo con Notion:
claude mcp add --transport http <nombre> <url>claude mcp add --transport http notion https://mcp.notion.com/mcpLos servidores que solo ofrecen una dirección SSE se añaden con el mismo comando; Claude Code prueba primero HTTP y cambia a SSE si hace falta.
Añadir un servidor que corre en tu ordenador (stdio)
Otros servidores son un programa que se ejecuta en tu equipo. Se añaden con -- (doble guion) para separar las opciones de Claude del comando del servidor:
claude mcp add example --env API_KEY=tu-clave -- npx -y @example/mcp-serverSi las instrucciones de un servidor están escritas para otro programa (Claude Desktop, Cursor…) y no traen el comando de Claude Code, busca en ellas una dirección https:// (servidor remoto) o un comando de arranque como npx -y … (servidor local) y conviértelo con las plantillas de arriba.
Ver, probar y quitar
claude mcp listLista tus servidores con su estado: conectado, necesita autenticación o fallo al conectar.claude mcp get notionDetalle de un servidor concreto.claude mcp remove notionLo quita./mcpDentro de Claude Code: gestiona los servidores y autentícate en los que lo piden.Alcance: ¿para quién es?
localPor defecto. Solo tú y solo en el proyecto donde lo añadiste.projectSe guarda en .mcp.json y se comparte con tu equipo (con --scope project).userDisponible para ti en todos tus proyectos (con --scope user).Antes de conectar nada
Un servidor MCP le da a Claude acceso real a una herramienta: puede leer, y a veces escribir. Conecta solo servidores de fuentes de confianza, mira qué permisos pide y empieza por uno de solo lectura. La documentación oficial también avisa de que un fallo de conexión significa que Claude Code no pudo contactar con el servidor, no necesariamente que tu configuración esté mal. Más sobre este riesgo en permisos de un agente de IA.
Preguntas frecuentes
¿Qué es MCP en Claude Code?
El Model Context Protocol es un estándar para conectar Claude Code a herramientas externas, como bases de datos, correo o gestores de tareas, mediante servidores MCP.
¿Cómo añado un servidor MCP?
Con claude mcp add --transport http
¿Cómo veo qué servidores MCP tengo?
En la terminal, claude mcp list muestra cada servidor con su estado. Dentro de Claude Code, el comando /mcp los gestiona.
¿Cómo quito un servidor MCP?
Con claude mcp remove seguido del nombre del servidor.
¿Es seguro usar servidores MCP?
Depende del servidor. Le dan a Claude acceso real a una herramienta, así que conviene usar solo fuentes de confianza y empezar por permisos de solo lectura.
