Guías prácticas

Cómo configurar un servidor MCP en Claude Code, Cursor y VS Code

Qué es el Model Context Protocol, cómo añadir un servidor a Claude Code, Cursor y VS Code, los servidores de referencia y las reglas de seguridad, según la documentación oficial.

Por Audryk · 20 octubre 2026

• Guías prácticas
• Agentes de programación
• Nuevas tecnologías de IA
• #guías
• #MCP
• #Claude Code

Un servidor MCP da a un agente de programación acceso a una herramienta externa: un repositorio de GitHub, una base de datos, un navegador, la documentación de una biblioteca. Esta guía explica el protocolo y después la configuración en tres clientes habituales. Los comandos y archivos proceden de la documentación oficial, verificada el 20-10-2026.

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar de código abierto para conectar aplicaciones de IA con sistemas externos: archivos locales, bases de datos, herramientas como un buscador o flujos de trabajo. Sus autores lo comparan con un puerto USB-C para aplicaciones de IA (modelcontextprotocol.io). Consulta también la entrada MCP del glosario.

• Qué expone un servidor: tools (acciones que el modelo puede ejecutar), resources (datos de contexto) y prompts (plantillas de instrucciones) (arquitectura de MCP).
• Dos transportes: stdio, cuando el cliente lanza el servidor como un proceso local en la misma máquina; Streamable HTTP, para un servidor remoto, que admite tokens bearer, claves de API y cabeceras personalizadas.

Añadir un servidor a Claude Code

Claude Code se configura desde la línea de comandos (Anthropic). Si aún no tienes instalado el agente, consulta nuestra guía Cómo instalar Claude Code y empezar a usarlo.

Servidor remoto (HTTP), la opción recomendada para servicios en línea:

# Sintaxis básica
claude mcp add --transport http <name> <url>

# Ejemplo real: conectar con Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

Servidor local (stdio): todo lo que va después de -- es el comando que inicia el servidor.

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

El transporte SSE está obsoleto: Anthropic recomienda HTTP cuando el servidor lo admite. Para gestionar los servidores:

# Listar todos los servidores configurados
claude mcp list

# Obtener los detalles de un servidor concreto
claude mcp get notion

# Eliminar un servidor
claude mcp remove notion

# (dentro de Claude Code) Comprobar el estado de los servidores
/mcp

Tres ámbitos (opción --scope):

• local (predeterminado): el proyecto actual, solo para ti, guardado en ~/.claude.json;
• project: compartido con tu equipo mediante un archivo .mcp.json en la raíz del repositorio, que se sube al control de versiones;
• user: todos tus proyectos, guardado en ~/.claude.json.

Un repositorio clonado no puede aprobar por sí mismo los servidores de su .mcp.json: quedan pendientes hasta que aceptes el cuadro de diálogo de confianza del espacio de trabajo. Ejemplo oficial con el servidor remoto de GitHub, autenticado con un token de acceso personal de alcance limitado:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

claude mcp add guarda la configuración sin validar el token: comprueba la conexión con /mcp.

Añadir un servidor a Cursor

Cursor ofrece instalación con un clic desde su Marketplace (página Customize, botón «Add to Cursor», inicio de sesión con OAuth), o configuración manual en un archivo mcp.json (Cursor):

• .cursor/mcp.json en el proyecto, para herramientas específicas del proyecto;
• ~/.cursor/mcp.json en tu directorio personal, para herramientas disponibles en todas partes.

Un servidor local lanzado con Node.js, tal como aparece en la documentación de Cursor:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Para un servidor remoto, la entrada usa una clave url (y opcionalmente headers) en lugar de command. Cursor admite stdio, SSE y Streamable HTTP, y resuelve la sintaxis ${env:NAME} para que puedas leer un secreto de una variable de entorno en lugar de escribirlo en texto plano.

Añadir un servidor a VS Code

En VS Code, abre la paleta de comandos (⇧⌘P en Mac, Ctrl+Shift+P en Windows y Linux) y ejecuta MCP: Add Server (Microsoft). Elige HTTP si el editor del servidor te da una URL, Command (stdio) si te da un comando. El ejemplo de la documentación, el servidor Playwright, necesita Node.js 18 o posterior:

node --version
npx --version

Elige Command (stdio) e introduce:

npx -y @playwright/mcp@latest

Asigna un ID al servidor (por ejemplo playwright) y elige dónde guardarlo:

• Global > Copilot Global: ~/.copilot/mcp-config.json, para todos tus espacios de trabajo;
• **.mcp.json en la raíz del espacio de trabajo**: para compartir con tu equipo (ajuste experimental chat.mcp.workspaceRootConfig.enabled);
• **.vscode/mcp.json o el mcp.json del perfil de usuario**: siguen disponibles, pero aparecen marcados como obsoletos en el flujo guiado.

Cuidado con el formato: los archivos portables usan la clave mcpServers, el formato de VS Code usa servers. La galería de servidores (vista previa) se abre al escribir @mcp en la vista de extensiones. Microsoft también recomienda comprobar que una herramienta del servidor se ha llamado realmente en tu sesión: una configuración añadida no demuestra que el agente la use.

Servidores de referencia

El proyecto MCP mantiene servidores de referencia para probar el protocolo: Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking y Time (ejemplos oficiales). Los servidores en TypeScript se ejecutan con npx, los de Python con uvx:

npx -y @modelcontextprotocol/server-memory

uvx mcp-server-git

Los servidores mantenidos por empresas para sus propias plataformas figuran en el repositorio modelcontextprotocol/servers.

Seguridad: reglas que seguir

Un servidor MCP local no es un complemento aislado en un sandbox: es un proceso ordinario que hereda tus variables de entorno, puede leer todo lo que tu cuenta puede leer (claves SSH, credenciales de nube, directorio personal) y puede abrir conexiones de red (modelcontextprotocol.io). Las recomendaciones oficiales:

• Haz inventario: elimina los servidores que ya no uses y sabe de dónde viene cada uno de los que quedan;
• Prefiere la versión remota cuando un servidor no necesita nada de tu máquina;
• Comprueba el editor y fija la versión en lugar de usar latest, con un hábito de actualización deliberado. El ejemplo de Playwright de VS Code usa @latest: adáptalo a tu propia política;
• Aísla los servidores de terceros (contenedor, sandbox o máquina virtual);
• Limita el acceso: credenciales por servidor, acceso al sistema de archivos restringido a un directorio concreto, solo lectura siempre que sea posible, salida de red limitada;
• Lee las descripciones de las herramientas: el modelo las lee como instrucciones, lo que abre la puerta a la inyección de prompts.

Anthropic también pide verificar que confías en cada servidor antes de conectarlo, sobre todo los que obtienen contenido externo (Anthropic). Cursor recomienda claves de API con permisos mínimos y, para integraciones críticas, revisar el código fuente (Cursor).

Para ir más lejos

• Las páginas de herramientas indican cuáles admiten MCP: Claude Code, Cursor, GitHub Copilot, Cline.
• Compara editores: Cursor, Devin Desktop o Copilot.
• Los riesgos del código generado: qué dicen los estudios sobre seguridad.

Fuentes

• Model Context Protocol: What is MCP?, verificado el 20-10-2026
• Model Context Protocol: Architecture overview, verificado el 20-10-2026
• Model Context Protocol: Example Servers, verificado el 20-10-2026
• Model Context Protocol: Local Server Security, verificado el 20-10-2026
• Claude Code Docs: Connect Claude Code to tools via MCP, verificado el 20-10-2026
• Cursor Docs: Model Context Protocol, verificado el 20-10-2026
• VS Code Docs: Add MCP servers in VS Code, verificado el 20-10-2026

Conclusión: añadir un servidor MCP requiere un comando o unas pocas líneas de JSON, pero un servidor local se ejecuta con tus permisos: instala solo servidores de editores identificados, con versiones fijadas y acceso limitado.

¿Ha detectado un error en este artículo? Comuníquenoslo · Nuestra política de correcciones