issue: Integration – Add external tool server is only working over https connection

问题场景

用户在 Docker 中运行 Open WebUI（:cuda 版本，Ubuntu 主机），通过浏览器进入 Settings > Integrations，准备添加外部工具服务器（MCP 服务器）。提交者称：以 plain http 访问时，添加相关区域被禁用/置灰；改用 https 访问后可以正常添加。提交者希望界面上能提示“已禁用，请改用 https 重新连接”，而不是静默置灰。

报错原文

issue: Integration - Add external tool server is only working over https connection

原因分析

维护者复测后未能复现，并指出在该位置 Open WebUI 并不检查页面是 http 还是 https，因此“协议导致置灰”不是已确认原因。维护者给出的可能原因是：Settings > Admin > Integrations 中 Tools 与 Open Terminal 区域被置灰，是 ENABLE_TOOL_SERVERS=False 或 ENABLE_PLUGINS=False 导致的，这两个变量会强制关闭相应功能，并且只在容器启动时从环境变量读取一次。

另外，如果 http 与 https 两个地址实际上指向不同容器，可能表现为两个地址下行为不一致，可优先排查这一项。

环境排查

• 确认 Open WebUI 的实际版本：在 Settings > About 中查看，而不是只记镜像标签 :cuda。
• 确认 http 地址与 https 地址是否访问的是同一个容器实例（可能是反向代理、端口映射或不同容器导致）。
• 检查该容器的环境变量 ENABLE_TOOL_SERVERS 与 ENABLE_PLUGINS 的取值，重点看是否存在 False。
• 确认是在 Settings > Admin > Integrations 下操作；个人 Settings > Integrations 只支持 OpenAPI 服务器，MCP 服务器仅管理员可添加。
• Issue 未提供 Python、CUDA、PyTorch、显卡、Ollama 具体版本等有效信息，这些项目无法作为本问题的排查依据。

解决步骤

1. 分别在 http 和 https 地址下打开 Open WebUI，进入 Settings > About，记录版本号，确认两个地址是否为同一实例。
2. 检查承载 Open WebUI 的容器环境变量，确认 ENABLE_TOOL_SERVERS 和 ENABLE_PLUGINS 没有被设为 False。如果是，改为非 False 的取值。
3. 由于这两个变量只在启动时读取，修改后重启容器，使配置生效。
4. 重启后进入 Settings > Admin > Integrations，查看 Tools 和 Open Terminal 区域是否仍有置灰。
5. 如需添加 MCP 服务器，确认当前账号是管理员，并在 Settings > Admin > Integrations 中添加，而不是个人 Integrations 页面。
6. 若在两个变量均未设置的情况下仍能稳定复现，收集准确版本号、容器环境变量和置灰区域截图，在 Issue 中重新开启并补充这些信息。

验证方法

重启后，在 Settings > Admin > Integrations 中确认添加外部工具服务器的按钮可用，并能成功添加、保存一个 MCP 服务器且无报错。再分别用 http 和 https 访问同一实例，观察两个地址下的行为是否一致，以此判断问题是否与协议无关。

参考来源

open-webui/open-webui #33380

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。