Seis servidores MCP que vale la pena mantener en Claude Code y qué eliminar
Optimizar una configuración MCP sobrecargada: Context7, GitHub, Postgres MCP Pro, Playwright, Sentry y Brave Search, con delimitación del alcance del proyecto y una auditoría del número de herramientas inferior a 50.
Fuentes: *I Tested 8 MCP Servers With Claude Code. These Were Actually Worth Keeping*
Un agente de programación que recibe la tarea de buscar en una carpeta local src una función de autenticación obsoleta puede terminar en lugares inesperados. En un caso real, el agente omite el sistema de archivos, llama a un servidor Jira MCP instalado una semana antes y comienza a buscar el nombre de la función en la lista de tickets pendientes. La inserción de /mcp explica por qué: había 14 servidores en funcionamiento que ofrecían 73 herramientas. Alrededor de 50 herramientas visibles es aproximadamente el punto en el que un modelo deja de distinguir herramientas similares y comienza a adivinar. Además, antes incluso de escribir la primera palabra, se gastaron unos 18,000 tokens por turno en esquemas JSON de herramientas que nadie utilizaba.
Cualquier servidor al que se conecte, su lista de herramientas termina en el prompt del sistema. Si el objetivo es un agente que elija correctamente a la primera, esos espacios disponibles constituyen un presupuesto limitado.
Context7 para los documentos actuales
Los agentes suelen escribir código para APIs que posteriormente han cambiado. Si se solicita un flujo de autenticación de Supabase, el resultado podría utilizar métodos obsoletos para el año 2025. Context7 soluciona este problema al incluir en la instrucción documentación de bibliotecas con versiones fijas.
# Add --scope project (or -s project) to write the entry into
# a committable .mcp.json instead of your personal ~/.claude.json.
# Context7 provides current, version-pinned library docs
# Canonical path is the installer (OAuth + generates an API key):
npx ctx7 setup
# Or wire the remote server manually (key from context7.com/dashboard):
claude mcp add --transport http context7 https://mcp.context7.com/mcp \
--header "CONTEXT7_API_KEY: <YOUR_KEY>"
Una vez instalado, el agente obtiene contenido Markdown en tiempo real y escribe la implementación actual. Debes confiar en su índice, pero para los frameworks web más utilizados es el primer servidor que vale la pena instalar.
GitHub para problemas y solicitudes de integración
Puedes indicarle a un agente que corrija el problema #8009 y, por lo general, se detendrá y pedirá la descripción, ya que no puede ver el repositorio remoto. El servidor MCP oficial de GitHub proporciona acceso al sistema de seguimiento de problemas, a las solicitudes de integración y a la búsqueda de código remoto.
# GitHub — OFFICIAL server (issues, PRs, repo search).
# For Claude Code 2.1.1+:
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer <YOUR_GITHUB_PAT>"}}'
# For Claude Code 2.1.0 or earlier (legacy flag form):
# claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer <YOUR_GITHUB_PAT>"
Después de eso, una solicitud como “revisar PR #8042” funciona: el agente obtiene la diferencia entre versiones, lee los comentarios de los revisores, los asocia con los archivos locales y aplica las ediciones. Es preferible utilizar el propio servidor de GitHub en lugar de herramientas de terceros más antiguas.
Postgres MCP Pro para esquemas reales
Un agente que intenta adivinar el esquema de una base de datos genera errores como la columna ‘created_at’ no existe. Postgres MCP Pro le proporciona herramientas como list_schemas y get_object_details, lo que le permite mapear la base de datos real antes de escribir SQL.
# Postgres MCP Pro — schema-aware SQL, READ-ONLY restricted mode
pipx install postgres-mcp
# Add the server with the restricted access flag
claude mcp add postgres --env DATABASE_URI="postgresql://user:pass@localhost:5432/db" \
-- postgres-mcp --access-mode=restricted
Ya sea en entornos de pruebas o de producción, la opción --access-mode=restricted no es opcional. Desactiva las operaciones INSERT, UPDATE y DELETE a nivel del servidor, de modo que el agente no puede eliminar tablas mientras explora el sistema.
Playwright MCP para verificación
Los agentes afirmarán sin problema que una clase CSS solucionó un error de diseño, sin necesidad siquiera de renderizar la página. Playwright MCP permite que el agente verifique su propio trabajo al utilizar un navegador sin interfaz gráfica.
# Playwright (Microsoft) — agent drives a real browser to verify its own change
claude mcp add playwright npx @playwright/mcp@latest
En lugar de interpretar una captura de pantalla sin procesar, el agente lee el árbol de accesibilidad, por lo que sabe dónde se encuentra un botón en el DOM y si el usuario puede verlo.
Playwright controla el navegador y prueba el DOM. Chrome DevTools MCP es una herramienta separada destinada al análisis de la red y el rendimiento. Añada el servidor de DevTools solo cuando esté abordando activamente problemas de red, ya que Playwright es más eficaz para la verificación visual.
Sentry para errores en producción
Un rastro de errores de React minificado pegado en una terminal rara vez es útil, ya que las versiones para producción eliminan los mapas de fuente. El servidor MCP oficial de Sentry trae el rastro sin minificar, las pistas de navegación y los datos del entorno a la ventana de contexto.
# Sentry — OFFICIAL remote server; pulls live stack traces
# Triggers OAuth on first launch
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Cuando un usuario informa de una caída, se le puede indicar al agente que consulte el último problema del frontend en Sentry, y este lo depura utilizando la línea exacta y el estado de las variables en el momento de la caída.
Brave Search para encontrar respuestas rápidas
Veinte minutos pueden desaparecer intentando resolver un error enigmático de esbuild cuando la solución se encuentra en un problema de GitHub abierto dos días antes. Los datos de entrenamiento del agente estaban demasiado obsoletos como para saberlo, por lo que el desarrollador debe dejar la terminal y buscar a mano.
# Brave Search — OFFICIAL server from Brave (the @modelcontextprotocol/*
# package was archived May 2025)
# Requires a free API key from api-dashboard.search.brave.com
claude mcp add brave-search --env BRAVE_API_KEY="<YOUR_KEY>" \
-- npx -y @brave/brave-search-mcp-server --transport stdio
Esto proporciona al agente una herramienta de búsqueda en la web en tiempo real. Ante un error poco común, puede consultar respuestas recientes de StackOverflow o páginas de estado del proveedor sin salir de la terminal.
Seguridad en la configuración
Antes de agregar más elementos, corrija la configuración y revise qué está en ejecución. Al incluir --scope project en cualquier comando de instalación, la entrada se guarda en un archivo .mcp.json dentro del repositorio en lugar de en el archivo global ~/.claude.json, de modo que todo el equipo comparta el mismo conjunto de herramientas.
Un archivo de referencia para los servidores mencionados, además de dos espacios flexibles, se ve así. Los espacios flexibles son el servidor Filesystem, mantenido para permitir acceso limitado a directorios fuera del proyecto actual, y Sequential-thinking, que ayuda al agente a seguir su propia lógica durante refactores a gran escala.
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": { "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}" }
},
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp",
"headers": { "Authorization": "Bearer ${GITHUB_PAT}" }
},
"sentry": {
"type": "http",
"url": "https://mcp.sentry.dev/mcp"
},
"postgres": {
"command": "postgres-mcp",
"args": ["--access-mode=restricted"],
"env": { "DATABASE_URI": "${DATABASE_URI}" }
},
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
},
"brave-search": {
"command": "npx",
"args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
"env": { "BRAVE_API_KEY": "${BRAVE_API_KEY}" }
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${HOME}/projects"]
},
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
Las entradas utilizan dos métodos de transporte. Con http, el servidor es una API remota y toda su lógica se ejecuta en el lado del proveedor. Con stdio, al igual que en Playwright o Postgres, se inicia un proceso local desde el array command, por lo que los binarios correspondientes deben instalarse primero en la máquina. Las contraseñas se transmiten mediante interpolación de entorno, como ${DATABASE_URI}, lo que permite mantener el archivo seguro para su almacenamiento.
Para conocer cuántas herramientas se necesitan para esta configuración, consulte la sesión en vivo:
# List every configured server and its connection status
claude mcp list
# Inside a Claude Code session, inspect connected servers and their tools:
# Type /mcp
# This shows each server, its tool count, and lets you toggle tools.
El contador de herramientas que muestra la interfaz suma el total. Hay cerca de cincuenta herramientas visibles; desactive aquellas que no sean necesarias para esa sesión.
Elimine lo innecesario
Una vez establecida una línea de referencia, quite todo lo que no pertenezca al sistema.
- Servidores de referencia archivados. La antigua implementación de Postgres (
@modelcontextprotocol/server-postgres) sigue apareciendo en tutoriales obsoletos, pero ya no se mantiene. Reemplázela por Postgres MCP Pro. - Envoltorios de terceros. Los envoltorios comunitarios para GitHub, Sentry y servicios similares surgieron en 2025 como soluciones temporales para mantenerse al día con los cambios en las API oficiales. Donde exista un servidor del proveedor oficial, descarte la versión desarrollada por la comunidad.
- Cualquier cosa que duplique las capacidades integradas. Aquí es donde ocurren las colisiones de herramientas. Un servidor dedicado a la ejecución de shells brinda al agente dos formas de ejecutar bash. En un caso documentado, un agente utilizó una herramienta de terceros
execute_scriptpara un simplenpm install, se encontró con un error de ruta y luego escribió un script personalizado en Python para iniciar la instalación, ignorando el shell nativo. Si el cliente ya puede obtener URLs o leer archivos, no gaste recursos en un servidor que haga lo mismo.
Siga realizando auditorías
Revisa nuevamente .mcp.json cada vez que la sesión parezca lenta. Una configuración adecuada mantiene los seis servidores principales activos y deja espacio por debajo del umbral de 50 herramientas. Un servidor MCP de Slack es un caso típico: el agente sigue leyendo el historial del canal cuando se le pide buscar en los registros locales, lo que ralentiza el proceso. Un candidato para el octavo lugar, como el MCP de Linear para incorporar criterios de aceptación al editor, debe ganarse su lugar; si eleva demasiado el conteo, otra herramienta tendrá que ser descartada.
Cuando un agente parezca lento últimamente, guarda la configuración actual y prueba únicamente con estos servidores principales durante unos días. Ejecuta /mcp para observar su impacto y verifica si el modelo elige las herramientas de manera más precisa. Vuelve a incluir otros servidores solo después de llegar a un límite que las funciones integradas de Claude Code no puedan superar.
Leer más
- Explicación de los subagentes de Claude Code: qué son y cuándo usarlos — Cómo difieren los subagentes de Claude Code de las habilidades y los equipos de agentes: aislamiento de contexto, un primer subagente personalizado, buenas prácticas de descripción y herramientas, y cuándo omitirlos.
- Por qué los agentes de programación siguen teniendo dificultades con el código de empresas privadas — Real-SWE prueba ocho agentes de programación en bases de código privadas con licencia. El mejor resuelve el 38,8 por ciento, y las cinco categorías de fallos muestran dónde cometen errores los agentes.