MCP Connector for Open WebUI

What is MCP Connector for Open WebUI?

The MCP Connector for Open WebUI is a Pipe Function that lets users connect Open WebUI to Model Context Protocol (MCP) servers. It enables the use of MCP‑compatible AI models directly inside the Open WebUI interface, acting as a bridge between the two systems.

How to use MCP Connector for Open WebUI?

Install via pip install git+https://github.com/ivanuser/open-webui-mcp-connector.git or import it in Open WebUI (Workspace > Functions). Then configure one or more MCP servers in the function’s MCP_SERVERS JSON field — provide a name, URL, and optional API key. Save and enable the function; models automatically appear in the model selector with a configurable prefix (default MCP/).

Key features of MCP Connector for Open WebUI

• Connect to multiple MCP servers simultaneously
• Authenticate via API keys
• Automatically discover models from configured MCP servers
• Stream responses from compatible models
• Robust timeout and error handling
• Debug mode for detailed logging

Use cases of MCP Connector for Open WebUI

• Run MCP‑based models inside Open WebUI without leaving the chat interface
• Centralize access to several MCP servers from a single Open WebUI instance
• Develop or test MCP‑compatible models using Open WebUI’s familiar UI
• Troubleshoot MCP server connectivity with built‑in debug logging

FAQ from MCP Connector for Open WebUI

What is MCP?

MCP (Model Context Protocol) is a standardized protocol for AI model interactions, similar to the OpenAI API specification.

How do I connect multiple MCP servers?

In the function settings, add each server as a JSON object inside the MCP_SERVERS array with its name, url, and optional api_key.

What if I see “No address associated with hostname”?

Check that the server URL is correct, your network can reach it, and DNS resolution is working properly.

Why are my connections timing out?

Increase the CONNECTION_TIMEOUT value (default 30 seconds), verify the server is not overloaded, and confirm network connectivity.

How can I enable debug logging?

Set DEBUG_MODE to true in the function settings to get detailed logs for troubleshooting.