¿Qué es un servidor MCP? Guía para agentes de código

¿Qué es un servidor MCP? En pocas palabras, un programa pequeño que da nuevas capacidades a un agente de IA. El Model Context Protocol (MCP) es un protocolo abierto: un servidor lo usa para ofrecer a un agente herramientas, prompts ya preparados y recursos legibles. El agente llama a esas herramientas para abrir un navegador, leer issues de GitHub, buscar errores en Sentry o consultar una base de datos.

Este artículo explica cómo funciona MCP, qué servidores merece la pena añadir y los errores que la gente comete al conectarlos a agentes de código.

¿Qué es un servidor MCP y cómo funciona?

Un servidor MCP puede ofrecer tres tipos de cosas:

• Herramientas: funciones que el agente puede llamar, como browser_navigate o search_issues.
• Prompts: plantillas que el servidor prepara para el agente.
• Recursos: datos que el agente puede leer, como un archivo o un registro.

Cuando arranca un agente, se conecta a sus servidores y obtiene sus listas de herramientas. Esas listas entran en el contexto del modelo, y el modelo llama a una herramienta cuando la necesita.

Tipos de conexión

Servidores MCP que merece la pena añadir

Los servidores más usados con agentes de código se agrupan en unas pocas categorías. Algunos de los 23 servidores listos para usar del catálogo de AgentVera:

• Navegador: Playwright (abrir páginas, hacer clic, rellenar formularios, tomar capturas), Chrome DevTools (consola, peticiones de red, trazas de rendimiento).
• Documentación: Context7 (documentación actual de bibliotecas, específica de cada versión), Cloudflare Docs.
• Desarrollo: GitHub (issues, pull requests, búsqueda de código), Git (log local, diff, commit), Sentry (errores y stack traces).
• Móvil: Mobile MCP, MobileBuildMCP, iOS Simulator, Firebase.
• Datos y memoria: Filesystem, Memory, Fetch, Sequential Thinking, Supabase.
• Producto y equipo: Linear, Notion, Stripe.
• Diseño: Figma (el servidor MCP del Dev Mode en la app de escritorio), Canva.
• Marketing: fal.ai (generación de imagen, vídeo y audio), Meta Ads (campañas publicitarias).

Añadir servidores MCP a cada CLI

Cada agente tiene su propia forma. En Claude Code puedes añadir uno desde la línea de comandos:

claude mcp add playwright -- npx -y @playwright/mcp@latest

En Codex, los servidores se definen en ~/.codex/config.toml:

[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp@latest"]

El problema: defines el mismo servidor otra vez en cada herramienta, y los secretos acaban en archivos de configuración en texto plano. Con varios agentes la lista se va desajustando.

Gestionar los servidores MCP en un solo lugar

El gestor de MCP de AgentVera mantiene los servidores en una sola lista y los asocia cuando arranca un agente:

1. En la página MCP, pulsa + para abrir el catálogo y elige un servidor, o introduce tu propio comando o dirección.
2. Decide si todos los agentes lo reciben o solo los que elijas. Si quieres, límitalo a un proyecto.
3. Pulsa Test connection para listar las herramientas, los prompts y los recursos del servidor.
4. Reinicia el agente; el cambio se aplica a la sesión nueva.

Las variables de entorno secretas y los tokens de cabeceras se guardan en el llavero de tu sistema operativo. Los servidores que necesitan OAuth se autorizan en el primer uso. Los servidores de los ajustes propios de Claude Code y Codex aparecen con su estado de salud; puedes importarlos a AgentVera o escribir los servidores de AgentVera de vuelta en las configuraciones de los CLI.

Estos servidores no llegan solo a Claude Code y Codex. Otras herramientas que admiten MCP también los reciben: opencode, Copilot, Qwen Code, Goose y Amp.

Cuenta el coste en tokens

El precio oculto de MCP es el contexto. Las definiciones de herramientas de cada servidor entran en el contexto del agente y se releen en cada turno. Un servidor con diez herramientas ocupa espacio en cada turno, aunque el agente nunca lo llame.

La prueba de conexión de AgentVera muestra los tokens aproximados que cada herramienta añade al contexto del agente. Eso te permite:

• Dar los servidores caros pero poco usados solo al agente que los necesita.
• Elegir el más ligero de dos servidores que hacen el mismo trabajo.
• Mantener un agente ligero libre de herramientas que no usará.

Para otras formas de reducir el contexto, consulta cómo reducir el uso de tokens de Claude Code.

Un tablón compartido para los agentes

AgentVera añade automáticamente a cada proyecto un servidor MCP llamado agentvera-board. Es un tablón de avisos compartido por los agentes del proyecto y por ti. Los agentes usan board_read, board_post y board_update para dejar notas, decisiones, tareas pendientes, hallazgos y entradas de archivos/módulos, y para leer lo que escribieron los demás. Tú publicas y marcas las tareas desde la pestaña Board del panel derecho.

Para agentes en paralelo, es la respuesta sencilla a «¿cómo sabrá Tester la decisión que tomó Architect?».

Ejemplo: probar en un navegador con Playwright

El mejor ejemplo de lo que te da MCP es el navegador. Un agente con el servidor MCP de Playwright puede:

• Abrir tu app en su dirección local.
• Tomar una instantánea del árbol de accesibilidad de la página.
• Hacer clic en botones y rellenar formularios.
• Tomar una captura de pantalla e informar de lo que ve.

Así el agente puede comprobar por sí mismo «¿funciona el botón de guardar de la página de ajustes?». AgentVera gestiona para esto un Chrome headless con su propio perfil. Los agentes en modo «AgentVera browser» lo usan mediante Playwright MCP, y tú ves las pestañas en vivo en la página Browser e intervienes cuando quieras. Consulta la página del navegador del agente para más detalles.

¿Qué servidor para qué agente?

Repartir los servidores por rol en lugar de dar todos los servidores a todos los agentes mejora tanto el contexto como la seguridad:

Limitar un servidor a un proyecto también ayuda. Un servidor conectado al proyecto de Supabase de un cliente no necesita ser visible para los agentes de otros proyectos.

Notas de seguridad

Los servidores MCP dan a los agentes acceso a sistemas reales. Por eso:

• Ten cuidado con los servidores que pueden escribir. Un agente que puede aplicar migraciones de base de datos puede cambiar datos con un solo paso en falso.
• No guardes tokens en archivos de texto plano. Usa el llavero o variables de entorno.
• No ejecutes servidores que no conozcas. Los servidores stdio se ejecutan como código en tu ordenador.
• No te saltes la prueba de conexión. Muestra lo que el servidor ofrece de verdad y cuánto contexto cuesta.

Añadir tu propio servidor MCP

También puedes añadir servidores que no estén en el catálogo. Necesitas dos cosas:

• Para stdio: el comando y los argumentos que ejecutar, más las variables de entorno que haga falta.
• Para HTTP o SSE: la dirección del servidor y las cabeceras de autorización que haga falta.

Prueba la conexión después de añadirlo. Si la prueba falla, revisa la salida del servidor (stderr); una variable de entorno que falta o un entorno de ejecución que no está instalado (como uvx) suele ser la causa.

Lista de comprobación

• ¿Ayuda este servidor de verdad a este agente?
• ¿Has probado su coste en tokens?
• ¿Están los secretos en el llavero y no en un archivo de texto plano?
• ¿Debería limitarse el servidor a un proyecto?
• ¿Has reiniciado el agente después de añadirlo?

Para terminar

Los servidores MCP llevan a los agentes de código más allá de la terminal: navegadores, gestores de issues, monitorización de errores y archivos de diseño quedan a su alcance. El precio es el coste en contexto y la gestión de secretos. Gestionar los servidores en un solo lugar, acotar su alcance y medir su coste es cómo mantienes ese equilibrio.

Puedes probar el gestor de MCP de AgentVera en el plan gratuito, y ver qué herramientas admiten MCP en la página de Claude Code y en las de los demás agentes.