From 45478ea9f4e5b74f9f10621e8b5d73c036f26b2d Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Sat, 12 Apr 2025 22:42:30 -0700 Subject: [PATCH] Update open-webui.mdx --- docs/openapi-servers/open-webui.mdx | 32 ++++++++++++++++++++--------- 1 file changed, 22 insertions(+), 10 deletions(-) diff --git a/docs/openapi-servers/open-webui.mdx b/docs/openapi-servers/open-webui.mdx index a3d289a..e19bb1f 100644 --- a/docs/openapi-servers/open-webui.mdx +++ b/docs/openapi-servers/open-webui.mdx @@ -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 🧠