Ghid pentru conectarea Open WebUI cu serverele MCP

 

Tehnologie Protocolul de context al modelului (MCP) Permite modelelor de limbaj AI să depășească mediul de chat și să interacționeze cu instrumente externe și date în timp real. Prin urmare, Conectați Open WebUI la serverele MCP Este o idee grozavă dacă vrei să-ți duci jocul la nivelul următor.

Adevărul este că, deși pare complicat, integrarea serverelor MCP nu este o știință complicată dacă știi de unde să începi. Indiferent dacă ești în căutarea unui implementare nativă Indiferent dacă aveți nevoie de o punte pentru servere care rulează pe STDI sau HTTP, există căi clare pentru ca modelul dvs. să acceseze documentația tehnică, bazele de date sau orice serviciu extern care acceptă acest protocol.

Cum se conectează Open WebUI cu serverele MCP

Începând cu versiunea 0.6.31, Open WebUI include deja suport nativ pentru MCPTotuși, există o avertizare importantă: funcționează doar prin HTTP transmisibil în fluxAsta înseamnă că nu te poți conecta direct la un server care folosește stdio (standardul de intrare/ieșire), deoarece arhitectura web a platformei necesită comunicații bazate pe HTTP pentru a gestiona în siguranță mai mulți utilizatori și sesiuni.

Pentru a conecta Deschideți interfața web Cu serverele MCP, un administrator trebuie să acceseze Setări de administrare și accesați secțiunea Instrumente externe. De acolo, pur și simplu adăugați un server nou, selectați tipul MCP și introduceți adresa URL corespunzătoare. Este esențial să știți că numai administratori Aceste servere pot fi înregistrate, deoarece un server MCP are permisiuni extinse asupra sistemului, iar permiterea oricărui utilizator să instaleze unul ar reprezenta un risc de securitate enorm.

În ceea ce privește autentificarea la conectarea Open WebUI la serverele MCP, aveți mai multe opțiuni în funcție de locația serverului. Dacă este o configurație locală și cu risc scăzut, alegeți "Nici unul"Dar atenție: dacă selectați „Purtător” și lăsați cheia necompletată, multe servere vor respinge conexiunea. Pentru medii mai profesionale, puteți utiliza OAuth 2.1, fie static (cu ID client și secret), fie dinamic, permițând inteligenței artificiale să se autentifice în siguranță înainte de a accesa datele.

Utilizarea MCPO ca punte pentru serverele locale

Ce se întâmplă dacă ai un server MCP descărcat care folosește stdio și nu HTTP? Aici devin interesante lucrurile. MCPO (Orchestrator de protocol de context model)Acest program acționează ca un proxy care traduce acele servere „tradiționale” într-un format OpenAPI compatibil cu HTTP, determinând Open WebUI să le vadă ca instrumente standard.

Pentru a configura acest sistem și a conecta Open WebUI la serverele MCP, cea mai simplă metodă este să utilizați Docker. Mai întâi, implementați containerul de Deschideți interfața web cu Ollama și apoi lansați containerul MCPO. Acesta din urmă are nevoie de un fișier numit config.json unde definiți serverele MCP pe care doriți să le conectați. După ce fișierul este creat pe PC, trebuie să îl copiați în volumul containerului folosind comenzi Docker, astfel încât orchestratorul să știe ce instrumente să pornească.

Odată ce MCPO rulează pe portul 8000, trebuie să reveniți la Open WebUI și să adăugați instrumentul care indică adresa. http://host.docker.internal:8000Dacă aveți mai multe servere configurate în JSON, va trebui să le adăugați pe fiecare dintre ele, specificând calea sa specifică, de exemplu, adăugând punctul final al serverului de documentație Microsoft la sfârșitul adresei URL.

Configurarea și optimizarea modelului

Pentru a conecta Open WebUI cu serverele MCP, simpla conectare a serverului nu este suficientă: trebuie să îi spuneți modelului să utilizeze acele instrumente. Accesați secțiunea Modele, alegeți-l pe cel pe care doriți să îl îmbunătățiți și introduceți... Parametri avansațiAcolo, ajustarea cheie este de a schimba Apelarea funcției de la „Implicit” la „Nativ”Dacă nu faceți această modificare, modelul va ignora probabil instrumentele disponibile.

Apoi, pe aceeași pagină de setări, derulați în jos până la secțiunea instrumente și activați serverele MCP pe care l-ați înregistrat anterior. Există, de asemenea, un câmp numit „Listă de filtre pentru nume de funcții”. În mod normal, acesta este lăsat gol pentru a utiliza totul, dar dacă observați că conexiunea eșuează, un truc foarte eficient este puneți o virgulă simplă (,)Acest lucru forțează sistemul să valideze lista și, de obicei, rezolvă erorile de analiză.

Dacă primiți o eroare de conexiune atunci când încercați să utilizați instrumentul, chiar dacă butonul de verificare spune că totul este în regulă, verificați autentificarea. Uneori, strângere de mână inițială Răspunsul serverului este prea lent și depășește timpul de așteptare așteptat. În astfel de cazuri, se recomandă creșterea valorii lui MCP_INITIALIZE_TIMEOUT, care implicit este de 10 secunde, pentru a-i oferi serverului timp să pornească.

După conectarea Open WebUI cu serverele MCP și configurarea corectă a fluxului de lucru dintre model, orchestratorul MCPO și interfața Open WebUI, o simplă fereastră de chat poate fi transformată într-un centru de comandă capabil să ruleze scripturi, să consulte manuale tehnice și să gestioneze date complexe folosind standardul Model Context Protocol, asigurând o comunicare fluidă și o securitate care se află întotdeauna sub controlul administratorului.