mirror of
https://github.com/open-webui/docs.git
synced 2026-01-02 17:59:41 +07:00
55 lines
1.9 KiB
Plaintext
55 lines
1.9 KiB
Plaintext
---
|
||
title: 🔌 MCP (Model Context Protocol)
|
||
---
|
||
|
||
Open WebUI natively supports **MCP (Model Context Protocol)** starting in **v0.6.31**. This page shows how to enable it quickly, harden it for production, and troubleshoot common snags.
|
||
|
||
> **Audience:** admins and power users configuring external tools
|
||
|
||
:::info
|
||
Requires **Open WebUI v0.6.31+**.
|
||
:::
|
||
|
||
## 🚀 Quick start
|
||
|
||
1. Open **⚙️ Admin Settings → External Tools**.
|
||
2. Click **+ (Add Server)**.
|
||
3. Set **Type** to **MCP (Streamable HTTP)**.
|
||
4. Enter your **Server URL** and **Auth** details (OAuth 2.1, if required).
|
||
5. **Save**. If prompted, restart Open WebUI.
|
||
|
||
You can now call tools exposed by your MCP server from Open WebUI.
|
||
|
||
## 🧭 When to use MCP vs OpenAPI
|
||
|
||
:::tip
|
||
For most deployments, **OpenAPI** remains the **preferred** integration path.
|
||
:::
|
||
|
||
Choose **OpenAPI** if you want:
|
||
|
||
* **Enterprise readiness**: deep SSO, API gateways, audit, quotas, typed SDKs.
|
||
* **Operational resilience**: standard HTTP verbs, idempotency, caching, rich error codes.
|
||
* **Observability**: first-class tracing and policy integration.
|
||
|
||
Choose **MCP (Streamable HTTP)** if you need:
|
||
|
||
* A **common tool protocol** already used by your MCP servers/clients.
|
||
* **Streamed** tool events over HTTP with emerging ecosystem support.
|
||
|
||
> You don’t have to pick one: many teams expose OpenAPI internally and **wrap MCP** at the edge for specific clients.
|
||
|
||
:::warning
|
||
Browser-based, multi-user deployments increase the surface area (CORS/CSRF, per-user isolation, reconnects). Review your org’s auth, proxy, and rate-limiting policies before exposing MCP externally.
|
||
:::
|
||
|
||
## ❓ FAQ
|
||
|
||
**Do you support stdio or SSE transports?**
|
||
No. Open WebUI only supports **MCP via Streamable HTTP**.
|
||
|
||
**Is MCP considered stable here?**
|
||
Supported and improving. The broader ecosystem is still evolving; expect occasional breaking changes.
|
||
|
||
**Can I mix OpenAPI and MCP tools?**
|
||
Yes. Many deployments do both. |