OpenWebUI/docs
1
0
Fork 0
mirror of https://github.com/open-webui/docs synced 2025-06-13 10:02:50 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update open-webui.mdx
Some checks are pending
Deploy site to Pages / build (push) Waiting to run
Details
Deploy site to Pages / deploy (push) Blocked by required conditions
Details

Browse Source
This commit is contained in:
Timothy Jaeryang Baek 2025-04-12 22:42:30 -07:00
parent 560c31f842
commit 45478ea9f4
1 changed files with 22 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/openapi-servers/open-webui.mdx
View File

@ -67,16 +67,6 @@ Admins can manage shared tool servers available to all or selected users across
- Add the tool server URL just as you would in user settings.
- These tools are treated similarly to Open WebUI’s built-in tools.
![Global Tool Server Message Input](/images/openapi-servers/open-webui/global-message-input.png)
⚠️ Important:
- By default, global tool servers are not activated — each one must be toggled ON explicitly before becoming available.
- Once enabled, global tool servers are accessible by all users (or can be limited based on role-based access features).
This is ideal for team setups or shared environments, where commonly-used tools (e.g. document search, memory, or web lookup) should be centrally accessible by multiple users.
### 👉 Optional: Using a Config File with mcpo
If you're running multiple tools through mcpo using a config file, take note:
@ -124,6 +114,28 @@ Clicking this icon opens a popup where you can:
![Tool Info Modal Expanded](/images/openapi-servers/open-webui/info-modal.png)
### 🛠️ Global Tool Servers Look Different — And Are Hidden by Default!
If you've connected a Global Tool Server (i.e., one that’s admin-configured), it will not appear automatically in the input area like user tool servers do.
Instead:
- Global tools are hidden by default and must be explicitly activated per user.
- To enable them, you'll need to click on the ➕ button in the message input area (bottom left of the chat box), and manually toggle on the specific global tool(s) you want to use.
Here’s what that looks like:
![Global Tool Server Message Input](/images/openapi-servers/open-webui/global-message-input.png)
⚠️ Important Notes for Global Tool Servers:
- They will not show up in the tool indicator popup until enabled from the ➕ menu.
- Each global tool must be individually toggled on to become active inside your current chat.
- Once toggled on, they function the same way as user tools.
- Admins can control access to global tools via role-based permissions.
This is ideal for team setups or shared environments, where commonly-used tools (e.g. document search, memory, or web lookup) should be centrally accessible by multiple users.
---
## (Optional) Step 4: Use "Native" Function Calling (ReACT-style) Tool Use 🧠