> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ascendgtm.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect to Open WebUI

> Use V5 MCP tools in Open WebUI with any backend model.

# Connect to Open WebUI

Open WebUI 0.5+ supports MCP servers as tools. Connect V5 to make all 34 GTM tools available to any model running in your Open WebUI instance.

## Prerequisites

* Open WebUI 0.5.0+ (self-hosted)
* A V5 bearer token — get one from your admin: `POST /admin/tokens/issue`
* Admin access to your Open WebUI instance

## Setup

### 1. Add the MCP tool server

1. Log into Open WebUI as an admin
2. Go to **Admin Panel** → **Settings** → **Tools**
3. Click **Add Tool Server** (or **Add MCP Server**)
4. Enter:

| Field          | Value                                                 |
| -------------- | ----------------------------------------------------- |
| **Name**       | `Ascend Gateway V5`                                   |
| **Server URL** | `https://ascend-gateway-v5.ascendgtm.workers.dev/mcp` |
| **Auth Type**  | `Bearer Token`                                        |
| **Token**      | `your-bearer-token-here`                              |

5. Click **Save & Connect**

### 2. Assign to models

1. Go to **Admin Panel** → **Models**
2. Select the model you want to give V5 tool access
3. Under **Tool Servers**, enable **Ascend Gateway V5**
4. Save

### 3. Test in chat

Start a chat with the configured model:

```
Use discover_apis to list what APIs are connected.
```

## Docker compose configuration

If running Open WebUI with Docker, you can pre-configure the MCP server via environment variables:

```yaml theme={null}
services:
  open-webui:
    environment:
      - MCP_SERVERS='[{"name":"ascend-gateway","url":"https://ascend-gateway-v5.ascendgtm.workers.dev/mcp","auth":{"type":"bearer","token":"your-token"}}]'
```

## Tool usage in chat

When composing a message, click the **Tools** icon in the chat input to see and enable specific V5 tools for that conversation. Enable only the tools relevant to your task — this reduces context overhead.

<Tip>
  V5 has 34 tools. Enabling all 34 simultaneously adds significant token overhead to each message. Select only the tools you need for the current task.
</Tip>

## Troubleshooting

**"Failed to connect to tool server"**\
Open WebUI must be able to reach `ascend-gateway-v5.ascendgtm.workers.dev` from your server. Check network connectivity and firewall rules if self-hosting.

**Tools show but model doesn't use them**\
Ensure you're using a function-calling-capable model (GPT-4, Claude, Gemini, or a tool-capable local model). Pure text completion models don't support tool use.