/ 目錄 / 演練場 / Open WebUI
● 官方 open-webui ⚡ 即開即用

Open WebUI

作者 open-webui · open-webui/open-webui

Self-hosted ChatGPT-like UI with MCP support — point it at Ollama or any provider and consume MCP tools through a real web app.

Open WebUI is the most-used self-hosted chat UI. It supports MCP servers as tools, so you can run Claude-style workflows on your hardware. Useful when you need a multi-user UI in front of MCP that isn't Claude Desktop.

為什麼要用

核心特性

即時演示

實際使用效果

就緒

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "open-webui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:8080",
        "ghcr.io/open-webui/open-webui:main"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "open-webui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:8080",
        "ghcr.io/open-webui/open-webui:main"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "open-webui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:8080",
        "ghcr.io/open-webui/open-webui:main"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "open-webui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:8080",
        "ghcr.io/open-webui/open-webui:main"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "open-webui-mcp",
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:8080",
        "ghcr.io/open-webui/open-webui:main"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "open-webui-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-p",
          "3000:8080",
          "ghcr.io/open-webui/open-webui:main"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add open-webui-mcp -- docker run -p 3000:8080 ghcr.io/open-webui/open-webui:main

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: Open WebUI

Give a team a chat UI that uses your internal MCPs

👤 Developers ⏱ ~15 min intermediate

何時使用: Not everyone runs Claude Desktop, but you want them on the same MCP tools.

步驟
  1. Deploy
    Run Open WebUI via Docker.✓ 已複製
    → UI up
  2. Register MCPs
    Add your MCP servers in admin settings.✓ 已複製
    → Tools visible
  3. Invite
    Add team accounts.✓ 已複製
    → Team using MCPs

結果: Team chat UI on top of internal MCP tools.

組合

與其他 MCP 搭配,撬動十倍槓桿

open-webui-mcp + ollama

Pair Open WebUI with local Ollama for fully-private team chat

Combine open-webui-mcp with ollama: Pair Open WebUI with local Ollama for fully-private team chat✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
mcp.register (see docs) Register an MCP server 1 call
chat.invoke (see docs) Send a chat that may call MCP tools 1 call

成本與限制

運行它的成本

API 配額
N/A self-host
每次呼叫 Token 數
Per provider
費用
Free OSS
提示
Use local models for low-stakes chats

安全

權限、密鑰、影響範圍

最小權限: openwebui:admin
憑證儲存: User DB + provider keys
資料出站: Configured providers
切勿授予: Run on the public internet without auth

故障排查

常見錯誤與修復

MCP tool not visible

Re-register and check the server is reachable from the container

替代方案

Open WebUI 對比其他方案

替代方案何時用它替代權衡
5ireSingle-user desktopNot multi-user

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills