mirror of
https://github.com/open-webui/open-webui.git
synced 2026-06-03 15:27:37 -05:00
[GH-ISSUE #20207] issue: Infinite loading screen when MCP tool is enabled. #34653
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @ppeterka on GitHub (Dec 27, 2025).
Original GitHub issue: https://github.com/open-webui/open-webui/issues/20207
Check Existing Issues
Installation Method
Docker
Open WebUI Version
0.6.42, 0.6.43
Ollama Version (if applicable)
N/A
Operating System
N/A
Browser (if applicable)
N/A
Confirmation
README.md.Expected Behavior
Opening the URL, frontend should load.
Actual Behavior
Only sidebar loads, loading animation stays in place, error in browser console:
Steps to Reproduce
Log in to Open WebUI, create an External Tool connection, like this:
Save it, enable it.
---> Frontend still works at this point flawlessly!
Hit Ctrl-F5 in browser, frontend stuck in loading state, with error on console:
Use Settings to disable the External tool:
Hit Ctrl-F5 again - frontend works correctly again.
Logs & Screenshots
Open WebUI JS error when External tool MCP definition active:
Frontend in permanent loading state:
Additional Information
Tested in 0.6.42 and 0.6.43 too.
Frontend does work if the External tools are not enabled when the browser starts the session, and stuff breaks with a Ctrl-F5.
@owui-terminator[bot] commented on GitHub (Dec 27, 2025):
🔍 Similar Issues Found
I found some existing issues that might be related to this one. Please check if any of these are duplicates or contain helpful solutions:
#19864 issue:
by Haervwe • Dec 10, 2025 •
bug#20019 issue:
by j63440490 • Dec 17, 2025 •
bug#19813 issue: Failed to connect to MCP server, while the connection test works fine
by spi-dlp • Dec 08, 2025 •
bug#19777 issue:
by Yaute7 • Dec 05, 2025 •
bug#20092 issue:
by VideoRyan • Dec 22, 2025 •
bugShow 5 more related issues
#20046 issue:
by pierrelouisbescond • Dec 19, 2025 •
bug#19438 issue: Icon loading regression
by JoelShepard • Nov 24, 2025 •
bug#19563 issue:
by naruto7g • Nov 28, 2025 •
bug#18981 issue: 0.6.35 error using tools through mcpo
by GlisseManTV • Nov 06, 2025 •
bug#15730 issue: Broken network connection to MCP tool causes endloss GUI loading
by FelHell • Jul 15, 2025 •
bug💡 Tips:
This comment was generated automatically by a bot. Please react with a 👍 if this comment was helpful, or a 👎 if it was not.
@rgaricano commented on GitHub (Dec 27, 2025):
The error occurs because the frontend code expects an OpenAPI-style configuration but receives an MCP-style configuration, causing Object.entries() to be called on an undefined value during tool server initialization.
Your JSON format uses mcpServers structure, but the code expects an OpenAPI-style configuration with properties like url, spec_type, etc.
Your MCP configuration:
But the code expects this format (for OpenAPI):
To solve:
@ppeterka commented on GitHub (Dec 27, 2025):
Yep, you're right - but I believe whatever I put in there, should be properly sanitized and should not break the UI itself...
@rgaricano commented on GitHub (Dec 27, 2025):
& a wider/deeper documentation!
@Classic298 commented on GitHub (Dec 30, 2025):
investigating
@Classic298 commented on GitHub (Dec 30, 2025):
MCP documentation: https://github.com/open-webui/docs/pull/931
@Classic298 commented on GitHub (Dec 30, 2025):
PR: https://github.com/open-webui/open-webui/pull/20257
@Classic298 commented on GitHub (Dec 30, 2025):
merged