Qué puedes hacer con MCP
Con servidores MCP conectados, puedes pedirle a Claude Code que:- Implemente características desde rastreadores de problemas: “Añade la característica descrita en el problema JIRA ENG-4521 y crea un PR en GitHub.”
- Analice datos de monitoreo: “Verifica Sentry y Statsig para comprobar el uso de la característica descrita en ENG-4521.”
- Consulte bases de datos: “Encuentra correos electrónicos de 10 usuarios aleatorios que usaron la característica ENG-4521, basándose en nuestra base de datos Postgres.”
- Integre diseños: “Actualiza nuestra plantilla de correo electrónico estándar basándote en los nuevos diseños de Figma que se publicaron en Slack”
- Automatice flujos de trabajo: “Crea borradores de Gmail invitando a estos 10 usuarios a una sesión de retroalimentación sobre la nueva característica.”
Servidores MCP populares
Aquí hay algunos servidores MCP comúnmente utilizados que puedes conectar a Claude Code:¿Necesitas una integración específica? Encuentra cientos más servidores MCP en GitHub, o crea el tuyo propio usando el SDK de MCP.
Instalación de servidores MCP
Los servidores MCP se pueden configurar de tres formas diferentes según tus necesidades:Opción 1: Añade un servidor HTTP remoto
Los servidores HTTP son la opción recomendada para conectarse a servidores MCP remotos. Este es el transporte más ampliamente soportado para servicios basados en la nube.Opción 2: Añade un servidor SSE remoto
Opción 3: Añade un servidor stdio local
Los servidores stdio se ejecutan como procesos locales en tu máquina. Son ideales para herramientas que necesitan acceso directo al sistema u scripts personalizados.Entendiendo el parámetro ”—”:
El
-- (doble guión) separa las banderas CLI propias de Claude del comando y argumentos que se pasan al servidor MCP. Todo lo anterior a -- son opciones para Claude (como --env, --scope), y todo lo posterior a -- es el comando real para ejecutar el servidor MCP.Por ejemplo:claude mcp add --transport stdio myserver -- npx server→ ejecutanpx serverclaude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080→ ejecutapython server.py --port 8080conKEY=valueen el entorno
Gestión de tus servidores
Una vez configurados, puedes gestionar tus servidores MCP con estos comandos:Servidores MCP proporcionados por complementos
Los complementos pueden agrupar servidores MCP, proporcionando automáticamente herramientas e integraciones cuando el complemento está habilitado. Los servidores MCP de complementos funcionan de manera idéntica a los servidores configurados por el usuario. Cómo funcionan los servidores MCP de complementos:- Los complementos definen servidores MCP en
.mcp.jsonen la raíz del complemento o en línea enplugin.json - Cuando se habilita un complemento, sus servidores MCP se inician automáticamente
- Las herramientas MCP del complemento aparecen junto a las herramientas MCP configuradas manualmente
- Los servidores de complementos se gestionan a través de la instalación del complemento (no a través de comandos
/mcp)
.mcp.json en la raíz del complemento:
plugin.json:
- Ciclo de vida automático: Los servidores se inician cuando se habilita el complemento, pero debes reiniciar Claude Code para aplicar cambios en el servidor MCP (habilitación o deshabilitación)
- Variables de entorno: Usa
${CLAUDE_PLUGIN_ROOT}para rutas relativas al complemento - Acceso a variables de entorno del usuario: Acceso a las mismas variables de entorno que los servidores configurados manualmente
- Múltiples tipos de transporte: Soporte para transportes stdio, SSE e HTTP (el soporte de transporte puede variar según el servidor)
- Distribución agrupada: Herramientas y servidores empaquetados juntos
- Configuración automática: No se necesita configuración manual de MCP
- Consistencia del equipo: Todos obtienen las mismas herramientas cuando se instala el complemento
Alcances de instalación de MCP
Los servidores MCP se pueden configurar en tres niveles de alcance diferentes, cada uno sirviendo propósitos distintos para gestionar la accesibilidad del servidor y el intercambio. Entender estos alcances te ayuda a determinar la mejor manera de configurar servidores para tus necesidades específicas.Alcance local
Los servidores con alcance local representan el nivel de configuración predeterminado y se almacenan en tu 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 alcance es ideal para servidores de desarrollo personal, configuraciones experimentales o servidores que contienen credenciales sensibles que no deben compartirse.Alcance de proyecto
Los servidores con alcance de proyecto permiten la colaboración en equipo al almacenar configuraciones en un archivo.mcp.json en el directorio raíz de tu proyecto. Este archivo está diseñado para ser verificado en el control de versiones, asegurando que todos los miembros del equipo tengan acceso a las mismas herramientas y servicios MCP. Cuando añades un servidor con alcance de proyecto, Claude Code crea o actualiza automáticamente este archivo con la estructura de configuración apropiada.
.mcp.json resultante sigue un formato estandarizado:
.mcp.json. Si necesitas restablecer estas opciones de aprobación, usa el comando claude mcp reset-project-choices.
Alcance de usuario
Los servidores con alcance 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 alcance funciona bien para servidores de utilidad personal, herramientas de desarrollo o servicios que usas frecuentemente en diferentes proyectos.Elegir el alcance correcto
Selecciona tu alcance basándote en:- Alcance local: Servidores personales, configuraciones experimentales o credenciales sensibles específicas de un proyecto
- Alcance de proyecto: Servidores compartidos en equipo, herramientas específicas del proyecto o servicios requeridos para la colaboración
- Alcance de usuario: Utilidades personales necesarias en múltiples proyectos, herramientas de desarrollo o servicios frecuentemente utilizados
Jerarquía de alcance y precedencia
Las configuraciones del servidor MCP siguen una clara jerarquía de precedencia. Cuando existen servidores con el mismo nombre en múltiples alcances, el sistema resuelve conflictos priorizando primero los servidores con alcance local, seguidos por los servidores con alcance de proyecto y finalmente los servidores con alcance de usuario. Este diseño asegura que las configuraciones personales puedan anular las compartidas cuando sea necesario.Expansión de variables de entorno en .mcp.json
Claude Code soporta la expansión de variables de entorno en archivos .mcp.json, permitiendo a los equipos compartir configuraciones mientras se mantiene flexibilidad para rutas específicas de máquina y valores sensibles como claves API.
Sintaxis soportada:
${VAR}- Se expande al valor de la variable de entornoVAR${VAR:-default}- Se expande aVARsi está establecida, de lo contrario usadefault
command- La ruta del ejecutable del servidorargs- Argumentos de línea de comandosenv- Variables de entorno pasadas al servidorurl- Para tipos de servidor HTTPheaders- Para autenticación de servidor HTTP
Ejemplos prácticos
Ejemplo: Monitorear errores con Sentry
Ejemplo: Conectar a GitHub para revisiones de código
Ejemplo: Consultar tu base de datos PostgreSQL
Autenticarse con servidores MCP remotos
Muchos servidores MCP basados en la nube requieren autenticación. Claude Code soporta OAuth 2.0 para conexiones seguras.1
Añade el servidor que requiere autenticación
Por ejemplo:
2
Usa el comando /mcp dentro de Claude Code
En Claude Code, usa el comando:Luego sigue los pasos en tu navegador para iniciar sesión.
Añadir servidores MCP desde configuración JSON
Si tienes una configuración JSON para un servidor MCP, puedes añadirla directamente:1
Añadir un servidor MCP desde JSON
2
Verifica que el servidor fue añadido
Importar servidores MCP desde Claude Desktop
Si ya has configurado servidores MCP en Claude Desktop, puedes importarlos:1
Importar servidores desde Claude Desktop
2
Selecciona qué servidores importar
Después de ejecutar el comando, verás un diálogo interactivo que te permite seleccionar qué servidores deseas importar.
3
Verifica que los servidores fueron importados
Usar Claude Code como servidor MCP
Puedes usar Claude Code mismo como servidor MCP al que otras aplicaciones pueden conectarse:Límites de salida de MCP y advertencias
Cuando las herramientas MCP producen salidas grandes, Claude Code ayuda a gestionar el uso de tokens para evitar abrumar tu contexto de conversación:- Umbral de advertencia de salida: Claude Code muestra una advertencia cuando cualquier salida de herramienta MCP excede 10,000 tokens
- Límite configurable: Puedes ajustar los tokens de salida MCP máximos permitidos usando la variable de entorno
MAX_MCP_OUTPUT_TOKENS - Límite predeterminado: El máximo predeterminado es 25,000 tokens
- Consultan grandes conjuntos de datos o bases de datos
- Generan informes o documentación detallados
- Procesan archivos de registro extensos o información de depuración
Usar recursos MCP
Los servidores MCP pueden exponer recursos que puedes referenciar usando menciones @, similar a cómo referencias archivos.Referenciar recursos MCP
1
Listar recursos disponibles
Escribe
@ en tu indicación para ver los recursos disponibles de todos los servidores MCP conectados. Los recursos aparecen junto a archivos en el menú de autocompletado.2
Referenciar un recurso específico
Usa el formato
@server:protocol://resource/path para referenciar un recurso:3
Múltiples referencias de recursos
Puedes referenciar múltiples recursos en una sola indicación:
Usar indicaciones MCP como comandos de barra
Los servidores MCP pueden exponer indicaciones que se vuelven disponibles como comandos de barra en Claude Code.Ejecutar indicaciones MCP
1
Descubrir indicaciones disponibles
Escribe
/ para ver todos los comandos disponibles, incluyendo los de servidores MCP. Las indicaciones MCP aparecen con el formato /mcp__servername__promptname.2
Ejecutar una indicación sin argumentos
3
Ejecutar una indicación con argumentos
Muchas indicaciones aceptan argumentos. Pásalos separados por espacios después del comando:
Configuración MCP empresarial
Para organizaciones que necesitan control centralizado sobre servidores MCP, Claude Code soporta configuraciones MCP gestionadas por empresas. Esto permite a los administradores de TI:- Controlar a qué servidores MCP pueden acceder los empleados: Desplegar un conjunto estandarizado de servidores MCP aprobados en toda la organización
- Prevenir servidores MCP no autorizados: Opcionalmente restringir a los usuarios de añadir sus propios servidores MCP
- Deshabilitar MCP completamente: Eliminar la funcionalidad MCP completamente si es necesario
Configurar configuración MCP empresarial
Los administradores del sistema pueden desplegar un archivo de configuración MCP empresarial junto al archivo de configuración gestionada:- macOS:
/Library/Application Support/ClaudeCode/managed-mcp.json - Windows:
C:\ProgramData\ClaudeCode\managed-mcp.json - Linux:
/etc/claude-code/managed-mcp.json
managed-mcp.json usa el mismo formato que un archivo .mcp.json estándar:
Restringir servidores MCP con listas de permitidos y listas de denegados
Además de proporcionar servidores gestionados por empresas, los administradores pueden controlar qué servidores MCP los usuarios pueden configurar usandoallowedMcpServers y deniedMcpServers en el archivo managed-settings.json:
- macOS:
/Library/Application Support/ClaudeCode/managed-settings.json - Windows:
C:\ProgramData\ClaudeCode\managed-settings.json - Linux:
/etc/claude-code/managed-settings.json
allowedMcpServers):
undefined(predeterminado): Sin restricciones - los usuarios pueden configurar cualquier servidor MCP- Array vacío
[]: Bloqueo completo - los usuarios no pueden configurar ningún servidor MCP - Lista de nombres de servidor: Los usuarios solo pueden configurar los servidores especificados
deniedMcpServers):
undefined(predeterminado): Ningún servidor está bloqueado- Array vacío
[]: Ningún servidor está bloqueado - Lista de nombres de servidor: Los servidores especificados están explícitamente bloqueados en todos los alcances
- Estas restricciones se aplican a todos los alcances: usuario, proyecto, local e incluso servidores empresariales desde
managed-mcp.json - La lista de denegados tiene precedencia absoluta: Si un servidor aparece en ambas listas, será bloqueado
Precedencia de configuración empresarial: La configuración MCP empresarial tiene la precedencia más alta y no puede ser anulada por configuraciones de usuario, local o proyecto.