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.

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.

Resumen

Idea principal: MCP es un protocolo que permite a Claude Code conectarse a servidores externos, cada uno de los cuales expone su propio conjunto de herramientas que Claude Code puede llamar.
Por qué es importante: Las herramientas integradas solo acceden al sistema de archivos local y a la shell; un servidor MCP permite que una sesión acceda a una base de datos, un rastreador de incidencias o una API interna utilizando el mismo flujo de trabajo de leer-editar-ejecutar-verificar.
Conceptos clave: un servidor MCP (un proceso que expone herramientas), una conexión (registrar ese servidor con Claude Code) y el conjunto de herramientas combinado (herramientas integradas más las herramientas de los servidores conectados, disponibles una al lado de la otra durante el resto de la sesión).
Cuándo usarlo: Cualquier tarea que necesite información o acciones fuera del propio repositorio, como comprobar el estado de un ticket, buscar un registro o llamar a un servicio interno.
Limitaciones / Compensaciones: Esta página solo presenta la idea a un nivel básico; la conexión, la gestión de permisos y la creación de servidores MCP se cubren en profundidad en otras partes de este sitio.

Receta

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 list

Cuándo usar esto:

La tarea requiere datos que residen fuera del repositorio, una fila de base de datos, un ticket, una respuesta de API interna.
Desea que Claude Code registre o actualice algo en un sistema externo como parte de una tarea, como abrir una incidencia después de corregir un error.
Un equipo ya tiene un servidor MCP para un sistema que utiliza a diario y quiere que Claude Code lo utilice en lugar de copiar y pegar manualmente.
Está previsualizando lo que MCP puede hacer antes de dedicar tiempo a crear o configurar un servidor.

Ejemplo de trabajo

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
claude

Dentro 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:

Conectar un servidor es un paso de configuración único, separado de cualquier sesión individual.
Una vez conectado, las herramientas del servidor están simplemente disponibles, no se necesita una sintaxis especial para invocarlas en comparación con una herramienta integrada.
Una sola indicación puede mezclar una búsqueda externa con ediciones de archivos locales en un solo turno continuo.
El comando del servidor mostrado es ilustrativo; la sintaxis de invocación real varía según el servidor y la versión de Claude Code.

Profundización

Cómo funciona

Cada servidor MCP es un proceso separado que habla el Protocolo de Contexto del Modelo y declara las herramientas que ofrece.
Conectar un servidor lo registra con Claude Code para que sus herramientas se conviertan en parte del conjunto de herramientas para ese proyecto o sesión.
A partir de ese momento, Claude Code elige entre las herramientas integradas y las herramientas MCP de la misma manera que elige entre dos herramientas integradas cualesquiera, basándose en lo que necesita la tarea.
Las llamadas a herramientas MCP pasan por la misma lógica de permisos que los comandos integrados: dependiendo del modo de permisos, algunas llamadas pueden ser aprobadas automáticamente y otras pueden solicitar confirmación antes de ejecutarse.

Lo que esta página NO cubre

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

Posibles problemas

Asumir que cada servidor utiliza el mismo comando de conexión - Los comandos de inicio del servidor MCP varían según la implementación. Solución: consulte las instrucciones de configuración del servidor específico en lugar de reutilizar un comando de otro servidor.
Esperar que las herramientas MCP eviten las indicaciones de permisos - una herramienta conectada no se confía automáticamente solo porque está conectada. Solución: revise su modo de permisos; las llamadas a herramientas MCP siguen las mismas reglas de aprobación que los comandos integrados.
Conectar un servidor y nunca verificar que está activo - un servidor mal configurado puede fallar al iniciarse silenciosamente. Solución: ejecute un comando de lista/estado después de conectar para confirmar que el servidor es realmente accesible.
Tratar una mención de vista previa como la guía de configuración completa - esta página muestra la forma del flujo de trabajo, no cada opción y caso extremo. Solución: utilice las secciones dedicadas mcp-core-concepts y building-mcp-servers antes de conectar un servidor de producción.
Olvidar que un servidor conectado tiene un ámbito - un servidor añadido para un proyecto o sesión puede no aplicarse automáticamente en todas partes. Solución: confirme dónde se aplica una conexión determinada antes de asumir que está disponible en un proyecto diferente.

Alternativas

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

Preguntas frecuentes

¿Qué significa MCP y qué hace aquí?

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.

¿En qué se diferencia un servidor MCP de las herramientas integradas de Claude Code?

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.

¿Necesito escribir indicaciones especiales para usar una herramienta MCP?

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.

¿Conectar un servidor cambia la forma en que funcionan las indicaciones de permisos?

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.

¿Puede un servidor MCP registrar un ticket o escribir en una base de datos, no solo leer de ella?

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 el comando `claude mcp add` que se muestra aquí exacto?

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.

¿Dónde puedo aprender el modelo MCP completo, servidores, herramientas, recursos y indicaciones?

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.

¿Puedo conectar más de un servidor MCP a la vez?

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.

¿Qué sucede si un servidor MCP conectado no está realmente en ejecució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.

¿Conectar un servidor MCP es una configuración única o algo que hago en cada sesión?

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.

¿Por qué usaría un servidor MCP en lugar de simplemente pedirle a Claude Code que ejecute un script que llame a la API externa?

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.

¿Me enseña esta página a crear mi propio servidor MCP?

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.

Relacionados

Cómo Claude Code ejecuta el bucle Leer-Editar-Ejecutar-Probar - el flujo de trabajo en el que se integran las herramientas MCP
Cómo Claude Code decide cuándo ejecutar un comando vs. pedir permiso - la lógica de aprobación que también rige las llamadas a herramientas MCP
Conceptos básicos de MCP Core - comience aquí para el modelo MCP completo
Comprensión de las herramientas, recursos y indicaciones de MCP - lo que un servidor puede exponer más allá de las herramientas
Conceptos básicos del servidor MCP - cree su propio servidor en lugar de solo conectarse a uno

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.