- Diferencia entre la integración nativa mediante Streamable HTTP y el uso de MCPO para servidores stdio.
- Procedimiento de configuración de autenticación y permisos restringidos exclusivamente a perfiles de administrador.
- Pasos críticos en el modelo para habilitar el Function Calling en modo Nativo y el uso de filtros de funciones.
La tecnología Model Context Protocol (MCP) permite que los modelos de lenguaje de la AI no se queden solo en el chat, sino que interactúen con herramientas externas y datos en tiempo real. Por eso, conectar Open WebUI con servidores MCP es una gran idea, si lo que quieres es subir al siguiente nivel.
Lo cierto es que, aunque suena complicado, integrar servidores MCP no es ciencia nuclear si sabes por dónde empezar. Ya sea que busques una implementación nativa mediante HTTP o que necesites un puente para servidores que funcionan por stdio, existen rutas claras para lograr que tu modelo acceda a documentación técnica, bases de datos o cualquier servicio externo que soporte este protocolo.
Cómo conectar Open WebUI con servidores MCP
A partir de la versión 0.6.31, Open WebUI ya trae soporte nativo para MCP, aunque con un matiz importante: solo funciona mediante Streamable HTTP. Esto significa que no puedes conectar directamente un servidor que use stdio (estándar de entrada/salida), ya que la arquitectura web de la plataforma requiere comunicaciones basadas en HTTP para gestionar múltiples usuarios y sesiones de forma segura.
Para conectar Open WebUI con servidores MCP, un administrador debe ir a los Ajustes de Administración y entrar en la sección de Herramientas Externas. Desde allí, basta con añadir un nuevo servidor, seleccionar el tipo MCP y escribir la URL correspondiente. Es fundamental saber que solo los administradores pueden registrar estos servidores, ya que un servidor MCP tiene permisos profundos en el sistema y dejar que cualquier usuario instale uno sería un riesgo de seguridad tremendo.
En cuanto a la autenticación a la hora de conectar Open WebUI con servidores MCP, tienes varias opciones según donde esté tu servidor. Si es algo local y sin riesgos, elige «None», pero ten cuidado: si seleccionas «Bearer» y dejas la clave vacía, muchos servidores rechazarán la conexión. Para entornos más profesionales, puedes usar OAuth 2.1, ya sea de forma estática (con Client ID y Secret) o dinámica, permitiendo que la IA se autentique de manera segura antes de acceder a los datos.
Uso de MCPO como puente para servidores locales
¿Qué pasa si tienes un servidor MCP descargado que usa stdio y no HTTP? Aquí es donde entra en juego MCPO (Model Context Protocol Orchestrator). Este programa actúa como un proxy que traduce esos servidores «tradicionales» a un formato OpenAPI compatible con HTTP, haciendo que Open WebUI los vea como herramientas estándar.
Para montar este sistema y poder conectar Open WebUI con servidores MCP, lo más sencillo es usar Docker. Primero, despliegas el contenedor de Open WebUI con Ollama y, posteriormente, lanzas el contenedor de MCPO. Este último necesita un archivo llamado config.json donde defines qué servidores MCP quieres conectar. Una vez creado el archivo en tu PC, debes copiarlo al volumen del contenedor usando comandos de Docker para que el orquestador sepa qué herramientas levantar.
Una vez que MCPO está funcionando en el puerto 8000, debes volver a Open WebUI y añadir la herramienta apuntando a la dirección http://host.docker.internal:8000. Si tienes varios servidores configurados en el JSON, deberás añadir cada uno de ellos indicando su ruta específica, por ejemplo, añadiendo el endpoint del servidor de documentación de Microsoft al final de la URL.
Configuración del modelo y optimización
Para conectar Open WebUI con servidores MCP, no basta con conectar el servidor: hay que decirle al modelo que use esas herramientas. Debes ir a la sección de Modelos, elegir el que quieras potenciar y entrar en Parámetros Avanzados. Allí, el ajuste clave es cambiar el Function Calling de «Default» a «Native». Si no haces este cambio, es probable que el modelo ignore las herramientas disponibles.
Después, en la misma página de configuración, desplázate hasta la sección de herramientas y activa los servidores MCP que hayas registrado previamente. También existe un campo llamado «Function Name Filter List». Normalmente se deja vacío para usar todo, pero si notas que la conexión falla, un truco muy efectivo es poner una simple coma (,); esto fuerza al sistema a validar la lista y suele solucionar errores de parsing.
Si al intentar usar la herramienta recibes un error de conexión a pesar de que el botón de verificación dice que todo está OK, revisa la autenticación. A veces, el handshake inicial del servidor es demasiado lento y excede el tiempo de espera. En esos casos, es recomendable subir el valor de MCP_INITIALIZE_TIMEOUT, que por defecto está en 10 segundos, para dar tiempo al servidor a arrancar.
Tras conectar Open WebUI con servidores MCP y haber configurado correctamente el flujo de trabajo entre el modelo, el orquestador MCPO y la interfaz de Open WebUI permite transformar una simple ventana de chat en un centro de mando capaz de ejecutar scripts, consultar manuales técnicos y gestionar datos complejos mediante el estándar de protocolo de contexto de modelos, asegurando que la comunicación sea fluida y la seguridad esté siempre bajo el control del administrador.
Redactor especializado en temas de tecnología e internet con más de diez años de experiencia en diferentes medios digitales. He trabajado como editor y creador de contenidos para empresas de comercio electrónico, comunicación, marketing online y publicidad. También he escrito en webs de economía, finanzas y otros sectores. Mi trabajo es también mi pasión. Ahora, a través de mis artículos en Tecnobits, intento explorar todas las novedades y nuevas oportunidades que el mundo de la tecnología nos ofrece día a día para mejorar nuestras vidas.