El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto que permite a los LLMs acceder a herramientas externas y fuentes de datos. Para más detalles sobre MCP, consulta la documentación de MCP.

Usa servidores MCP de terceros bajo tu propio riesgo. Asegúrate de confiar en los servidores MCP, y ten especial cuidado al usar servidores MCP que se comunican con internet, ya que estos pueden exponerte a riesgo de inyección de prompts.

​
Configurar servidores MCP

1

Agregar un Servidor MCP stdio

# Sintaxis básica
claude mcp add <nombre> <comando> [argumentos...]

# Ejemplo: Agregando un servidor local
claude mcp add my-server -e API_KEY=123 -- /ruta/al/servidor arg1 arg2
2

Agregar un Servidor MCP SSE

# Sintaxis básica
claude mcp add --transport sse <nombre> <url>

# Ejemplo: Agregando un servidor SSE
claude mcp add --transport sse sse-server https://example.com/sse-endpoint

# Ejemplo: Agregando un servidor SSE con encabezados personalizados
claude mcp add --transport sse api-server https://api.example.com/mcp -e X-API-Key=your-key
3

Agregar un Servidor MCP HTTP

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

# Ejemplo: Agregando un servidor HTTP transmisible
claude mcp add --transport http http-server https://example.com/mcp

# Ejemplo: Agregando un servidor HTTP con encabezado de autenticación
claude mcp add --transport http secure-server https://api.example.com/mcp -e Authorization="Bearer your-token"
4

Gestionar tus servidores MCP

# Listar todos los servidores configurados
claude mcp list

# Obtener detalles para un servidor específico
claude mcp get my-server

# Eliminar un servidor
claude mcp remove my-server

Consejos:

  • Usa la bandera -s o --scope para especificar dónde se almacena la configuración:
    • local (predeterminado): Disponible solo para ti en el proyecto actual (se llamaba project en versiones anteriores)
    • project: Compartido con todos en el proyecto a través del archivo .mcp.json
    • user: Disponible para ti en todos los proyectos (se llamaba global en versiones anteriores)
  • Establece variables de entorno con las banderas -e o --env (ej., -e KEY=value)
  • Configura el tiempo de espera de inicio del servidor MCP usando la variable de entorno MCP_TIMEOUT (ej., MCP_TIMEOUT=10000 claude establece un tiempo de espera de 10 segundos)
  • Verifica el estado del servidor MCP en cualquier momento usando el comando /mcp dentro de Claude Code
  • MCP sigue una arquitectura cliente-servidor donde Claude Code (el cliente) puede conectarse a múltiples servidores especializados
  • Claude Code soporta servidores SSE (Server-Sent Events) y HTTP transmisibles para comunicación en tiempo real
  • Usa /mcp para autenticarte con servidores remotos que requieren autenticación OAuth 2.0

​
Entendiendo los ámbitos de servidor MCP

Los servidores MCP pueden configurarse en tres niveles de ámbito diferentes, cada uno sirviendo propósitos distintos para gestionar la accesibilidad y el intercambio de servidores. Entender estos ámbitos te ayuda a determinar la mejor manera de configurar servidores para tus necesidades específicas.

​
Jerarquía de ámbitos y precedencia

Las configuraciones de servidor MCP siguen una jerarquía de precedencia clara. Cuando existen servidores con el mismo nombre en múltiples ámbitos, el sistema resuelve conflictos priorizando primero los servidores de ámbito local, seguidos por los servidores de ámbito de proyecto, y finalmente los servidores de ámbito de usuario. Este diseño asegura que las configuraciones personales puedan anular las compartidas cuando sea necesario.

​
Ámbito local

Los servidores de ámbito local representan el nivel de configuración predeterminado y se almacenan en la configuración de usuario específica del proyecto. Estos servidores permanecen privados para ti y solo son accesibles cuando trabajas dentro del directorio del proyecto actual. Este ámbito es ideal para servidores de desarrollo personal, configuraciones experimentales, o servidores que contienen credenciales sensibles que no deberían compartirse.

# Agregar un servidor de ámbito local (predeterminado)
claude mcp add my-private-server /ruta/al/servidor

# Especificar explícitamente el ámbito local
claude mcp add my-private-server -s local /ruta/al/servidor

​
Ámbito de proyecto

Los servidores de ámbito de proyecto permiten la colaboración en equipo almacenando configuraciones en un archivo .mcp.json en el directorio raíz de tu proyecto. Este archivo está diseñado para ser incluido en el control de versiones, asegurando que todos los miembros del equipo tengan acceso a las mismas herramientas y servicios MCP. Cuando agregas un servidor de ámbito de proyecto, Claude Code automáticamente crea o actualiza este archivo con la estructura de configuración apropiada.

# Agregar un servidor de ámbito de proyecto
claude mcp add shared-server -s project /ruta/al/servidor

El archivo .mcp.json resultante sigue un formato estandarizado:

{
  "mcpServers": {
    "shared-server": {
      "command": "/ruta/al/servidor",
      "args": [],
      "env": {}
    }
  }
}

Por razones de seguridad, Claude Code solicita aprobación antes de usar servidores de ámbito de proyecto de archivos .mcp.json. Si necesitas restablecer estas opciones de aprobación, usa el comando claude mcp reset-project-choices.

​
Ámbito de usuario

Los servidores de ámbito de usuario proporcionan accesibilidad entre proyectos, haciéndolos disponibles en todos los proyectos en tu máquina mientras permanecen privados para tu cuenta de usuario. Este ámbito funciona bien para servidores de utilidad personal, herramientas de desarrollo, o servicios que usas frecuentemente en diferentes proyectos.

# Agregar un servidor de usuario
claude mcp add my-user-server -s user /ruta/al/servidor

​
Elegir el ámbito correcto

Selecciona tu ámbito basado en:

  • Ámbito local: Servidores personales, configuraciones experimentales, o credenciales sensibles específicas de un proyecto
  • Ámbito de proyecto: Servidores compartidos por el equipo, herramientas específicas del proyecto, o servicios requeridos para colaboración
  • Ámbito de usuario: Utilidades personales necesarias en múltiples proyectos, herramientas de desarrollo, o servicios usados frecuentemente

​
Autenticarse con servidores MCP remotos

Muchos servidores MCP remotos requieren autenticación. Claude Code soporta el flujo de autenticación OAuth 2.0 para conexión segura a estos servidores.

1

Agregar un servidor remoto que requiere autenticación

# Agregar un servidor SSE o HTTP que requiere OAuth
claude mcp add --transport sse github-server https://api.github.com/mcp
2

Autenticarse usando el comando /mcp

Dentro de Claude Code, usa el comando /mcp para gestionar la autenticación:

> /mcp

Esto abre un menú interactivo donde puedes:

  • Ver el estado de conexión para todos los servidores
  • Autenticarte con servidores que requieren OAuth
  • Limpiar la autenticación existente
  • Ver las capacidades del servidor
3

Completar el flujo OAuth

Cuando seleccionas “Autenticar” para un servidor:

  1. Tu navegador se abre automáticamente al proveedor OAuth
  2. Completa la autenticación en tu navegador
  3. Claude Code recibe y almacena de forma segura el token de acceso
  4. La conexión del servidor se vuelve activa

Consejos:

  • Los tokens de autenticación se almacenan de forma segura y se actualizan automáticamente
  • Usa “Limpiar autenticación” en el menú /mcp para revocar el acceso
  • Si tu navegador no se abre automáticamente, copia la URL proporcionada
  • La autenticación OAuth funciona con transportes tanto SSE como HTTP

​
Conectarse a un servidor MCP de Postgres

Supongamos que quieres dar a Claude acceso de solo lectura a una base de datos PostgreSQL para consultas e inspección de esquemas.

1

Agregar el servidor MCP de Postgres

claude mcp add postgres-server /ruta/al/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"
2

Consultar tu base de datos con Claude

> describe el esquema de nuestra tabla de usuarios

> ¿cuáles son los pedidos más recientes en el sistema?

> muéstrame la relación entre clientes y facturas

Consejos:

  • El servidor MCP de Postgres proporciona acceso de solo lectura por seguridad
  • Claude puede ayudarte a explorar la estructura de la base de datos y ejecutar consultas analíticas
  • Puedes usar esto para entender rápidamente esquemas de base de datos en proyectos desconocidos
  • Asegúrate de que tu cadena de conexión use credenciales apropiadas con los permisos mínimos requeridos

​
Agregar servidores MCP desde configuración JSON

Supongamos que tienes una configuración JSON para un solo servidor MCP que quieres agregar a Claude Code.

1

Agregar un servidor MCP desde JSON

# Sintaxis básica
claude mcp add-json <nombre> '<json>'

# Ejemplo: Agregando un servidor stdio con configuración JSON
claude mcp add-json weather-api '{"type":"stdio","command":"/ruta/al/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

Verificar que el servidor fue agregado

claude mcp get weather-api

Consejos:

  • Asegúrate de que el JSON esté correctamente escapado en tu shell
  • El JSON debe cumplir con el esquema de configuración del servidor MCP
  • Puedes usar -s global para agregar el servidor a tu configuración global en lugar de la específica del proyecto

​
Importar servidores MCP desde Claude Desktop

Supongamos que ya has configurado servidores MCP en Claude Desktop y quieres usar los mismos servidores en Claude Code sin reconfigurarlos manualmente.

1

Importar servidores desde Claude Desktop

# Sintaxis básica 
claude mcp add-from-claude-desktop
2

Seleccionar qué servidores importar

Después de ejecutar el comando, verás un diálogo interactivo que te permite seleccionar qué servidores quieres importar.

3

Verificar que los servidores fueron importados

claude mcp list

Consejos:

  • Esta característica solo funciona en macOS y Windows Subsystem for Linux (WSL)
  • Lee el archivo de configuración de Claude Desktop desde su ubicación estándar en esas plataformas
  • Usa la bandera -s global para agregar servidores a tu configuración global
  • Los servidores importados tendrán los mismos nombres que en Claude Desktop
  • Si ya existen servidores con los mismos nombres, obtendrán un sufijo numérico (ej., server_1)

​
Usar Claude Code como un servidor MCP

Supongamos que quieres usar Claude Code mismo como un servidor MCP al que otras aplicaciones puedan conectarse, proporcionándoles las herramientas y capacidades de Claude.

1

Iniciar Claude como un servidor MCP

# Sintaxis básica
claude mcp serve
2

Conectarse desde otra aplicación

Puedes conectarte al servidor MCP de Claude Code desde cualquier cliente MCP, como Claude Desktop. Si estás usando Claude Desktop, puedes agregar el servidor MCP de Claude Code usando esta configuración:

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

Consejos:

  • El servidor proporciona acceso a las herramientas de Claude como View, Edit, LS, etc.
  • En Claude Desktop, intenta pedirle a Claude que lea archivos en un directorio, haga ediciones, y más.
  • Ten en cuenta que este servidor MCP simplemente está exponiendo las herramientas de Claude Code a tu cliente MCP, por lo que tu propio cliente es responsable de implementar la confirmación del usuario para llamadas de herramientas individuales.

​
Usar recursos MCP

Los servidores MCP pueden exponer recursos que puedes referenciar usando menciones @, similar a como referencias archivos.

​
Referenciar recursos MCP

1

Listar recursos disponibles

Escribe @ en tu prompt para ver recursos disponibles de todos los servidores MCP conectados. Los recursos aparecen junto a los archivos en el menú de autocompletado.

2

Referenciar un recurso específico

Usa el formato @servidor:protocolo://recurso/ruta para referenciar un recurso:

> ¿Puedes analizar @github:issue://123 y sugerir una solución?

> Por favor revisa la documentación de la API en @docs:file://api/authentication
3

Referencias de múltiples recursos

Puedes referenciar múltiples recursos en un solo prompt:

> Compara @postgres:schema://users con @docs:file://database/user-model

Consejos:

  • Los recursos se obtienen automáticamente y se incluyen como adjuntos cuando se referencian
  • Las rutas de recursos son buscables de forma difusa en el autocompletado de menciones @
  • Claude Code automáticamente proporciona herramientas para listar y leer recursos MCP cuando los servidores los soportan
  • Los recursos pueden contener cualquier tipo de contenido que el servidor MCP proporcione (texto, JSON, datos estructurados, etc.)

​
Usar prompts MCP como comandos de barra

Los servidores MCP pueden exponer prompts que se vuelven disponibles como comandos de barra en Claude Code.

​
Ejecutar prompts MCP

1

Descubrir prompts disponibles

Escribe / para ver todos los comandos disponibles, incluyendo aquellos de servidores MCP. Los prompts MCP aparecen con el formato /mcp__nombreservidor__nombreprompt.

2

Ejecutar un prompt sin argumentos

> /mcp__github__list_prs
3

Ejecutar un prompt con argumentos

Muchos prompts aceptan argumentos. Pásalos separados por espacios después del comando:

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Error en el flujo de inicio de sesión" alto

Consejos:

  • Los prompts MCP se descubren dinámicamente desde servidores conectados
  • Los argumentos se analizan basándose en los parámetros definidos del prompt
  • Los resultados del prompt se inyectan directamente en la conversación
  • Los nombres de servidor y prompt se normalizan (los espacios se convierten en guiones bajos)