Tutorial de servidores MCP 2026: instala, configura, ejecuta

Qué es realmente MCP

El Model Context Protocol es una especificación publicada por Anthropic en noviembre de 2024. Define una forma estándar de que los modelos de lenguaje llamen a herramientas externas — y de que las herramientas externas se expongan a los modelos. Antes de MCP, cada integración de una herramienta de IA era a medida; MCP hace que las integraciones sean componibles.

La arquitectura es más sencilla de lo que el nombre sugiere. Un servidor MCP es un proceso que corre en tu máquina (o de forma remota, para los servidores hospedados). Cuando arranca Claude Code, lanza cada servidor MCP configurado, recibe la lista de herramientas que ese servidor ofrece y a partir de ahí puede invocar esas herramientas por nombre durante cualquier sesión. Toda la comunicación pasa por stdin/stdout usando JSON-RPC 2.0. Sin HTTP, sin puertos, sin configuración de red para los servidores locales.

Un tratamiento conceptual más a fondo está en la introducción ¿Qué es MCP?. Este artículo se centra en la puesta en marcha práctica.

Dónde vive la configuración

La configuración del servidor MCP vive en un archivo settings.json. Hay dos ubicaciones:

• ~/.claude/settings.json — global; aplica a todas las sesiones de Claude Code en esta máquina
• .claude/settings.json (en el directorio de un proyecto) — a nivel de proyecto; aplica solo cuando Claude Code corre en ese directorio y sobreescribe la configuración global para las claves nombradas

El archivo a nivel de proyecto es el que conviene usar para servidores específicos del proyecto (un servidor de base de datos limitado al string de conexión de un proyecto). El archivo global es para los servidores que quieres en todas partes (Fetch, GitHub).

La estructura básica de la configuración

La clave mcpServers en settings.json es un mapa de nombre de servidor a configuración del servidor. Cada configuración de servidor especifica cómo arrancar el proceso del servidor.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_fine_grained_token_here"
      }
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Algunas notas sobre esta estructura:

• El flag -y en npx instala el paquete si todavía no está presente. Es cómodo durante la puesta en marcha pero un poco más lento en el primer arranque. Puedes fijar una versión para evitarlo: @modelcontextprotocol/server-filesystem@0.6.0.
• Las credenciales van en el objeto env, no como argumentos de línea de comandos. Los argumentos quedan registrados; las variables de entorno no (por defecto).
• Los nombres de servidor (las claves) son arbitrarios — solo se usan en mensajes de error y en las descripciones de herramientas que ve Claude.

Los cinco servidores que instalar primero

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_TOKEN": "github_pat_..."
    }
  }
}

{
  "playwright": {
    "command": "npx",
    "args": ["-y", "@playwright/mcp@latest"]
  }
}

{
  "fetch": {
    "command": "uvx",
    "args": ["mcp-server-fetch"]
  }
}

Verificar que un servidor está funcionando

Tras editar tu settings.json, arranca una sesión nueva de Claude Code. En el prompt, pídele a Claude que liste las herramientas disponibles:

¿A qué herramientas MCP tienes acceso?

Claude debería listar los servidores que configuraste y las herramientas disponibles de cada uno. Si falta algún servidor, el fallo suele ser una de tres cosas:

1. El paquete no está instalado. El flag -y en npx lo va a instalar, pero la primera ejecución puede fallar si el registro de npm va lento o tu red tiene un firewall. Corre el comando npx a mano en una terminal para ver el error.
2. La ruta es incorrecta. El servidor Filesystem toma una ruta absoluta. Una ruta relativa o una ruta con un typo va a producir un fallo de arranque. Claude Code registra los errores de servidor MCP en ~/.claude/logs/ — revisa ahí primero.
3. La credencial no es válida. Si el servidor arranca pero sus herramientas devuelven errores, la causa más común es una clave de API caducada o mal configurada. Prueba la credencial directamente con curl o en el playground del proveedor antes de depurar la capa MCP.

Configuración a nivel de proyecto vs. global

Un patrón común en Septim: la configuración global tiene Fetch, Memory y Playwright — servidores útiles en cualquier proyecto. La configuración a nivel de proyecto tiene Filesystem (con la raíz del proyecto como ruta permitida), el servidor de base de datos del proyecto y GitHub (acotado al repo del proyecto).

Esta estructura significa que puedes entrar a cualquier directorio de proyecto y que Claude Code recoja automáticamente los servidores correctos sin tocar configuraciones a mano. El archivo de proyecto sobreescribe al archivo global para los servidores con el mismo nombre, así que puedes tener distintas conexiones de base de datos por proyecto sin que entren en conflicto.

Servidores MCP remotos

Anthropic añadió soporte para servidores MCP remotos (accedidos por SSE en lugar de stdio) a principios de 2026. La configuración usa una clave url en lugar de command y args:

{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Los servidores remotos son convenientes para servicios que mantienen sus propios endpoints MCP hospedados (Stripe y varios otros lo hacen). La contrapartida es un round-trip de red por cada llamada de herramienta y una credencial que viaja por el cable — usa solo remotos por HTTPS y trata el header de autorización con el mismo cuidado que tratarías una clave de API en una variable de entorno.

Consideraciones de seguridad antes de añadir más servidores

Cada servidor que añades amplía la superficie de ataque de tu sesión de Claude Code. La checklist de vulnerabilidades de servidor MCP cubre el marco de evaluación de 24 puntos. La versión corta para tutoriales:

• Instala solo servidores con un mantenedor organizacional activo o una empresa que los respalde
• Lee las descripciones de herramientas en el código fuente antes de instalar — las instrucciones maliciosas embebidas en los metadatos de las herramientas son un vector de ataque documentado (arXiv 2603.22489)
• Usa el alcance de credencial mínimo — un token de GitHub para leer un solo repo no debería tener acceso de escritura a todos los repos
• Mantén .claude/settings.json fuera de git si contiene credenciales

La lista curada completa de servidores que vale la pena correr — cada uno con su salvedad de seguridad — está en el artículo mejores servidores MCP 2026.