Servidores MCP de Claude Code: Guía de Configuración y Mejores Extensiones para Añadir

Hola, soy Lena. Algo hizo clic para mí hace unas semanas y he estado intentando entender por qué tardó tanto en suceder.

Había estado usando Claude Code regularmente — ejecutando comandos de shell, editando archivos, revisando refactorizaciones paso a paso. Útil, pero todavía un poco aislado. Luego conecté un servidor GitHub MCP y le pedí que revisara un pull request, verificara errores relacionados en Sentry y actualizara el ticket de Jira. Una sesión. Tres servicios. Funcionó.

Ahí fue cuando dejó de sentirse como un envoltorio inteligente para la terminal y empezó a sentirse como algo más componible. Esta guía es lo que desearía haber tenido antes de pasar dos horas leyendo documentación fragmentada y problemas de GitHub para llegar allí.

Cómo Funciona MCP Dentro de Claude Code

Claude Code es un cliente MCP. Esa distinción importa. Por sí solo, puede leer archivos, ejecutar comandos bash, buscar en el código y llamar a la API de Anthropic. Eso ya es mucho. Pero no puede tocar tus repositorios de GitHub, tus tablas de Postgres o tus marcos de Figma sin algo que los conecte.

Ese algo es MCP — un estándar de código abierto para integraciones de herramientas de IA. Cuando agregas un servidor MCP, Claude Code obtiene acceso a nuevas herramientas: consultar una base de datos, leer tickets de Jira o interactuar con servicios externos.

Cómo Claude Code maneja las llamadas a herramientas

Cuando Claude Code decide que necesita llamar a una herramienta MCP, no la ejecuta de inmediato. Claude Code muestra un aviso de permiso antes de llamar a cualquier herramienta MCP — mostrando el nombre de la herramienta y sus argumentos de entrada para que puedas revisar lo que va a hacer antes de ejecutarlo.

Los nombres de las herramientas siguen un formato estructurado: mcp__<server-name>__<tool-name>. Entonces, la herramienta de lectura del servidor del sistema de archivos se convierte en mcp__filesystem__read_file. Esa convención de nombres importa si estás preaprobando herramientas en entornos sin interfaz o de CI.

Lo que MCP agrega que las herramientas integradas no hacen

Las herramientas nativas de Claude Code manejan bien los entornos locales. Lo que no hacen: acceder a servicios externos, consultar bases de datos o extraer información de rastreadores de incidencias. MCP extiende ese alcance conectándolo con herramientas y servicios externos — cada servidor le da a Claude Code un nuevo conjunto de capacidades: consultar una base de datos, crear un issue en GitHub, ejecutar una prueba de navegador o obtener tokens de diseño de Figma.

La especificación del Modelo de Contexto del Protocolo define tres primitivas principales: Recursos (datos en bruto), Herramientas (acciones) y Prompts (plantillas reutilizables). En la práctica, las herramientas son con las que más interactuarás.

Cómo Instalar y Configurar Servidores MCP en Claude Code

Localización de la configuración MCP

Hay dos lugares principales donde Claude Code almacena la configuración de MCP:

Alcance del proyecto — .mcp.json en tu directorio de proyecto, controlado por versión, compartido con tu equipo
Alcance del usuario — tus ajustes de usuario, disponibles en todos los proyectos

Las anulaciones específicas del proyecto también se encuentran en .claude/settings.local.json y ~/.claude/settings.local.json para configuraciones locales específicas del usuario.

Para la mayoría de los desarrolladores en solitario, el alcance de usuario es el valor predeterminado más práctico. Para configuraciones en equipo, .mcp.json es lo que necesitas: se compromete con el repositorio.

Añadiendo una entrada de servidor

El método principal es el comando claude mcp add. Los servidores HTTP son la opción recomendada para servidores MCP remotos y son el transporte más compatible para servicios en la nube:

Bash

# Remote HTTP server (recommended for cloud services)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Local stdio server (for tools needing direct system access)
claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /home/user/projects

# User-scoped (available across all projects)
claude mcp add --scope user my-db -- npx -y @my-org/mcp-server-postgres

Algo que confunde a la gente: todas las opciones (--transport, --env, --scope) deben ir antes del nombre del servidor. La -- separa el nombre del servidor de los argumentos del comando. Si ese orden es incorrecto, las banderas se pasarán al proceso equivocado.

Si estás en Windows, envuelve los comandos npx con cmd /c:

Bash

claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

Sin la envoltura cmd /c, Windows no puede ejecutar npx directamente y arroja "Conexión cerrada."

Verificando la conexión

Después de añadir un servidor, ejecuta:

Bash

claude mcp list

Dentro de una sesión de Claude Code, usa /mcp para abrir el panel de administración y verificar el estado del servidor. Verás estados conectados, desconectados o con error por servidor.

Probando llamadas a herramientas en una sesión

Una vez que un servidor aparezca como conectado, solo pide a Claude Code que lo use. Algo como: *"Leer el archivo en /home/user/projects/config.json"* después de añadir el servidor de sistema de archivos. Si está configurado correctamente, verás el mensaje de permisos antes de que Claude Code ejecute.

Vale la pena mencionar: la configuración de MCP cambia con las actualizaciones de Claude Code. La documentación oficial de MCP de Claude Code es la referencia autorizada: consúltala si el comportamiento difiere de lo descrito aquí.

Servidores MCP recomendados para Claude Code

Estos son servidores que he visto comportarse de manera confiable, basándome en lo que se mantiene a principios de 2026. El repositorio oficial de servidores MCP en GitHub tiene la lista completa: algunos están mantenidos por Anthropic, la mayoría son construidos por la comunidad.

Sistema de archivos — El fundamental. Lee, escribe y organiza archivos locales con límites de directorio configurables. Tú controlas qué directorios se exponen.

Bash

claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /your/project/path

GitHub — Añadir el servidor MCP de GitHub con un token de acceso personal mediante transporte HTTP:

Bash

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

Esto da a Claude Code acceso a PRs, issues y repositorios. Útil para preguntar cosas como *"Revisa el diferencial en PR #234 y deja comentarios en línea." *

PostgreSQL — Permite a Claude consultar directamente tu base de datos. Establece tu cadena de conexión como variable de entorno:

Bash

claude mcp add --scope user my-db -- npx -y @modelcontextprotocol/server-postgres
# Set DATABASE_URL in your environment

Búsqueda web / Obtención — Firecrawl MCP obtiene URLs y devuelve Markdown limpio. Útil cuando Claude necesita documentos actuales de la API o referencias de terceros que no están en sus datos de entrenamiento.

Context7 — Recupera documentación de la biblioteca específica de la versión. Especialmente útil cuando trabajas con una versión de framework para la que Claude no tiene datos limpios de entrenamiento.

Pensamiento secuencial — No es una fuente de datos, sino un servidor de razonamiento. Ayuda a Claude a desglosar tareas complejas de refactorización en pasos explícitos antes de ejecutarlas.

Una advertencia honesta: usa con cuidado servidores MCP** de terceros.** Anthropic no ha verificado la corrección ni la seguridad de todos los servidores MCP. Ten especial cuidado con los servidores que recuperan contenido no confiable, ya que estos pueden exponerte al riesgo de inyección inmediata.

! [imagen] (https://cdn.z-image.ai/1775441899259-3.png)

Resolución de problemas MCP en Claude Code

Servidor no aparece

La causa más común: problemas con el PATH. Claude Code lanza subprocesos del servidor MCP con un entorno de shell diferente al de tu terminal, por lo que herramientas como node y npx puede que no se encuentren. Si usas nvm, usa rutas absolutas hacia el binario de Node o asegúrate de que nvm cargue en shells no interactivos añadiendo el bloque de inicialización de nvm a tu perfil de shell.

También valida tu JSON. Comas que terminan, comillas faltantes y barras diagonales sin escapar provocan fallos silenciosos — JSON no permite comas finales, y este es uno de los errores más comunes en los archivos de configuración MCP. Ejecuta tu configuración por un linter JSON antes de reiniciar.

Llamadas a herramientas que devuelven errores

Si un servidor se conecta pero las llamadas a herramientas fallan, comprueba que el formato del nombre de la herramienta coincida: mcp__<server-name>__<tool-name>. Además, comprueba que las variables del entorno (claves de API, cadenas de conexión) estén realmente configuradas en tu shell — Claude Code las hereda automáticamente del entorno de procesos, no de tu archivo .env.

Para problemas de transporte SSE: la variable de entorno MCP_TIMEOUT no se aplica a las conexiones SSE — cambia a transporte HTTP, que es más fiable y recomendado por la documentación oficial.

Más allá de MCP: Haciendo que el trabajo de Claude Code sea reutilizable

Aquí hay algo en lo que sigo pensando. MCP resuelve el problema de alcance — Claude Code ahora puede acceder a GitHub, bases de datos, Slack. Pero cada sesión todavía comienza desde cero. Las soluciones que Claude encuentra, los patrones que identifica, los enfoques exitosos que toma — eso no se transfiere automáticamente.

Ese vacío entre "Claude hizo algo útil" y "ese algo útil ahora forma parte de cómo funciona mi sistema" es real y es independiente de lo que MCP aborda.

Por ahora, la solución práctica es explícita: usar archivos CLAUDE.md para documentar patrones que Claude debería reutilizar, guardar buenos prompts junto con el código y tratar las sesiones exitosas de Claude Code como algo digno de capturar, no solo de consumir.

Preguntas frecuentes

¿Cómo agrego servidores MCP a Claude Code?

Ejecute claude mcp add con el indicador de transporte apropiado. Para servicios remotos, use --transport http. Para herramientas locales, use --transport stdio. Limite el servidor a su proyecto con --scope project o al perfil de usuario con --scope user. La sintaxis completa y ejemplos están en la documentación oficial de Claude Code MCP.

¿Dónde está el archivo de configuración MCP en Claude Code?

Las configuraciones de proyecto se encuentran en .mcp.json en la raíz de su proyecto. Las configuraciones de usuario están en los ajustes de usuario de Claude Code. También puede editar ~/.claude.json directamente para configuraciones más complejas — solo valide el JSON antes de reiniciar.

¿Qué servidores MCP funcionan mejor con Claude Code?

Para la mayoría de los desarrolladores: el servidor MCP de GitHub y el servidor de sistema de archivos cubren los casos de mayor frecuencia. Agregue PostgreSQL si consulta bases de datos regularmente. Context7 vale la pena configurarlo para trabajos con mucha documentación. Sequential Thinking ayuda con refactorizaciones complejas en varios pasos. Comience con uno o dos servidores, verifique que se conecten correctamente y luego amplíe.

Seguiré observando cómo evoluciona esta pila. La lista anterior refleja lo que realmente se mantiene y es usable a principios de 2026, no lo que suena bien en teoría.