Conectar Claude Code a herramientas vía MCP

Claude Code puede conectarse a cientos de herramientas externas y fuentes de datos a través del Protocolo de Contexto de Modelo (MCP), un estándar de código abierto para integraciones de herramientas de IA. Los servidores MCP le dan a Claude Code acceso a tus herramientas, bases de datos y APIs.

​

Qué puedes hacer con MCP

Con servidores MCP conectados, puedes pedirle a Claude Code que:

• Implemente funciones desde rastreadores de problemas: “Agrega la función descrita en el problema JIRA ENG-4521 y crea un PR en GitHub.”
• Analice datos de monitoreo: “Revisa Sentry y Statsig para verificar el uso de la función descrita en ENG-4521.”
• Consulte bases de datos: “Encuentra correos electrónicos de 10 usuarios aleatorios que usaron la función ENG-4521, basándote 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 función.”

​

Servidores MCP populares

Aquí hay algunos servidores MCP comúnmente utilizados que puedes conectar a Claude Code:

​

Instalando servidores MCP

Los servidores MCP pueden configurarse de tres maneras diferentes dependiendo de tus necesidades:

​

Opción 1: Agregar 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 o scripts personalizados.

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

# Ejemplo real: Agregar servidor Airtable
claude mcp add airtable --env AIRTABLE_API_KEY=TU_CLAVE \
  -- npx -y airtable-mcp-server

​

Opción 2: Agregar un servidor SSE remoto

Los servidores SSE (Server-Sent Events) proporcionan conexiones de streaming en tiempo real. Muchos servicios en la nube usan esto para actualizaciones en vivo.

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

# Ejemplo real: Conectar a Linear
claude mcp add --transport sse linear https://mcp.linear.app/sse

# Ejemplo con encabezado de autenticación
claude mcp add --transport sse private-api https://api.company.com/mcp \
  --header "X-API-Key: tu-clave-aquí"

​

Opción 3: Agregar un servidor HTTP remoto

Los servidores HTTP usan patrones estándar de solicitud/respuesta. La mayoría de APIs REST y servicios web usan este transporte.

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

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

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

​

Gestionando tus servidores

Una vez configurados, puedes gestionar tus servidores MCP con estos comandos:

# Listar todos los servidores configurados
claude mcp list

# Obtener detalles para un servidor específico
claude mcp get github

# Remover un servidor
claude mcp remove github

# (dentro de Claude Code) Verificar estado del servidor
/mcp

# Esto crea command="cmd" que Windows puede ejecutar
claude mcp add my-server -- cmd /c npx -y @some/package

​

Alcances de instalación MCP

Los servidores MCP pueden configurarse en tres niveles de alcance diferentes, cada uno sirviendo propósitos distintos para gestionar la accesibilidad y compartición de servidores. 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 deberían compartirse.

# Agregar un servidor con alcance local (predeterminado)
claude mcp add my-private-server /path/to/server

# Especificar explícitamente alcance local
claude mcp add my-private-server --scope local /path/to/server

​

Alcance de proyecto

Los servidores con alcance de proyecto habilitan la colaboración en equipo almacenando configuraciones en un archivo .mcp.json en la 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 con alcance de proyecto, Claude Code automáticamente crea o actualiza este archivo con la estructura de configuración apropiada.

# Agregar un servidor con alcance de proyecto
claude mcp add shared-server --scope project /path/to/server

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

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

Por razones de seguridad, Claude Code solicita aprobación antes de usar servidores con alcance de proyecto desde archivos .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.

# Agregar un servidor de usuario
claude mcp add my-user-server --scope user /path/to/server

​

Eligiendo 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 por el equipo, herramientas específicas del proyecto, o servicios requeridos para colaboración
• Alcance de usuario: Utilidades personales necesarias en múltiples proyectos, herramientas de desarrollo, o servicios usados frecuentemente

​

Jerarquía de alcance y precedencia

Las configuraciones de servidor MCP siguen una jerarquía de precedencia clara. Cuando existen servidores con el mismo nombre en múltiples alcances, el sistema resuelve conflictos priorizando servidores con alcance local primero, seguido por servidores con alcance de proyecto, y finalmente 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 expansión de variables de entorno en archivos .mcp.json, permitiendo a los equipos compartir configuraciones mientras mantienen 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 entorno VAR
• ${VAR:-default} - Se expande a VAR si está establecida, de lo contrario usa default

Ubicaciones de expansión: Las variables de entorno pueden expandirse en:

• command - La ruta del ejecutable del servidor
• args - Argumentos de línea de comandos
• env - Variables de entorno pasadas al servidor
• url - Para tipos de servidor SSE/HTTP
• headers - Para autenticación de servidor SSE/HTTP

Ejemplo con expansión de variables:

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

Si una variable de entorno requerida no está establecida y no tiene valor predeterminado, Claude Code fallará al analizar la configuración.

​

Ejemplos prácticos

​

Ejemplo: Monitorear errores con Sentry

# 1. Agregar el servidor MCP de Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. Usar /mcp para autenticarte con tu cuenta de Sentry
> /mcp

# 3. Depurar problemas de producción
> "¿Cuáles son los errores más comunes en las últimas 24 horas?"
> "Muéstrame el stack trace para el error ID abc123"
> "¿Qué despliegue introdujo estos nuevos errores?"

​

Autenticar con servidores MCP remotos

Muchos servidores MCP basados en la nube requieren autenticación. Claude Code soporta OAuth 2.0 para conexiones seguras.

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

> /mcp

​

Agregar servidores MCP desde configuración JSON

Si tienes una configuración JSON para un servidor MCP, puedes agregarla directamente:

# 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":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

​

Importar servidores MCP desde Claude Desktop

Si ya has configurado servidores MCP en Claude Desktop, puedes importarlos:

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

claude mcp list 

​

Usar Claude Code como servidor MCP

Puedes usar Claude Code mismo como un servidor MCP al que otras aplicaciones pueden conectarse:

# Iniciar Claude como servidor MCP stdio
claude mcp serve

Puedes usar esto en Claude Desktop agregando esta configuración a claude_desktop_config.json:

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

​

Usar recursos MCP

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

​

Referenciar recursos MCP

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

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

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

​

Usar prompts MCP como comandos slash

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

​

Ejecutar prompts MCP

> /mcp__github__list_prs

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Error en flujo de login" alto