Claude Code MCP
Si Claude Code es un excelente mecanógrafo (generación de código) y probador (validación de código), entonces agregar MCP (Model Context Protocol, Protocolo de Contexto del Modelo) le da a Claude verdaderamente sentidos externos y manos y pies: ya no se limita a los archivos de código del proyecto actual, sino que puede conectarse proactivamente con recursos y herramientas del mundo exterior, convirtiéndose en tu socio de colaboración de desarrollo de extremo a extremo.
¿Qué es MCP (Model Context Protocol)?
MCP es un protocolo estandarizado y abierto lanzado por Anthropic, diseñado específicamente para resolver el dolor central de la colaboración entre IA y herramientas externas.
La lógica central de MCP revoluciona el enfoque tradicional: no hacer que la IA aprenda las reglas de uso de cada herramienta una por una, sino hacer que todas las herramientas proporcionen una interfaz unificada a la IA.
Esta lógica es como un enchufe universal en la vida real: no es necesario que los electrodomésticos se adapten a diferentes enchufes; si el enchufe tiene un estándar unificado, todos los electrodomésticos se pueden usar directamente.
Después de conectarte a un servidor MCP, puedes hacer que Claude Code:
- Obtener requisitos de JIRA/sistemas de tickets y desarrollar funciones, crear PRs de GitHub
- Analizar datos de monitoreo de Sentry, localizar errores de producción
- Consultar datos de bases de datos como PostgreSQL/MySQL
- Actualizar código basado en diseños de Figma, generar automáticamente borradores de correos, etc.

¿Por qué Claude Code necesita MCP?
Antes de MCP, las capacidades de Claude Code estaban estrictamente limitadas a la carpeta del proyecto que tienes abierto actualmente, como un asistente que mira el cielo desde el fondo de un pozo: solo ve el código frente a él y no puede percibir ninguna información fuera del proyecto. La llegada de MCP rompe por completo este aislamiento de información, permitiendo que Claude participe profundamente en todo el flujo de desarrollo.
Con algunos ejemplos comparativos de escenarios intuitivos, podrás entender rápidamente el valor de MCP:
| Escenario | Sin MCP | Con MCP |
|---|---|---|
| Análisis entre repositorios | Solo puede analizar el código dentro de la carpeta actual, sin poder relacionar otros repositorios | Colaboración entre repositorios: 'Ayúdame a analizar el documento de interfaz del repositorio A y luego escribe el método de llamada correspondiente en el repositorio B' |
| Sincronización de requisitos/discusiones | Requiere que copies y pegues manualmente los documentos de requisitos y los registros de discusión del equipo en el cuadro de diálogo | Sincronizar información de colaboración en tiempo real: 'Revisa el registro de discusión en el canal #feature-x de Slack y mira las sugerencias de modificación de todos para esta función' |
| Verificación de base de datos | No puede verificar directamente la compatibilidad entre el código y la base de datos; solo puede consultar manualmente la estructura de la tabla | Enlace directo con la base de datos: 'Ve a consultar la estructura de la tabla users en MySQL y los primeros 5 registros, para determinar si mi interfaz de consulta de usuarios coincide' |
| Procesos automatizados | Solo puede generar fragmentos de código para que los copies y uses manualmente | Ejecución automatizada: 'Ayúdame a escribir un script de automatización de navegador y, a través de MCP, llama a Puppeteer para ejecutarlo y verificar la lógica de interacción de la página de inicio de sesión' |
En pocas palabras, MCP transforma a Claude Code de un asistente que recibe información pasivamente a un socio colaborativo que obtiene información y ejecuta acciones de forma proactiva.
Uso básico de MCP en Claude Code
Claude Code incluye capacidades completas de gestión de MCP, con un único comando principal:
claude mcp
Subcomandos comunes:
| Comando | Función |
|---|---|
claude mcp add |
Añadir un servidor MCP |
claude mcp list |
Ver todos los servidores configurados |
claude mcp get <name> |
Ver detalles de un servidor |
claude mcp remove <name> |
Eliminar servidor |
/mcp |
Ver estado / autenticación en Claude Code |
Instalar servidor MCP
Los servidores MCP admiten tres métodos de conexión: HTTP/SSE/stdio. Se recomienda usar HTTP primero (SSE está obsoleto).
1. Servidor HTTP remoto (recomendado)
Adecuado para herramientas tipo servicio en la nube; es la forma más universal:
# 基础语法 claude mcp add --transport http <服务器名称> <服务器URL> # 示例1:连接Notion claude mcp add --transport http notion https://mcp.notion.com/mcp # 示例2:带身份验证的HTTP服务器 claude mcp add --transport http secure-api https://api.example.com/mcp \ --header "Authorization: Bearer 你的令牌"
2. Servidor SSE remoto (obsoleto)
Solo es compatible con herramientas antiguas; usa HTTP como reemplazo prioritario:
# 基础语法(仅兼容用) claude mcp add --transport sse <服务器名称> <服务器URL> # 示例:连接Asana claude mcp add --transport sse asana https://mcp.asana.com/sse
3. Servidor stdio local
Adecuado para herramientas que requieren acceso al sistema local (como bases de datos locales, scripts personalizados):
# 基础语法(注意:--前是Claude参数,--后是服务器命令) claude mcp add --transport stdio [--env 环境变量] <服务器名称> -- <启动命令> # 示例:连接Airtable(需替换自己的API密钥) claude mcp add --transport stdio --env AIRTABLE_API_KEY=你的密钥 airtable \ -- npx -y airtable-mcp-server
Nota clave:
--transport/--envLos parámetros como estos deben colocarseantes del nombre del servidor,--Se usan para separar los parámetros de Claude del comando del servidor, evitando conflictos de parámetros.
Gestionar servidores MCP
Una vez completada la configuración, puedes gestionar el servidor con los siguientes comandos:
# 列出所有已配置的服务器 claude mcp list # 查看指定服务器详情(如github) claude mcp get github # 删除指定服务器 claude mcp remove github # 在Claude Code中检查服务器状态 /mcp
Alcance de configuración (controlar la visibilidad del servidor)
Puedes especificar el alcance de aplicación del servidor MCP para adaptarte a escenarios de uso personal/equipo:
| Alcance | Uso | Ejemplo de comando de configuración |
|---|---|---|
| local (predeterminado) | Solo disponible para el proyecto actual; configuración privada (como claves sensibles) | claude mcp add --scope local ... |
| project | Compartido por el equipo (almacenado en .mcp.json, se puede enviar al repositorio de versiones) | claude mcp add --scope project ... |
| user | Disponible para todos los proyectos (configuración global personal) | claude mcp add --scope user ... |
Prioridad: local > project > user (para servidores con el mismo nombre, la configuración local sobrescribe la configuración compartida)
Ejemplos prácticos
Ejemplo 1: Revisión de código de GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
En Claude Code:
> Review PR #456 and suggest improvements > Show me all open PRs assigned to me
Ejemplo 2: Solución de problemas de producción con Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
> /mcp # 完成 OAuth 登录 > What are the most common errors in the last 24 hours?
Ejemplo 3: Consultar PostgreSQL directamente
claude mcp add --transport stdio db \ -- npx -y @bytebase/dbhub \ --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"
> Show me the schema for the orders table > Which users haven't purchased in 90 days?
Formas avanzadas de usar MCP en conversaciones
1. Uso@para referenciar recursos MCP
> Analyze @github:issue://123 and suggest a fix
Admite comparación de múltiples recursos:
> Compare @postgres:schema://users with @docs:file://user-model
2. MCP Prompt como comando de barra
MCP puede exponer comandos:
/mcp__github__list_prs /mcp__jira__create_issue "Login bug" high
Claude los ejecutará como si fueran comandos integrados.
Consideraciones clave
- Autenticación: los servidores MCP remotos (como GitHub/Sentry) requieren, en Claude Code,
/mcpcompletar la autorización OAuth 2.0; - Compatibilidad con Windows: para servidores stdio locales que usen npx, se debe agregar
cmd /cel envoltorio (como-- cmd /c npx -y 包名), de lo contrario se reportará el error "Connection closed"; - Riesgo de terceros: al usar servidores MCP no oficiales, debes confirmar que la fuente sea confiable para evitar riesgos de inyección de prompts/seguridad;
- Orden de los parámetros: al configurar un servidor stdio,
--los parámetros que van antes y después no se pueden invertir; de lo contrario, la ejecución fallará.