MCP servers para Claude Code: cómo conectarlos y cuáles usar

Los servidores MCP son la forma de que Claude Code salga del repositorio y trabaje con el resto de herramientas del equipo: el gestor de incidencias, la monitorización de errores, la base de datos o el CRM. Esta guía explica qué es el Model Context Protocol, cómo se añade un servidor con claude mcp add, qué ámbitos existen, qué servidores tienen más sentido para una pyme o una agencia y qué precauciones de seguridad y de consumo de contexto hay que tomar.

¿Qué es MCP y para qué sirve en Claude Code?

El Model Context Protocol es un estándar de código abierto para conectar aplicaciones de IA con fuentes de datos y servicios externos; su web lo compara con un puerto USB-C para la IA, y lo soportan clientes como Claude, ChatGPT, VS Code o Cursor. Un servidor MCP expone «herramientas» que el modelo puede llamar: crear una incidencia en Jira, consultar un error en Sentry, leer una página de Notion o lanzar una consulta SQL.

La documentación de Claude Code da un criterio muy práctico: conecta un servidor cuando te descubras copiando datos de otra herramienta al chat. Si cada día pegas trazas de Sentry o descripciones de tickets, un servidor MCP permitirá que Claude las lea y actúe directamente.

¿Cómo se añade un servidor MCP a Claude Code?

Con el comando claude mcp add desde la terminal. Hay que elegir transporte:

HTTP: el recomendado para servidores remotos.
SSE: obsoleto; úsalo solo si el proveedor no ofrece HTTP.
stdio: para servidores que se ejecutan como proceso local en tu máquina.

Un servidor remoto por HTTP, como el de Notion:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Uno con cabecera de autenticación:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer tu-token"

Y uno local por stdio, pasándole una variable de entorno. El doble guion -- separa las opciones de Claude del comando del servidor:

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

Para gestionarlos: claude mcp list los muestra, claude mcp get notion enseña el detalle de uno y claude mcp remove notion lo elimina. Dentro de una sesión, el comando /mcp muestra el estado de cada servidor, permite activarlos o desactivarlos y lanza el inicio de sesión OAuth en el navegador para los servicios que lo requieren. Los tokens se guardan de forma segura y se renuevan solos.

Lee también: Claude Code precio: planes Pro, Max, Team y API en octubre de 2026

¿Qué ámbitos hay y dónde se guarda la configuración?

Cada servidor se registra en uno de tres ámbitos, que se eligen con --scope:

local (por defecto): solo en el proyecto actual y solo para ti. Se guarda en ~/.claude.json.
project: para todo el equipo. Se guarda en un archivo .mcp.json en la raíz del repositorio, pensado para versionarse.
user: disponible en todos tus proyectos, también en ~/.claude.json.

Un .mcp.json mínimo tiene este aspecto, y admite variables de entorno con la sintaxis ${VAR} o ${VAR:-valor_por_defecto}, lo que evita subir secretos al repositorio:

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

Por seguridad, los servidores definidos en el .mcp.json de un proyecto requieren aprobación explícita en las sesiones interactivas. Si quieres volver a decidir, claude mcp reset-project-choices reinicia esas elecciones.

¿Qué servidores MCP merece la pena conectar?

La documentación oficial pone ejemplos de servidores habituales. Estos son los que más valor aportan en equipos de desarrollo pequeños:

GitHub, para revisar PR, gestionar issues y consultar repositorios: claude mcp add --transport http github https://api.githubcopilot.com/mcp/ con una cabecera de autorización con tu token personal.
Sentry, para que Claude lea los errores de producción y proponga la corrección: claude mcp add --transport http sentry https://mcp.sentry.dev/mcp y después autenticación con /mcp.
Notion, para leer especificaciones y documentación interna.
Bases de datos mediante DBHub, siempre con un usuario de solo lectura: claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "postgresql://readonly:pass@host:5432/analytics".
Stripe (https://mcp.stripe.com) y HubSpot (https://mcp.hubspot.com/anthropic) para agencias que trabajan con pagos o CRM.

Para descubrir más, Anthropic mantiene un directorio de conectores revisados en claude.ai/directory. Nuestra recomendación es empezar por uno o dos servidores que eliminen el «copia y pega» más frecuente, y añadir otros solo cuando haya una necesidad clara.

¿Los servidores MCP consumen contexto y tokens?

Sí, y es un punto que se suele pasar por alto. Claude Code carga las definiciones de herramientas MCP de forma diferida por defecto, mediante búsqueda de herramientas, de modo que solo entran en el contexto los nombres y las instrucciones de cada servidor hasta que se usa una herramienta concreta. Aun así, la guía de costes recomienda:

Preferir herramientas de línea de comandos como gh, aws, gcloud o sentry-cli cuando existan, porque no añaden listados de herramientas al contexto.
Desactivar los servidores que no se estén usando desde /mcp.
Revisar con /context qué está ocupando espacio.

Las respuestas también tienen límites: Claude Code avisa cuando la salida de una herramienta MCP supera los 10.000 tokens y, por defecto, el máximo es de 25.000, ampliable con la variable MAX_MCP_OUTPUT_TOKENS.

¿Qué riesgos de seguridad tienen los servidores MCP?

Un servidor MCP es código o un servicio de terceros con acceso a lo que le des. La documentación insiste en verificar que confías en cada servidor y advierte de que los que obtienen contenido externo pueden exponerte a inyección de prompts: texto malicioso en una web o un ticket que intenta dar órdenes al modelo. Buenas prácticas:

Usa credenciales con el mínimo privilegio: usuarios de solo lectura en bases de datos y tokens con permisos acotados.
No apruebes servidores de un .mcp.json de un repositorio que no conoces.
Guarda los secretos en variables de entorno, nunca en el archivo versionado.
Combina MCP con reglas de permisos o hooks PreToolUse para exigir confirmación en las herramientas que escriben.

Por último, el camino también funciona a la inversa: claude mcp serve expone el propio Claude Code como servidor MCP para otros clientes, aunque en ese caso es el cliente quien debe pedir confirmación de cada llamada.