Configurar servidores MCP en Vibe
En esta página
Lección actualizada el 2 de noviembre de 2026 según la página MCP servers de Vibe Code: la autenticación utiliza ahora la tabla
[mcp_servers.auth](api_key_envu OAuth); la sintaxis${VARIABLE}en cabeceras, mostrada anteriormente, no está documentada para servidores MCP. Se han añadido los subcomandosvibe mcp addy/mcp. Fuente: MCP servers.
¿Qué es MCP?
El Model Context Protocol (MCP) es un estándar abierto que permite a los agentes de IA comunicarse con servidores de herramientas externos. En lugar de codificar manualmente cada integración, MCP ofrece un protocolo unificado: el servidor expone las herramientas y el agente las descubre y utiliza automáticamente. No es necesario escribir código de adaptación (glue code). Basta con declarar una dirección o un comando para que las herramientas estén disponibles en tu siguiente sesión.
Vibe cuenta con soporte nativo para MCP, lo que significa que puedes ampliar sus capacidades mucho más allá de las herramientas integradas: leer una página web, consultar una base de datos o invocar una API interna de la empresa.
Los dos tipos de transporte
Antes de configurar nada, debes decidir el transporte, es decir, el canal que Vibe utilizará para comunicarse con el servidor.
Con el transporte HTTP, el servidor MCP se ejecuta como un servicio web estándar y Vibe envía solicitudes para descubrir y llamar a las herramientas:
[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"
headers = { "Authorization" = "Bearer my_token_here" }
Utiliza este modo cuando el servidor MCP se ejecute de forma continua: un servicio de base de datos, una API interna o una herramienta web compartida por todo tu equipo.
Con el transporte STDIO, el servidor es un programa local que el propio Vibe lanza, comunicándose mediante stdin/stdout:
[[mcp_servers]]
name = "fetch_server"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
Este es el modo más sencillo de configurar, ya que Vibe gestiona el ciclo de vida del servidor: lo inicia al comienzo de la sesión y lo detiene al final. No requiere arranque manual ni supervisión.
Existe también una variante HTTP llamada streamable-http, diseñada para conexiones de larga duración con transmisión de datos (streaming):
[[mcp_servers]]
name = "my_stream_server"
transport = "streamable-http"
url = "http://localhost:9000/mcp"
Ejemplo práctico: añadir obtención de contenido web
Uno de los servidores MCP más útiles es mcp-server-fetch, que permite a Vibe leer el contenido de páginas web. Solo requiere tres líneas de configuración:
# ~/.vibe/config.toml
[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
El impacto en tu flujo de trabajo diario es inmediato. Ahora puedes hacer solicitudes que asumen lectura externa:
Lee la documentación de FastAPI en fastapi.tiangolo.com y resume los endpoints de seguridad para mí
El agente llama automáticamente a la herramienta fetch del servidor MCP para obtener la página y luego analiza su contenido. No tienes que abrir un navegador ni pegar fragmentos de documentación en el terminal.
Filtrado de herramientas MCP
Esta comodidad tiene un coste. Cada servidor que añades trae su propio conjunto de herramientas y, con tres o cuatro servidores activos, el catálogo se vuelve confuso. El filtrado te permite mantener solo lo relevante:
# Habilitar solo herramientas de un servidor específico
enabled_tools = ["fetch_*"]
# Deshabilitar todas las herramientas MCP excepto las habilitadas explícitamente
disabled_tools = ["mcp_*"]
El filtrado con comodines cumple dos propósitos a la vez. Refuerza la seguridad al limitar lo que el agente tiene permitido hacer y evita sobrecargar el contexto del modelo: una lista de herramientas demasiado larga consume valioso contexto y degrada la calidad de las decisiones del agente.
Configuración avanzada con autenticación
Los servidores MCP empresariales casi siempre requieren autenticación. Para un token, la tabla [mcp_servers.auth] en modo static lee la clave desde una variable de entorno cuyo nombre proporcionas y la inserta en la cabecera que elijas:
[[mcp_servers]]
name = "internal_api"
transport = "http"
url = "https://mcp.your-company.com"
[mcp_servers.auth]
type = "static"
api_key_env = "MCP_API_TOKEN" # nombre de la variable, no el token en sí
api_key_header = "Authorization" # valor por defecto
api_key_format = "Bearer {token}" # valor por defecto
Para un servidor que ofrece inicio de sesión mediante OAuth, como el de Linear, establece type = "oauth" e inicia sesión durante tu sesión con /mcp login <name>: Vibe abre tu navegador y almacena los tokens en el llavero del sistema, nunca en config.toml. El comando vibe mcp add gestiona todo esto desde el terminal: vibe mcp add linear --url https://mcp.linear.app/mcp añade el servidor e inicia el flujo de inicio de sesión.
La ventaja es directa: puedes versionar y compartir tu archivo config.toml con tu equipo sin codificar secretos, ya que cada desarrollador proporciona su propio token a través de su entorno.
Servidores MCP populares
Varios servidores listos para usar cubren las necesidades más comunes y todos se declaran de la misma manera en config.toml. mcp-server-fetch gestiona la obtención de páginas web y APIs; mcp-server-filesystem amplía las operaciones de archivo más allá de las herramientas integradas; mcp-server-git aporta una integración avanzada de Git con diff, blame y log; mcp-server-sqlite y mcp-server-postgres permiten consultar bases de datos SQLite y PostgreSQL. Un agente capaz de leer tanto el esquema de una base de datos como el código que la utiliza detecta inconsistencias que la sola lectura de archivos nunca revelaría.
Durante una sesión, /mcp lista los servidores y /mcp <name> lista sus herramientas; /mcp status muestra el estado de cada uno. El agente también te indica qué herramientas está utilizando en sus respuestas, lo que sigue siendo la mejor forma de verificar que un servidor funciona correctamente.
Seguridad de los servidores MCP
Un servidor MCP se ejecuta con tus permisos y ve lo que le das: añade solo servidores de confianza, porque un servidor malicioso podría exponer datos de tu base de código. Luego, limita los permisos con enabled_tools en lugar de conceder acceso total por defecto.
Dos hábitos completan esta rutina de higiene. Revisa tus cabeceras: ningún token debe aparecer en texto plano en config.toml; para eso sirve exactamente api_key_env. Y para herramientas locales, prefiere el transporte STDIO, que es más seguro que un servidor HTTP expuesto en la red, si no fuera porque no abre ningún puerto.
Puntos clave
- MCP te permite añadir herramientas externas a Vibe mediante un protocolo estandarizado
- Dos transportes principales: HTTP (servidor persistente) y STDIO (proceso local)
- El filtrado de herramientas (
enabled_tools,disabled_tools) controla lo que el agente puede usar - Las variables de entorno en las cabeceras protegen los secretos
- Añade solo servidores MCP de confianza y limita sus permisos