Servidores MCP y extensiones en Claude Code

Preludio

La primera vez que conectamos un servidor MCP a Claude Code, el objetivo era mundano: consultar una base de datos Postgres mientras trabajábamos en una migración, sin cambiar entre terminales. Claude Code estaba abierto en un panel, una sesión de psql en otro, y un navegador con la documentación del esquema en un tercero. Era funcional pero fragmentado.

El Model Context Protocol apareció en un hilo sobre herramientas de IA. Tras confirmar que Claude Code lo soportaba nativamente, un servidor MCP de base de datos estaba funcionando en quince minutos. Claude podía consultar el esquema directamente. Sin cambiar de terminal. Sin copiar y pegar resultados de consultas.

Ese fue el momento en que los servidores MCP hicieron clic. No son plugins en el sentido tradicional. No son extensiones pegadas al costado de una aplicación. Son un protocolo de comunicación que permite a Claude Code hablar con cualquier sistema externo a través de una interfaz estandarizada. Bases de datos, APIs, sistemas de archivos, herramientas de monitorización, pipelines de despliegue. Si algo expone un servidor MCP, Claude Code puede usarlo con la misma naturalidad con la que lee archivos o ejecuta comandos de shell.

En EntendIA, hemos pasado meses construyendo sobre esto. Los servidores MCP forman la columna vertebral de cómo nuestros agentes de IA interactúan con servicios externos. Esta guía cubre todo lo que hemos aprendido sobre configurarlos en Claude Code, desde el primer comando claude mcp add hasta configuraciones gestionadas de nivel empresarial y subagentes personalizados.

El problema

Claude Code es notablemente capaz de serie. Lee archivos, escribe código, ejecuta comandos, busca en el código. Para un flujo de trabajo de desarrollo autocontenido, eso suele ser suficiente. Pero los proyectos reales no viven en aislamiento.

Tu aplicación habla con una base de datos. Tu equipo se comunica por Slack. Tu infraestructura funciona en AWS o GCP. Tus issues viven en Linear o Jira. Tu documentación vive en Notion o Confluence.

Sin servidores MCP, interactuar con estos sistemas desde Claude Code significa una de dos cosas. O ejecutas herramientas CLI desde el shell (lo cual funciona pero es frágil y verboso) o sales de Claude Code completamente y cambias de contexto a otra aplicación. Ambos enfoques rompen el flujo de la conversación. Pierdes el hilo de lo que estabas haciendo.

Los servidores MCP resuelven esto dando a Claude Code una forma estructurada de interactuar con herramientas externas. El Model Context Protocol es un estándar abierto desarrollado por Anthropic para conectar modelos de IA con fuentes de datos y herramientas externas. Define una arquitectura cliente-servidor donde Claude Code actúa como cliente y los servicios externos exponen capacidades a través de una API bien definida.

Cada servidor MCP declara qué herramientas ofrece, qué entradas esperan y qué salidas producen. Claude Code descubre estas herramientas al inicio y puede llamarlas durante una conversación igual que llama a sus herramientas integradas.

El protocolo gestiona la serialización, el manejo de errores y la gestión del ciclo de vida. No necesitas escribir código de adaptación ni construir integraciones personalizadas. Si existe un servidor MCP para el servicio que necesitas, conectarlo es un cambio de configuración, no un proyecto de desarrollo.

La diferencia práctica es significativa. En lugar de pedir a Claude que "ejecute esta consulta SQL y me diga qué dice", le pides que "compruebe cuántos usuarios se registraron esta semana" y él llama a la herramienta de base de datos directamente, interpreta los resultados y continúa la conversación. En lugar de decir "mira los últimos errores de Sentry", le pides a Claude que "busque cualquier nueva excepción relacionada con el módulo de pagos" y consulta tu sistema de seguimiento de errores en contexto.

Esta guía recorre cómo configurar todo esto.

El camino

Entendiendo los transportes MCP

Los servidores MCP se comunican con Claude Code a través de uno de tres mecanismos de transporte. El transporte determina cómo se intercambian los mensajes entre Claude Code y el proceso del servidor.

stdio es el transporte para servidores MCP locales. Claude Code lanza el servidor como un proceso hijo y se comunica a través de la entrada y salida estándar. Esta es la configuración más simple. El servidor se ejecuta en tu máquina, arranca y para con tu sesión de Claude Code, y tiene acceso a tu sistema de archivos local y red. La mayoría de los servidores MCP de la comunidad usan stdio.

claude mcp add --transport stdio my-database -- npx @modelcontextprotocol/server-postgres postgresql://localhost:5432/mydb

Ese comando registra un servidor MCP stdio llamado my-database. Cuando Claude Code arranca, lanza npx @modelcontextprotocol/server-postgres con la cadena de conexión como argumento. El servidor expone herramientas para consultar la base de datos, y Claude Code las descubre automáticamente.

HTTP es el transporte recomendado para servidores MCP remotos. Usa una conexión HTTP streaming donde Claude Code envía solicitudes y recibe respuestas sobre HTTP estándar. Este es el transporte que quieres para servicios MCP alojados, servidores compartidos de equipo o cualquier servidor que se ejecute en infraestructura que no gestionas directamente.

claude mcp add --transport http my-remote-server https://mcp.example.com/v1

El transporte HTTP soporta autenticación OAuth, que se cubre a continuación. Es la dirección en la que se mueve el ecosistema, y si estás construyendo o eligiendo servidores MCP hoy, HTTP debería ser tu opción por defecto para cualquier cosa remota. Para orientación sobre llevar servidores MCP del desarrollo a infraestructura fiable, nuestra guía sobre despliegue de servidores MCP en producción cubre la selección de transporte, la contenedorización y las preocupaciones operativas.

SSE (Server-Sent Events) fue el transporte original para servidores MCP remotos. Usa una conexión HTTP persistente con eventos enviados por el servidor para respuestas en streaming. A principios de 2026, SSE está obsoleto en favor del transporte HTTP. Todavía funciona, y encontrarás muchos servidores MCP existentes que lo usan, pero las nuevas implementaciones deberían usar HTTP. Claude Code trata SSE como una opción heredada.

claude mcp add --transport sse my-legacy-server https://mcp.example.com/sse

Una progresión típica empieza con un servidor stdio para Postgres, que tarda unos treinta segundos en configurar. Lo siguiente podría ser un servidor HTTP para la base de conocimientos compartida del equipo, que tarda un poco más porque implica OAuth. Luego un servidor SSE para una herramienta de monitorización antigua que aún no ha migrado. Los tres funcionan desde la misma sesión de Claude Code, y Claude puede usar herramientas de cualquiera de ellos indistintamente.

Instalación y gestión de servidores MCP

El comando claude mcp gestiona toda la administración de servidores MCP. Los subcomandos son sencillos.

# Añadir un servidor stdio
claude mcp add --transport stdio github-mcp -- npx @modelcontextprotocol/server-github

# Añadir un servidor HTTP
claude mcp add --transport http analytics-server https://analytics.example.com/mcp

# Listar todos los servidores configurados
claude mcp list

# Obtener detalles de un servidor específico
claude mcp get my-database

# Eliminar un servidor
claude mcp remove my-database

También puedes establecer variables de entorno para un servidor en el momento del registro. Esto es útil para servidores que necesitan claves de API o valores de configuración.

claude mcp add --transport stdio my-server -e API_KEY=your-api-key-here -e REGION=eu-west-1 -- npx some-mcp-server

Dentro de una sesión de Claude Code en ejecución, puedes gestionar servidores MCP interactivamente usando el comando slash /mcp. Esto abre un panel que muestra todos los servidores conectados, su estado y las herramientas disponibles. Puedes reiniciar un servidor que se ha caído, desconectar uno que ya no necesitas, o autenticarte con un servidor remoto que requiere OAuth.

Alcances y dónde vive la configuración

Cada servidor MCP que añades tiene un alcance que determina dónde se almacena su configuración y quién puede verlo. Este es uno de esos detalles que parece menor hasta que trabajas en equipo y alguien pregunta por qué su sesión de Claude Code no tiene el servidor de base de datos que configuraste ayer.

Alcance local es el predeterminado. Cuando ejecutas claude mcp add, la configuración del servidor se almacena en tus ajustes personales para el proyecto actual. Nadie más en el equipo lo ve. No se confirma en el control de versiones. Esto es correcto para herramientas personales, servidores experimentales o cualquier cosa que use tus credenciales personales.

Alcance de proyecto almacena la configuración en un archivo .mcp.json en la raíz de tu proyecto. Este archivo está destinado a ser confirmado en el control de versiones. Todos los que clonen el repositorio obtienen la misma configuración de servidor MCP.

claude mcp add --scope project shared-db -- npx @modelcontextprotocol/server-postgres $DATABASE_URL

El archivo .mcp.json tiene este aspecto.

{
  "mcpServers": {
    "shared-db": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    },
    "team-api": {
      "type": "http",
      "url": "https://mcp.team-tools.example.com/v1"
    }
  }
}

Observa la sintaxis ${DATABASE_URL}. Los servidores con alcance de proyecto pueden referenciar variables de entorno sin codificar secretos. Cada desarrollador establece la variable en su propio entorno, y el archivo .mcp.json se mantiene seguro para confirmar.

Alcance de usuario almacena la configuración globalmente para tu cuenta de usuario, en todos los proyectos. Úsalo para servidores MCP que quieras disponibles en todas partes, como una base de conocimientos personal o un servidor de utilidades de propósito general.

claude mcp add --scope user my-notes -- npx @modelcontextprotocol/server-notes ~/notes

El alcance local funciona bien para la mayoría de las cosas. El alcance de proyecto se adapta a la infraestructura compartida del equipo. El alcance de usuario encaja para el puñado de servidores que quieres disponibles en cada proyecto independientemente del contexto. La disciplina de elegir el alcance correcto ahorra confusión después.

Autenticación OAuth para servidores remotos

Los servidores MCP remotos a menudo requieren autenticación. El transporte HTTP soporta OAuth nativamente. Cuando te conectas a un servidor que requiere OAuth, Claude Code gestiona el flujo por ti.

La primera vez que usas un servidor que necesita autenticación, el comando /mcp en Claude Code te pedirá que autorices. Esto abre una ventana del navegador con la pantalla de consentimiento OAuth. Te autentificas, concedes permisos y el token se almacena de forma segura. Las sesiones posteriores reutilizan el token hasta que expira.

Esto importa porque significa que puedes conectarte a servidores MCP internos de la empresa que están detrás de SSO. El servidor implementa OAuth, Claude Code gestiona el flujo del lado del cliente y tu proveedor de identidad existente se encarga del resto. Sin claves de API que rotar. Sin credenciales en archivos de configuración.

Para servidores que usan autenticación más simple, puedes pasar tokens como variables de entorno.

claude mcp add --transport http my-api -e AUTH_TOKEN=your-token-here https://api.example.com/mcp

Servidores MCP proporcionados por plugins

Algunos plugins de Claude Code incluyen sus propios servidores MCP. Cuando instalas uno de estos plugins, el servidor MCP se gestiona automáticamente. Arranca cuando Claude Code arranca, para cuando Claude Code para y se actualiza cuando el plugin se actualiza.

Los servidores MCP proporcionados por plugins tienen acceso a una variable de entorno CLAUDE_PLUGIN_ROOT que apunta al directorio de instalación del plugin. Esto permite que el servidor encuentre sus archivos de configuración y recursos sin rutas codificadas.

La gestión del ciclo de vida es la ventaja clave aquí. Con un servidor MCP configurado manualmente, eres responsable de asegurar que el proceso del servidor esté ejecutándose, actualizarlo cuando se publiquen nuevas versiones y depurarlo cuando se caiga. Con un servidor proporcionado por un plugin, el sistema de plugins se encarga de todo eso. Instalas el plugin y las herramientas aparecen.

Los servidores proporcionados por plugins son particularmente útiles para servicios que requieren una configuración compleja. Un servidor MCP de Kubernetes, por ejemplo, necesita credenciales de clúster, configuración de contexto y valores predeterminados de namespace. Envolver todo eso en un plugin significa que la configuración sucede una vez y funciona consistentemente.

Subagentes personalizados

Aquí es donde los servidores MCP se conectan con algo más grande. Claude Code soporta subagentes personalizados, que son agentes de IA especializados que tienen su propio acceso a herramientas, selección de modelo y permisos. Los subagentes te permiten crear asistentes enfocados dentro de tu entorno de Claude Code.

Un subagente se define como un archivo markdown con frontmatter YAML. Lo colocas en .claude/agents/ para agentes específicos del proyecto o ~/.claude/agents/ para agentes disponibles en todos los proyectos. El cuerpo del markdown se convierte en el prompt del sistema del agente, y el frontmatter configura sus capacidades.

Aquí hay un subagente diseñado para trabajo con bases de datos.

---
name: "database-assistant"
description: "Queries and analyses the application database. Use for data questions, schema exploration, and migration planning."
tools:
  - "mcp:shared-db:query"
  - "mcp:shared-db:list_tables"
  - "mcp:shared-db:describe_table"
  - "Read"
model: "sonnet"
permissionMode: "default"
---

You are a database specialist. When asked about data or schema questions, use the database tools to query directly rather than guessing.

Always check the current schema before suggesting migrations. Use `describe_table` to verify column types and constraints.

When writing queries, prefer COUNT and aggregation for overview questions. Only return raw rows when specifically asked.

Never run DELETE, DROP, or TRUNCATE operations. If asked to modify data, write the query but do not execute it. Present it for review instead.

El campo tools controla a qué herramientas puede acceder el subagente. La sintaxis mcp:shared-db:query significa "la herramienta query del servidor MCP llamado shared-db". También puedes referenciar herramientas integradas como Read, Bash, Edit y Write. Si omites el campo tools completamente, el subagente obtiene acceso a todas las herramientas disponibles.

El campo model selecciona qué modelo de Claude usa el subagente. Tus opciones son sonnet, opus, haiku o inherit. La opción inherit usa el mismo modelo que la sesión padre.

sonnet funciona bien para la mayoría de los subagentes porque es rápido y capaz. Para tareas de razonamiento complejo, opus es la mejor opción. Para trabajo de alto volumen y baja complejidad como exploración de código, haiku mantiene los costes bajos.

El campo permissionMode controla cómo el subagente gestiona los permisos de herramientas. Los valores válidos son default (mismas reglas de permisos que la sesión padre), acceptEdits (auto-acepta ediciones de archivos pero pregunta para otras herramientas), dontAsk (nunca pregunta, omite herramientas no permitidas), bypassPermissions (permite todas las herramientas sin preguntar) y plan (modo de solo lectura para planificación y análisis).

Otras opciones de configuración incluyen hooks (para adjuntar flujos de trabajo basados en eventos al subagente), skills (para referenciar habilidades registradas que el agente puede usar) y memory (para definir contexto persistente que el agente lleva entre invocaciones).

Invocas un subagente desde Claude Code referenciándolo en la conversación. Escribe /agents para ver los agentes disponibles, o simplemente pide a Claude que delegue a un agente específico. Claude Code gestiona la transferencia, pasa el contexto y devuelve el resultado a tu conversación principal.

Subagentes integrados

Claude Code viene con tres subagentes integrados que cubren patrones comunes. Entenderlos te ayuda a diseñar los tuyos.

Explore es un agente de solo lectura que usa el modelo Haiku. Está diseñado para la exploración del código, respondiendo preguntas sobre la estructura del proyecto, encontrando archivos relevantes y resumiendo código. No puede modificar archivos ni ejecutar comandos. Como usa Haiku, es rápido y económico. Funciona especialmente bien para orientarse en códigos desconocidos.

Plan es un agente de solo lectura que hereda el modelo padre. Lee archivos y analiza código pero no puede hacer cambios. Está diseñado para planificar trabajo, crear esquemas de implementación e identificar dependencias. El modelo heredado significa que obtiene la misma potencia de razonamiento que tu sesión principal.

El subagente de propósito general hereda el modelo padre y tiene acceso a todas las herramientas. Este es el destino de delegación por defecto cuando Claude Code decide que necesita dividir una tarea en subtareas. Puede leer, escribir, ejecutar y llamar a cualquier servidor MCP configurado. Es esencialmente una sesión nueva de Claude Code enfocada en una tarea específica.

El patrón recomendado es usar los agentes integrados para trabajo general y crear subagentes personalizados para dominios especializados. Un asistente de base de datos solo ve herramientas de base de datos. Un agente de documentación solo ve herramientas de lectura y escritura de archivos. Un agente de despliegue solo ve herramientas de infraestructura. Cuanto más estrecho sea el acceso a herramientas, más enfocado y fiable será el subagente.

Búsqueda de herramientas MCP

A medida que añades más servidores MCP, el número de herramientas disponibles crece. Un servidor Postgres podría exponer cinco herramientas. Un servidor GitHub podría exponer veinte. Un servidor Kubernetes podría exponer treinta. Conecta los tres y tienes cincuenta y cinco herramientas compitiendo por espacio en la ventana de contexto de Claude.

Claude Code gestiona esto con un mecanismo automático de búsqueda de herramientas. Cuando el número total de herramientas disponibles supera aproximadamente el diez por ciento de la ventana de contexto, Claude Code activa la búsqueda de herramientas. En lugar de cargar cada descripción de herramienta en el contexto, carga un índice de búsqueda. Cuando Claude necesita una herramienta, busca en el índice primero, luego carga las descripciones de herramientas relevantes bajo demanda.

Esto es transparente para ti como usuario. No necesitas configurar nada. Pero vale la pena saberlo porque afecta cómo nombras y describes las herramientas de tu servidor MCP.

Nombres y descripciones de herramientas claros y descriptivos hacen la búsqueda más efectiva. Si tu servidor MCP personalizado tiene una herramienta llamada do_thing, Claude tendrá dificultades para encontrarla. Si se llama query_user_signups_by_date_range, Claude la encuentra inmediatamente. Al construir tu propio servidor MCP, invierte tiempo en nombrar las herramientas claramente desde el principio.

Esto se hace evidente rápidamente con nombres genéricos de herramientas como fetch, update y list. Claude a menudo elige la herramienta equivocada porque los nombres son ambiguos. Renombrarlas a fetch_customer_record, update_billing_address y list_recent_orders soluciona el problema por completo.

Gestión empresarial de MCP

Para organizaciones que ejecutan Claude Code en equipos de desarrollo, gestionar servidores MCP a escala requiere más que configuración individual. Claude Code proporciona controles de nivel empresarial a través de ajustes gestionados que permiten a los administradores definir qué servidores MCP están disponibles, son obligatorios o están prohibidos.

El archivo managed-mcp.json es la superficie de configuración empresarial. Los administradores despliegan este archivo para controlar la disponibilidad de servidores MCP en toda la organización. Se sitúa junto al archivo de ajustes gestionados y sigue una estructura similar.

{
  "mcpServers": {
    "company-knowledge-base": {
      "type": "http",
      "url": "https://kb.internal.example.com/mcp",
      "description": "Internal knowledge base and documentation search"
    },
    "approved-database": {
      "type": "stdio",
      "command": "npx",
      "args": ["@company/db-mcp-server"],
      "env": {
        "DB_HOST": "readonly-replica.internal.example.com"
      }
    }
  }
}

Los servidores MCP gestionados aparecen automáticamente en la sesión de Claude Code de cada desarrollador. Los desarrolladores no pueden eliminarlos ni modificarlos. Pueden añadir sus propios servidores junto a los gestionados, a menos que el administrador restrinja eso.

Para un control granular, los administradores pueden usar listas allowedMcpServers y deniedMcpServers. La lista de permitidos actúa como lista blanca: solo se pueden añadir servidores cuyos nombres coincidan. La lista de denegados actúa como lista negra: los servidores cuyos nombres coincidan se bloquean.

Estas usan coincidencia de patrones, así que puedes permitir company-* para autorizar cualquier servidor con el prefijo de la empresa mientras bloqueas todo lo demás. Para bloquear completamente el entorno, establece allowedMcpServers como un array vacío, lo que previene que los desarrolladores añadan cualquier servidor MCP más allá de la configuración gestionada.

{
  "allowedMcpServers": ["company-*", "approved-*"],
  "deniedMcpServers": ["*-experimental"]
}

Este enfoque por capas significa que puedes obligar ciertos servidores (vía managed-mcp.json), permitir un conjunto curado de servidores adicionales (vía allowedMcpServers) y bloquear patrones conocidos como problemáticos (vía deniedMcpServers). La combinación cubre la mayoría de los requisitos de gobernanza empresarial sin ser tan restrictiva que los desarrolladores no puedan trabajar eficazmente.

Consideraciones de seguridad

Los servidores MCP que hacen solicitudes de red introducen una superficie de seguridad. Un servidor MCP malicioso o mal configurado podría exfiltrar datos, conectarse a servicios no previstos o hacer solicitudes que violen las políticas de red. Para un tratamiento detallado de los patrones de autenticación y seguridad, consulta la guía sobre autenticación y seguridad de servidores MCP.

La combinación de servidores MCP gestionados, allowedMcpServers y deniedMcpServers da a los administradores un control por capas. Saben exactamente qué servidores MCP están ejecutándose y exactamente qué herramientas exponen esos servidores.

Para protección adicional, limita las credenciales de cada servidor MCP al acceso mínimo requerido. Un servidor MCP de base de datos debería conectarse a una réplica de solo lectura, no a la principal. Un servidor MCP de API debería usar un token con los permisos más estrechos posibles.

Para industrias con alta regulación, este nivel de control no es opcional. Para todos los demás, sigue siendo una buena práctica. Los detalles completos del bloqueo empresarial se cubren en la guía de ajustes gestionados.

Poniendo todo junto

Aquí está la configuración MCP que usamos diariamente en EntendIA. Esta es una configuración real, no un ejemplo inventado.

El .mcp.json (alcance de proyecto, confirmado en el repositorio) tiene este aspecto.

{
  "mcpServers": {
    "project-db": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Los servidores de alcance local (no confirmados) incluyen un servidor MCP de GitHub con un token de acceso personal y un servidor de búsqueda de archivos configurado para la estructura del monorepo.

Tres subagentes personalizados viven en .claude/agents/.

El database-assistant (mostrado antes) gestiona todas las consultas de datos y la planificación de migraciones. Usa Sonnet y solo tiene acceso a herramientas de base de datos.

Un review-agent que lee código y ejecuta análisis pero no puede modificar nada. Usa el modelo heredado y tiene herramientas Read, Glob, Grep y Bash. Su prompt del sistema le instruye a centrarse en la calidad del código, problemas de seguridad y preocupaciones arquitectónicas.

Un deploy-agent que tiene acceso a nuestro servidor MCP de infraestructura y puede comprobar el estado de despliegues, ver logs y activar despliegues a staging. Usa Sonnet y tiene permisos estrictos. Su prompt del sistema prohíbe despliegues a producción y requiere confirmación para cualquier operación que modifique.

Cada agente tiene un límite claro. El asistente de base de datos no sabe sobre despliegues. El agente de despliegue no ve la base de datos. El agente de revisión no puede cambiar nada. Esta separación hace que cada agente sea más fiable porque no puede confundirse con herramientas fuera de su dominio.

También usamos hooks junto con los servidores MCP. Un hook PostToolUse registra cada invocación de herramienta MCP en un archivo local, proporcionando un registro de auditoría de qué se consultó y cuándo. Un hook PreToolUse en el agente de despliegue requiere confirmación para cualquier llamada a herramienta que contenga la palabra "production" en sus argumentos.

Solución de problemas comunes de MCP

Los servidores MCP ocasionalmente fallan al conectar o se comportan de forma inesperada. Estos son los problemas más comunes y cómo resolverlos.

El servidor no arranca. Ejecuta claude mcp list y comprueba el estado del servidor. Si aparece como desconectado, el proceso del servidor probablemente se cayó al iniciar. Ejecuta el comando del servidor manualmente en un terminal (por ejemplo, npx @modelcontextprotocol/server-postgres postgresql://localhost:5432/mydb) para ver la salida de error directamente. Las dependencias faltantes y las cadenas de conexión incorrectas son las causas habituales.

Las herramientas no aparecen. Si un servidor aparece como conectado pero sus herramientas no aparecen, reinícialo con el comando slash /mcp en Claude Code. Si las herramientas siguen sin aparecer, el servidor puede no estar declarándolas correctamente. Usa claude mcp get <nombre-del-servidor> para inspeccionar la lista de herramientas.

Los avisos de permisos reaparecen. Claude Code recuerda tus decisiones de aprobación de herramientas por proyecto. Si quieres restablecer estas decisiones y empezar de cero, ejecuta claude mcp reset-project-choices. Esto es útil cuando has denegado una herramienta por error o cuando un servidor ha actualizado sus definiciones de herramientas.

Token OAuth expirado. Para servidores HTTP que usan OAuth, un token expirado causa fallos de autenticación. Abre el panel /mcp en Claude Code y vuelve a autenticarte con el servidor afectado. El flujo OAuth renovará tu token.

El servidor se cae durante la sesión. Si un servidor se cae durante una conversación, Claude Code mostrará un error cuando intente usar las herramientas de ese servidor. Usa el comando /mcp para reiniciar el servidor sin salir de tu sesión. El contexto de tu conversación se preserva.

La lección

Los servidores MCP transforman Claude Code de un asistente de código en un entorno de desarrollo que puede interactuar con toda tu pila tecnológica. Pero la verdadera lección no es sobre la tecnología. Es sobre los límites.

Las configuraciones MCP más efectivas comparten tres características. Son específicas en alcance. Tienen permisos claros. Separan responsabilidades a través de subagentes.

Las configuraciones menos efectivas conectan todo con todo. Cada servidor MCP disponible para cada conversación, cada herramienta accesible desde cada contexto. Ese enfoque lleva a una selección confusa de herramientas, acceso accidental a datos y puntos ciegos de seguridad.

Empieza con un servidor MCP que resuelva un punto de fricción real. Para la mayoría de los desarrolladores, eso es un servidor de base de datos o una herramienta de gestión de proyectos. Familiarízate con cómo se integra en tu flujo de trabajo. Luego añade un segundo. Luego considera si un subagente personalizado ayudaría a enfocar la interacción.

Para equipos empresariales, invierte en la configuración gestionada desde el principio. Configurar managed-mcp.json antes de que los desarrolladores empiecen a añadir sus propios servidores es mucho más fácil que bloquear las cosas retroactivamente. La guía de ajustes gestionados empresariales cubre la superficie de configuración completa.

El Model Context Protocol es un estándar abierto. El ecosistema de servidores disponibles está creciendo rápidamente. A principios de 2026, hay servidores de la comunidad para la mayoría de las principales bases de datos, proveedores cloud, herramientas de comunicación y plataformas de desarrollo. La documentación oficial de MCP mantiene un registro de servidores disponibles, y la documentación de subagentes cubre la superficie de configuración completa para agentes personalizados.

Conclusión

Esta guía comenzó con una configuración de terminal de tres paneles. Base de datos en uno, Claude Code en otro, documentación en un tercero. Esa configuración todavía funciona. Pero ya no es así como trabajamos.

Nuestra configuración actual es una sola sesión de Claude Code con servidores MCP conectados a la base de datos, la herramienta de gestión de proyectos y la infraestructura. Subagentes personalizados gestionan tareas especializadas. Los hooks registran todo y hacen cumplir las políticas.

El resultado no es solo más eficiente. Es más coherente. Cada interacción sucede dentro del mismo contexto, y Claude puede establecer conexiones entre un resultado de consulta de base de datos, un cambio de código y un estado de despliegue sin tener que conectar los puntos manualmente.

El Model Context Protocol es la capa que hace esto posible. No porque la tecnología sea particularmente compleja (es un protocolo cliente-servidor bastante sencillo) sino porque estandariza la interfaz entre la IA y las herramientas. Esa estandarización significa que configuras la conexión una vez y cada conversación futura se beneficia de ella.

Conecta tu primer servidor MCP hoy. El comando claude mcp add tarda treinta segundos. La diferencia de productividad se acumula desde la primera sesión.