Skip to main content

Open WebUI Integration

Connect your mcp.run servlets to Open WebUI.

Setup​

1. Get Connection Details​

  1. Go to /chat/{scope}/{profile}
  2. Click Connect → Open WebUI tab
  3. Note the API Base URL

Connect modal with Open WebUI tab

2. Configure Open WebUI​

  1. Open WebUI → Settings → Connections → Manage Direct Connections → Add (Open WebUI docs)

Open WebUI Settings 2. Enter:

  • URL: https://mcp.run/api/v1/openai/{scope}/{profile}
  • Key: Generate from Connect modal or use existing
  • Model IDs: Leave empty to fetch all models

3. Generate Token​

In Connect modal:

  1. Click Generate next to API Key
  2. Copy token immediately
  3. Paste in Open WebUI

4. Save and Test​

  1. Click Save
  2. Select mcp.run from model dropdown
  3. Send test message

Open WebUI with mcp.run configured

Usage​

Your servlets are automatically available as tools. The AI will invoke them when appropriate.

Troubleshooting​

  • Connection failed: Verify URL format (no trailing slash)
  • No models: Leave Model IDs empty
  • No tools: Check profile has servlets enabled
  • Auth errors: Regenerate token with proper permissions