Adoptarea standardului deschis Model Context Protocol (MCP) de către Open WebUI permite conectarea interfeței la sute de unelte și baze de date create pentru ecosistemul Claude sau Cursor, fără a fi nevoie să scrieți cod de integrare specific.
Prin conectarea unui server MCP (fie printr-un canal SSE peste rețea, fie printr-un pod de tip stdio), Open WebUI descoperă automat uneltele expuse de acesta: căutare în depozite GitHub, interogare în servere PostgreSQL interne, citire de fișiere locale sau acces la calendare corporative.
Administratorii pot asocia servere MCP fie la nivel global (disponibile pentru toți utilizatorii), fie exclusiv unor ‘Modele Custom’ (Custom Models/Personas), oferind agenților acces la unelte strict autorizate în funcție de rolul departamental.
Sintaxă, opțiuni și concepte cheie
| Opțiune / Concept | Descriere practică |
|---|---|
MCP Server Connection |
Configurarea adresei de conectare la serverul MCP (URL SSE sau comandă CLI stdio). |
Dynamic Tool Discovery |
Mecanismul prin care Open WebUI descarcă lista de unelte (`tools/list`) la inițializarea sesiunii. |
Tool Authorization & Scopes |
Reguli de acces ce dictează ce utilizatori au dreptul de a apela instrumentele serverului. |
SSE Endpoint |
Adresa de tip `http://mcp-server:8000/sse` folosită pentru comunicare asincronă bidirecțională. |
Exemple practice și comenzi
Exemplul 1: Conectarea unui server MCP de documentație internă la Open WebUI
Cum se adaugă un server MCP în panoul Admin Integrations.
# 1. Pornim serverul MCP pe rețeaua internă (ex. server de căutare în documentație):
$ mcp-server-docs --port 9090 --transport sse
# 2. În Open WebUI (Admin Settings -> External Tools / Integrations -> MCP):
Nume Server: 'Docs-Internal-MCP'
URL Transport: http://127.0.0.1:9090/sse
Autentificare: Bearer corp-secret-key-123
# 3. În conversație:
Utilizatorul selectează pictograma de unelte și bifează 'Docs-Internal-MCP'.
La întrebarea: 'Care este politica de decontare a echipamentelor?', modelul apelează unealta 'search_internal_docs' din MCP și returnează răspunsul exact cu citate de pagini.Rezultat & Impact
Acces instantaneu la cunoștințe private din companie prin protocol standardizat.Greșeli frecvente și bune practici
- Conectarea de servere MCP nesecurizate care permit rularea de comenzi arbitrare de sistem pe mașina gazdă într-o instanță Open WebUI deschisă public.
- Neglijarea verificării jurnalelor (logs) ale containerului când o conexiune SSE este întreruptă de un proxy Nginx configurat greșit.