MCP en Claude Code: servidores, alcances y credenciales sin exponer secretos

Hola otra vez, y bienvenidos y bienvenidas a la cápsula cuatro del Módulo dos.

Hoy vemos el task statement dos punto cuatro: integrar servidores MCP en Claude Code y en los flujos de agentes. Un servidor MCP es un programa que ofrece herramientas y datos a un agente mediante un protocolo estándar, y Claude Code es la herramienta de Anthropic que trabaja con código.

Cada servidor se configura en un scope, que define quién lo ve. La guía nombra dos. Si el servidor es del equipo, entonces va en el scope de proyecto, que vive en el archivo punto mcp punto json, en la raíz del repositorio. El repositorio es la carpeta compartida donde el equipo guarda su código, con el historial de cambios. Ese archivo queda en el historial y lo usa todo el equipo. Por su parte, si el servidor es propio o experimental, entonces va en el scope de usuario, que vive en el archivo punto claude punto json de tu carpeta personal y es privado.

Un token es una clave de acceso a un servicio. En el archivo del proyecto no se escribe el token: se escribe una referencia a una variable de entorno, un valor guardado en el computador de cada persona, fuera del código. El archivo solo dice el nombre, con signo peso y llaves, y Claude Code lo reemplaza por el valor real al cargar.

Claude Code descubre las herramientas de todos los servidores configurados, y quedan disponibles a la vez. Por eso cada servidor que agregas suma herramientas a todas las decisiones del agente.

Un servidor también puede exponer resources: contenido de solo lectura identificado por una dirección, como el esquema de una base de datos, o sea sus tablas y columnas. Si el agente hace muchas llamadas exploratorias para descubrir qué datos existen, entonces conviene exponer ese catálogo como resource. Por su parte, si el agente ignora una herramienta MCP más capaz y usa una incluida que ya conoce, como Grep, que busca texto en archivos, entonces hay que mejorar la descripción de la herramienta MCP para que explique qué hace y qué devuelve. Además, si la integración es estándar, entonces se usa un servidor existente de la comunidad, y los servidores propios se reservan para flujos específicos del equipo.

Una pregunta. Una constructora quiere que su agente gestione tareas en una herramienta de proyectos muy usada en el mercado. ¿Construye su propio servidor MCP o busca uno existente?

Busca uno existente. Es una integración estándar, y construir un servidor propio solo se justifica para un flujo específico del equipo.

Dos preguntas de práctica. Pregunta uno. Una empresa minera tiene un servidor MCP que da acceso a su sistema de mantenimiento de equipos, y todo el equipo de desarrollo debe usarlo. El servidor necesita un token. ¿Cómo conviene configurarlo? Opción A: que cada persona lo configure a mano en su scope de usuario, con su propia copia del token. Opción B: en el archivo punto claude punto json de quien lidera el equipo, para que los demás lo copien. Opción C: en el archivo punto mcp punto json del proyecto, con el token escrito directamente, porque el repositorio es privado. Opción D: en el archivo punto mcp punto json del proyecto, con el token como referencia a una variable de entorno que cada persona define en su computador.

La correcta es D. Lo usa todo el equipo desde el archivo del proyecto, y la variable de entorno evita exponer la clave. La A obliga a repetir la configuración en cada computador. La B deja un servidor del equipo en un archivo personal. La C deja el token en el historial compartido, aunque el repositorio sea privado.

Pregunta dos, de respuesta múltiple. Elige dos. Una red de gimnasios tiene un agente que escribe consultas sobre su base de datos. Antes de cada consulta hace entre quince y veinte llamadas para descubrir qué tablas existen. Además, conectaron una herramienta MCP de búsqueda semántica, pero el agente usa casi siempre Grep, porque la descripción de esa herramienta dice solamente: busca manuales. Opción A: mejorar la descripción de la herramienta MCP para que explique qué hace y qué devuelve. Opción B: dejar que el agente siga explorando, porque descubrir la base con llamadas es más preciso. Opción C: exponer el esquema de la base como un resource del servidor MCP. Opción D: escribir en el system prompt, las instrucciones fijas del modelo, que el agente nunca use Grep. Opción E: agregar más servidores MCP con herramientas parecidas, para que alguna se use. ¿Cuáles dos?

Las correctas son A y C. El resource entrega el catálogo de datos en una sola lectura, en lugar de decenas de llamadas, y una descripción que explica qué hace y qué devuelve la herramienta MCP hace que el agente la prefiera sobre Grep. La B mantiene las llamadas exploratorias. La D ataca el síntoma sin dar información nueva. La E agrega herramientas, y eso empeora la selección.

Si te sirvió, sigue el podcast, dale cinco estrellas y activa las notificaciones. En la próxima cápsula vemos las herramientas incluidas de Claude Code: cuándo usar Grep, cuándo Glob y qué hacer si Edit falla. Nos escuchamos en la próxima cápsula de EvoAcademy.