Conexión de un servidor MCP para extender el conjunto de herramientas de Claude Code
Las herramientas integradas de Claude Code (leer, editar, buscar, ejecutar comandos) son suficientes para la mayoría del trabajo en un repositorio local.
Busca en todas las páginas de la documentación
Las herramientas integradas de Claude Code (leer, editar, buscar, ejecutar comandos) son suficientes para la mayoría del trabajo en un repositorio local.
Un servidor MCP (Model Context Protocol) extiende ese conjunto de herramientas con capacidades externas, como consultar una base de datos o registrar un ticket en un rastreador de incidencias, sin salir de la misma sesión.
Tarjeta de receta de referencia rápida, lista para copiar y pegar.
# Añadir un servidor MCP a Claude Code (forma ilustrativa)
claude mcp add <nombre> <comando-para-iniciar-el-servidor>
# Listar los servidores actualmente conectados
claude mcp listCuándo usar esto:
Una forma común de esto: una sesión que necesita comprobar un rastreador de incidencias para obtener contexto antes de tocar el código.
# 1. Conectar un servidor una vez para el proyecto (las opciones exactas dependen del
# servidor; consulta su propia documentación para ver el comando preciso que espera)
claude mcp add issue-tracker npx -y some-issue-tracker-mcp-server
# 2. Confirmar que se conectó
claude mcp list
# issue-tracker connected
# 3. Iniciar una sesión normal; las herramientas del servidor ahora forman parte del conjunto de herramientas
claudeDentro de esa sesión, una indicación como "buscar el ticket ENG-482 y corregir el error que describe" ahora puede resolver la búsqueda a través de la herramienta del servidor conectado, y luego pasar directamente al bucle normal de leer-editar-ejecutar-verificar de Claude Code para el cambio de código en sí.
Lo que esto demuestra:
MCP es un tema lo suficientemente grande como para tener sus propias secciones dedicadas en este sitio. Esta página es intencionalmente una vista previa, no la imagen completa:
| Tema | Dónde profundizar |
|---|---|
| Conceptos básicos de MCP (servidores, herramientas, recursos, indicaciones) | sección mcp-core-concepts |
| Creación de su propio servidor MCP | sección building-mcp-servers |
| Opciones de transporte, autenticación, esquemas de herramientas | Páginas de referencia dentro de esas secciones |
| Alternativa | Usar cuando | No usar cuando |
|---|---|---|
| Solo herramientas integradas (leer, editar, buscar, ejecutar) | La tarea es completamente local para el repositorio | La tarea necesita datos o acciones de un sistema externo |
| Copiar y pegar manualmente desde una herramienta externa al chat | Una búsqueda única, sin necesidad repetida | La búsqueda o acción ocurre con la frecuencia suficiente como para que valga la pena automatizarla |
| Un script personalizado invocado a través del paso de ejecución | La interacción externa es lo suficientemente simple para una llamada CLI única | El sistema necesita acceso a herramientas estructurado y repetible en muchas sesiones |
MCP significa Model Context Protocol (Protocolo de Contexto del Modelo).
Es el protocolo que Claude Code utiliza para conectarse a servidores externos, de modo que sus herramientas formen parte del conjunto de herramientas disponible de una sesión.
Las herramientas integradas, los comandos de leer, editar, buscar y ejecutar, operan en el repositorio y la shell locales.
Las herramientas de un servidor MCP van más allá, hacia el sistema que el servidor fue construido para exponer, como una base de datos o un rastreador de incidencias.
No, una vez que un servidor está conectado, sus herramientas forman parte del conjunto de herramientas para esa sesión.
Claude Code elige entre herramientas integradas y herramientas MCP basándose en lo que requiere la tarea, de la misma manera que elige entre dos herramientas integradas cualesquiera.
El mecanismo sigue siendo el mismo: dependiendo de su modo de permisos, algunas llamadas a herramientas se aprueban automáticamente y otras solicitan confirmación.
Las llamadas a herramientas MCP participan en esa misma lógica en lugar de seguir reglas separadas.
Eso depende completamente de las herramientas que exponga el servidor.
Algunos servidores ofrecen herramientas de solo lectura, otros ofrecen herramientas que crean o modifican registros; consulte la documentación del servidor específico.
Es ilustrativo de la forma general: conectar un servidor por nombre con un comando que lo inicia.
Las opciones exactas pueden variar según la versión de Claude Code y el servidor en sí, así que consulte la documentación actual antes de confiar en la sintaxis precisa.
Esta página es una vista previa de nivel básico.
La sección mcp-core-concepts cubre el protocolo subyacente en profundidad, y la sección building-mcp-servers cubre cómo crear uno propio.
Sí, se pueden conectar varios servidores, y todas sus herramientas estarán disponibles junto con las herramientas integradas de Claude Code para esa sesión.
Una llamada a una herramienta de ese servidor fallará o el servidor no aparecerá como conectado.
Verificar la conexión con un comando de estado o lista después de añadir un servidor lo detecta antes de que interrumpa una tarea.
La conexión suele ser un paso de configuración único para un proyecto, no algo que se repite en cada sesión.
Una vez conectado, las herramientas del servidor están disponibles en sesiones posteriores sin necesidad de volver a conectar.
Un script único funciona para una sola llamada, pero un servidor MCP proporciona a Claude Code una herramienta estructurada y repetible que puede reutilizar en indicaciones y sesiones sin que usted escriba un nuevo script cada vez.
No, la creación de un servidor se cubre por separado en la sección building-mcp-servers.
Esta página solo previsualiza la conexión a uno existente.
Versiones de la pila: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifique los detalles actuales en platform.claude.com/docs antes de confiar en ellos.
Revisado por Chris St. John·Última actualización: 16 jul 2026