- Difference between native integration using Streamable HTTP and using MCPO for stdio servers.
- Authentication configuration procedure and permissions restricted exclusively to administrator profiles.
- Critical steps in the model to enable Function Calling in Native mode and the use of function filters.
Technology Model Context Protocol (MCP) It allows AI language models to go beyond the chat environment and interact with external tools and real-time data. Therefore, Connect Open WebUI to MCP servers It's a great idea if you want to take your game to the next level.
The truth is, although it sounds complicated, integrating MCP servers isn't rocket science if you know where to start. Whether you're looking for a native implementation Whether you need a bridge for servers that run on STDI via HTTP, there are clear paths to enable your model to access technical documentation, databases, or any external service that supports this protocol.
How to connect Open WebUI with MCP servers
Starting with version 0.6.31, Open WebUI already includes native support for MCPHowever, there's an important caveat: it only works through Streamable HTTPThis means you cannot directly connect to a server that uses stdio (input/output standard), as the platform's web architecture requires HTTP-based communications to securely manage multiple users and sessions.
To connect Open WebUI With MCP servers, an administrator must go to the Administration Settings and go to the External Tools section. From there, simply add a new server, select the MCP type, and enter the corresponding URL. It is essential to know that only administrators These servers can be registered, since an MCP server has deep privileges on the system and allowing any user to install one would be a tremendous security risk.
Regarding authentication when connecting Open WebUI to MCP servers, you have several options depending on your server's location. If it's a local and low-risk setup, choose "None"But be careful: if you select "Bearer" and leave the key blank, many servers will reject the connection. For more professional environments, you can use OAuth 2.1, either statically (with Client ID and Secret) or dynamically, allowing AI to authenticate securely before accessing data.
Using MCPO as a bridge for local servers
What happens if you have a downloaded MCP server that uses stdio and not HTTP? This is where things get interesting. MCPO (Model Context Protocol Orchestrator)This program acts as a proxy that translates those "traditional" servers into a format OpenAPI compatible with HTTP, causing Open WebUI to see them as standard tools.
To set up this system and connect Open WebUI to MCP servers, the easiest way is to use Docker. First, you deploy the container of Open WebUI with Ollama and then you launch the MCPO container. The latter needs a file called config.json where you define which MCP servers you want to connect. Once the file is created on your PC, you must copy it to the container volume using Docker commands so that the orchestrator knows which tools to start.
Once MCPO is running on port 8000, you need to return to Open WebUI and add the tool pointing to the address http://host.docker.internal:8000If you have multiple servers configured in the JSON, you will need to add each one of them, specifying its specific path, for example, adding the Microsoft documentation server endpoint to the end of the URL.
Model configuration and optimization
To connect Open WebUI with MCP servers, simply connecting the server isn't enough: you need to tell the model to use those tools. Go to the Models section, choose the one you want to enhance, and enter... Advanced ParametersThere, the key adjustment is to change the Function Calling from “Default” to “Native”If you don't make this change, the model will likely ignore the available tools.
Next, on the same settings page, scroll down to the tools section and activate the MCP servers that you previously registered. There is also a field called "Function Name Filter List". Normally, this is left empty to use everything, but if you notice the connection failing, a very effective trick is put a simple comma (,)This forces the system to validate the list and usually resolves parsing errors.
If you receive a connection error when trying to use the tool, even though the verification button says everything is OK, check your authentication. Sometimes, the initial handshake The server response is too slow and exceeds the expected timeout. In such cases, it is recommended to increase the value of MCP_INITIALIZE_TIMEOUT, which by default is 10 seconds, to give the server time to start up.
After connecting Open WebUI with MCP servers and correctly configuring the workflow between the model, the MCPO orchestrator, and the Open WebUI interface, a simple chat window can be transformed into a command center capable of running scripts, consulting technical manuals, and managing complex data using the Model Context Protocol standard, ensuring smooth communication and security that is always under the administrator's control.
Editor specialized in technology and internet issues with more than ten years of experience in different digital media. I have worked as an editor and content creator for e-commerce, communication, online marketing and advertising companies. I have also written on economics, finance and other sectors websites. My work is also my passion. Now, through my articles in Tecnobits, I try to explore all the news and new opportunities that the world of technology offers us every day to improve our lives.