Ako nakonfigurovať MCP servery v LibreChat a pripojiť externé nástroje

Ak ste sa niekedy zamýšľali nad tým, ako prinútiť umelú inteligenciu, aby prestala len generovať text a dokázala... dotazovať súbory, používať externé služby alebo spúšťať nástrojeLibreChat ponúka riešenie využívajúce Model Context Protocol.

El Protokol kontextu modelu, známy ako MCPIde o otvorený štandard, ktorý stanovuje spoločný spôsob prepojenia jazykových modelov so zdrojmi údajov a nástrojmi. Často sa porovnáva s USB-C, pretože sa vyhýba nutnosti vyvíjať úplne odlišnú integráciu pre každú aplikáciu, model alebo službu.

Vďaka tomuto protokolu sa LibreChat dokáže pripojiť k súborové systémy, databázy, prehliadače, úložiská kódu, podnikové nástroje a APIModel nezíska neobmedzený prístup jednoduchou aktiváciou MCP: môže používať iba funkcie sprístupnené jednotlivými servermi a autorizované používateľom alebo správcom.

Pred inštaláciou akéhokoľvek servera je vhodné skontrolovať jeho pôvod. Server MCP môže prijímať informácie z konverzácií a vykonávať akcie s povoleniami, ktoré mu boli udelené. Z tohto dôvodu, Nemali by ste inštalovať neznáme servery ani im poskytovať citlivé prihlasovacie údaje. bez toho, aby si najprv overili ich kód, dokumentáciu a povolenia.

Čo potrebujete na používanie MCP serverov v LibreChate

Na začiatok potrebujete mať Inštalácia LibreChatu bola aktualizovaná a prístup k jeho nastaveniam. V závislosti od zvolenej metódy budete potrebovať aj povolenie na úpravu súboru. librechat.yaml alebo autorizácia na vytváranie serverov z panela MCP rozhrania.

Konkrétne požiadavky závisia od servera, ktorý chcete použiť:

• Node.js alebo npx, keď je server distribuovaný ako balík JavaScript spustený pomocou stdio.
• Python a jeho závislosti, ak je server vyvinutý v tomto jazyku.
• Prístupná URL adresa, pri práci so vzdialeným serverom MCP.
• Kľúč API alebo autorizácia OAuth, ak sa nástroj pripája k chránenej službe.
• Prístup k sieti z kontajnera, keď je LibreChat spustený pomocou Dockeru.

Musíte tiež použiť model, ktorý podporuje volania nástrojov. Aj keď je server správne pripojený, Model bez podpory nástrojov nemusí vedieť, ako vyvolať svoje funkcie alebo prinášajú nespoľahlivé výsledky.

Spôsoby pridania MCP serverov do LibreChatu

LibreChat vám umožňuje konfigurovať MCP servery pomocou dva hlavné postupyz grafického rozhrania alebo manuálnou úpravou súboru librechat.yaml.

Toto rozhranie je pre väčšinu používateľov najpohodlnejšou metódou. Z panela MCP v pravom bočnom paneli si môžete zobraziť existujúce servery a pomocou príslušného tlačidla pridať nový. Tento postup vám umožňuje zadať názov, transport, URL a prihlasovacie údaje. bez úpravy súborov alebo reštartovania LibreChatu.

Dostupnosť tejto možnosti môže závisieť od oprávnení nakonfigurovaných správcom. LibreChat umožňuje samostatnú kontrolu nad tým, či používateľ môže používať, vytvárať, zdieľať alebo publikovať MCP servery.

Konfigurácia pomocou librechat.yaml Poskytuje väčšiu kontrolu a je obzvlášť užitočný pre administrátorov, reprodukovateľné nasadenia alebo zdieľané servery. V tomto prípade akýkoľvek nový server alebo úprava súboru vyžaduje Reštartujte LibreChat pre inicializáciu pripojenia.

Jednoduché nastavenie pomocou stdio môže vyzerať takto:

mcpServers:
  filesystem:
    type: stdio
    command: npx
    args:
      - -y
      - "@modelcontextprotocol/server-filesystem"
      - "/ruta/a/documentos"

Zadaný adresár bude prístupný serveru. Preto musíte obmedziť prístup na konkrétne miesto a vyhnúť sa udeľovaniu prístupu... celý súborový systém pokiaľ to nie je absolútne nevyhnutné.

Servery môžete vyhľadávať aj v katalógoch, ako je Smithery. Tieto platformy uľahčujú vyhľadávanie dostupných projektov a generovanie kompatibilných konfigurácií. Zobrazenie sa v katalógu však nezaručuje bezpečnosť serveraVždy si overte, kto ho spravuje, aké povolenia vyžaduje a aké príkazy bude vykonávať.

Ako používať nástroje MCP v chate

Po nadviazaní spojenia vám LibreChat umožní priamo používať MCP servery v konverzácii. Najprv si musíte jeden vybrať. model kompatibilný s nástrojmiPod poľom, kam píšete správu, sa zobrazí výber dostupných serverov.

Aktivácia servera sprístupní jeho nástroje modelu počas tejto konverzácie. Môžete vybrať viacero serverov súčasne, hoci je najlepšie vyhnúť sa pridávaniu nepotrebných funkcií, pretože Nadmerný počet nástrojov môže zväčšiť kontext a sťažiť správny výber modelu..

Správca môže zabrániť zobrazeniu servera v tejto ponuke pridaním možnosti:

chatMenu: false

V takom prípade server zostane agentom dostupný, ale v bežných chatoch sa nezobrazí ako voliteľný nástroj.

Každú operáciu by ste mali pred schválením skontrolovať, najmä ak nástroj dokáže mazať súbory, upravovať databázy, odosielať informácie alebo vykonávať nezvratné akcie.

Ako pridať nástroje MCP agentovi

Servery MCP je možné použiť aj s Agenti LibreChatuZ nástroja Agent Builder môžete otvoriť sekciu nástrojov, vybrať server a rozhodnúť sa, ktoré z jeho funkcií budú k dispozícii.

Táto individuálna kontrola je obzvlášť užitočná, keď server sprístupňuje veľa nástrojov. Napríklad môžete povoliť jednému agentovi dotazovať databázu, ale zabrániť ostatným v tom. upraviť alebo odstrániť záznamy.

LibreChat tiež podporuje lenivé načítavanie nástrojov. Keď je funkcia označená ako lenivá, nezaberá miesto v počiatočnom kontexte modelu. Namiesto toho agent použije vyhľadávací systém na jej nájdenie, keď je to potrebné. Táto možnosť pomáha znížiť spotrebu kontextu pri pripájaní serverov, ktoré ponúkajú desiatky funkcií.

Všeobecným odporúčaním je uplatňovať princíp najmenších privilégií: každý agent by mal mať iba základné nástroje na vykonávanie ich funkcie.

Dostupné typy prepravy pre MCP

LibreChat momentálne podporuje nasledujúce transporty stdio, streamovateľné HTTP, SSE a WebSocketVýber závisí od toho, kde server beží a ako potrebuje komunikovať s LibreChatom.

Doprava stdio Spustí lokálny proces a komunikuje s ním pomocou štandardného vstupu a výstupu. Toto je bežné na serveroch s npxPython alebo iné lokálne príkazy. Je to pohodlné pre osobné inštalácie, ale v Dockeri alebo distribuovaných prostrediach sa to môže skomplikovať.

Pre nové vzdialené servery, Streamovateľný HTTP je zvyčajne najviac odporúčanou alternatívouFunguje cez HTTP a je najvhodnejší pre hostované služby, nasadenia s viacerými používateľmi a systémy, ktoré je potrebné škálovať.

Základná konfigurácia vzdialeného prístupu môže byť:

mcpServers:
  herramientas-remotas:
    type: streamable-http
    url: "https://ejemplo.com/mcp"
    timeout: 60000
    initTimeout: 10000

Doprava SSE Naďalej je podporovaný a môže byť potrebný pre staršie servery, ktoré používajú udalosti odoslané serverom. WebSocket je k dispozícii aj pre služby, ktoré udržiavajú trvalú komunikáciu pomocou adries. ws:// o wss://.

Ak je pole vynechané typeLibreChat dokáže odvodiť dopravu z prítomnosti command alebo formát URL adresy. Napriek tomu, Jeho explicitné uvedenie uľahčuje čítanie a diagnostiku konfigurácie.

Dôležité parametre súboru librechat.yaml

Potrebné parametre sa menia v závislosti od použitého transportu. Na serveroch stdio sú hlavnými poľami command y argsPrvý označuje program, ktorý sa má vykonať, a druhý obsahuje argumenty predložené v procese.

Môže sa tiež použiť env poskytnúť premenné prostredia:

mcpServers:
  servidor-local:
    type: stdio
    command: npx
    args:
      - -y
      - "paquete-del-servidor"
    env:
      NODE_ENV: "production"

V diaľkovej doprave je základným parametrom urlMôžu byť tiež pridané HTTP hlavičky, odchádzajúci proxy, autentifikácia a dynamické premenné.

Ďalšie dôležité parametre sú:

• timeout: maximálny čas povolený na vykonanie operácie.
• initTimeout: čas dostupný na inicializáciu servera.
• startup: Umožňuje vám zabrániť pripojení servera po spustení LibreChatu.
• chatMenu: Skontrolujte, či sa zobrazuje vo výbere oblasti chatu.
• requiresOAuth: Označuje, či vzdialený server vyžaduje overenie OAuth.
• headers: Umožňuje odosielanie vlastných hlavičiek vo vzdialených pripojeniach.

Kľúče by ste nemali ukladať priamo do súboru, ktorý sa nahrá na GitHub. Pre tajné kľúče zdieľané v rámci celej inštalácie je bezpečnejšie použiť premenné prostredia, ako napríklad ${NOMBRE_VARIABLE}.

Ako pripojiť MCP servery pri používaní Dockeru

Keď LibreChat beží v Dockeri, príkazy a adresy sa interpretujú z kontajnera a nie z hostiteľského systémuTento rozdiel vysvetľuje mnohé chyby v pripojení.

Ak konfigurujete server stdio, ktorý sa spolieha na Node.js, Python alebo konkrétnu aplikáciu, tieto závislosti musia byť dostupné v kontajneri, na ktorom beží LibreChat. Mali by byť nainštalované iba na hostiteľskom systéme Windows alebo Linux. To neznamená, že ich kontajner môže použiť..

Tiež by ste mali byť opatrní s localhostV rámci kontajnera táto adresa odkazuje na samotný kontajner. Ak je server MCP spustený na hostiteľskom počítači, možno budete musieť použiť adresu ako:

http://host.docker.internal:3001/mcp

Presná cesta závisí od operačného systému a konfigurácie Dockeru. Ďalšou možnosťou je spustiť MCP server vo vlastnom kontajneri a prepojiť obe služby pomocou rovnaká sieť Docker Compose.

Pred úpravou LibreChatu overte, či koncový bod reaguje priamo z kontajnera. To vám pomôže rozlíšiť problém s protokolom od problému so samotným protokolom. zlyhanie siete, DNS, portu alebo závislosti.

Autentifikácia OAuth pre servery MCP

Podpora LibreChatu OAuth 2.0 na individuálne overovanie používateľov pri prístupe k vzdialeným serverom MCP. Keď zistí, že server vyžaduje autorizáciu, zobrazí sa možnosť spustenia procesu z prehliadača.

Vrátená URL adresa má tento formát:

https://tu-dominio.com/api/mcp/nombre-del-servidor/oauth/callback

Názov sa musí presne zhodovať s kľúčom použitým v rámci mcpServers alebo s názvom priradeným serveru z rozhrania. V lokálnej inštalácii Dockeru môže byť typická základná adresa:

http://localhost:3080/api/mcp/nombre-del-servidor/oauth/callback

Táto URL adresa musí byť zaregistrovaná presne u poskytovateľa OAuth. Nesprávny protokol, iný port alebo variácia názvu zvyčajne spôsobia problémy. chyby presmerovania alebo neplatné spätné volanie.

Tokeny OAuth sú uložené pre každého používateľa, takže každá osoba pristupuje k externej službe pomocou vlastný účet a vlastné povoleniaToto je obzvlášť dôležité v zdieľaných zariadeniach.

Ako používať rôzne heslá pre každého používateľa

Nie všetky služby ponúkajú OAuth. Pre servery, ktoré používajú kľúče API alebo iné prihlasovacie údaje, poskytuje LibreChat customUserVars.

Táto funkcia vám umožňuje vyžiadať hodnotu od každého používateľa a potom ju použiť v hlavičke alebo premennej prostredia. Napríklad:

mcpServers:
  servicio-remoto:
    type: streamable-http
    url: "https://api.ejemplo.com/mcp"
    headers:
      Authorization: "Bearer {{MCP_API_KEY}}"
    customUserVars:
      MCP_API_KEY:
        title: "Clave de API"
        description: "Introduce tu clave personal"

Každý používateľ zadáva svoje vlastné prihlasovacie údaje prostredníctvom nastavení LibreChatu. Týmto spôsobom ich administrátor nemusí ukladať. jeden zdieľaný kľúč pre všetkých členov.

Tieto premenné je možné použiť aj na stdio serveroch prostredníctvom sekcie envAk si však všimnete, že server doslova prijíma značku namiesto očakávanej hodnoty, mali by ste skontrolovať, či je nainštalovaná verzia LibreChatu aktuálna.

Dynamické záložky a používateľské oprávnenia

LibreChat vám umožňuje odosielať na server dynamické informácie týkajúce sa osoby, ktorá zadáva požiadavku. Medzi dostupné značky patria polia ako napríklad:

{{LIBRECHAT_USER_ID}}
{{LIBRECHAT_USER_EMAIL}}
{{LIBRECHAT_USER_ROLE}}

Tieto hodnoty je možné zahrnúť do URL adresy alebo podporovaných hlavičiek, aby server vedel ktorý používateľ spúšťa každý nástroj.

Príklad dynamických hlavičiek by bol:

headers:
  X-User-ID: "{{LIBRECHAT_USER_ID}}"
  X-User-Email: "{{LIBRECHAT_USER_EMAIL}}"
  X-User-Role: "{{LIBRECHAT_USER_ROLE}}"

Tieto údaje môžu pomôcť pri vynucovaní povolení, zaznamenávaní transakcií alebo alokácii zdrojov. Server MCP však musí overiť informácie a nesmie sa slepo spoliehať na hlavičku na ochranu citlivých akcií.

LibreChat má tiež ovládacie prvky na určenie, kto môže používať, vytvárať, zdieľať alebo upravovať každý MCP serverV organizáciách je vhodné kombinovať tieto povolenia s obmedzeniami špecifickými pre danú externú službu.

Ako skontrolovať stav MCP servera

Panel MCP zobrazuje dynamické indikátory stavu Pre uľahčenie diagnostiky zelené ozubené koleso označuje aktívne pripojenie, oranžový kľúč označuje, že je potrebné overenie, a červený trojuholník varuje pred chybou.

Ak server prestane reagovať, môžete skúsiť Reštartujte pripojenie z rozhraniaTým sa zabráni reštartovaniu celej aplikácie, keď problém postihuje iba jeden server.

Ak problém pretrváva, skontrolujte:

• Záznamy serverov LibreChat a MCP.
• Že zadaný príkaz existuje v prostredí vykonávania.
• Uistite sa, že URL a port sú dostupné z LibreChatu.
• Že kľúč alebo token rozhrania API zostáva platný.
• Uistite sa, že server používa kompatibilný transport.
• Že vybraný model podporuje volania nástrojov.
• Že používateľ má povolenie používať server.

Zelený indikátor potvrdzuje, že pripojenie bolo nadviazané, ale nezaručuje, že všetky nástroje budú fungovať správne. Konkrétna operácia môže stále zlyhať. nedostatočné oprávnenia, nesprávne parametre alebo chyby externej služby.

Ako opraviť chyby časového limitu

Servery spracovávajúce zložité dotazy môžu vyžadovať viac času ako štandardná odpoveď v chate. V týchto prípadoch môžete čas odozvy predĺžiť. timeout pre operácie a initTimeout na začiatok.

Napríklad:

timeout: 120000
initTimeout: 30000

Hodnoty sú vyjadrené v milisekundách. Neodporúča sa ich bez rozdielu zvyšovať, pretože nadmerne dlhý čas môže spôsobiť, že zablokovaná operácia bude trvať veľmi dlho, kým sa znovu získa kontrola.

Ak používate Nginx, Traefik, Cloudflare alebo iný proxy, skontrolujte aj jeho limity. Hoci LibreChat čaká dve minúty, proxy môže ukončiť pripojenie skôr a spôsobiť neúplnú odpoveď alebo chybu siete.

Pri používaní Streamable HTTP alebo SSE skontrolujte aj to, či proxy umožňuje udržiavanie pripojenia počas potrebného času a či nesprávne neukladá odoslané odpovede do vyrovnávacej pamäte.

Ktoré MCP servery sa oplatí nainštalovať

Výber závisí od úlohy, ktorú chcete vykonať. Súborový server môže byť užitočný na prezeranie lokálnej dokumentácie, zatiaľ čo server pripojený k databáze umožňuje... Získajte aktuálne informácie bez kopírovania protokolov do chatu.

Medzi ďalšie bežné použitia patria:

• Konzultácie s repozitármi a riešenie problémov s vývojom.
• Vykonávajte vyhľadávanie na webe alebo ovládajte prehliadač.
• Prístup k databázam ako PostgreSQL alebo ClickHouse.
• Prepojte obchodné služby pomocou OAuth.
• Spúšťajte automatizácie a interné nástroje.

Nemusíte inštalovať veľa serverov od začiatku. Je lepšie začať s jedným, skontrolovať jeho povolenia a overiť akcie, ktoré dokáže vykonávať. Potom môžete postupne rozširovať inštaláciu a priraďovať úlohy. rôzne nástroje pre každého agenta.

Integrácia MCP transformuje LibreChat na viac než len rozhranie na chatovanie s modelkami. Prostredníctvom lokálnych alebo vzdialených serverov môžete pristupovať k aktuálnym informáciám a vykonávať externé funkcie z jedného systému.

Najjednoduchšie nastavenie zahŕňa pridanie servera z panela MCP. Pre spravované nasadenia, librechat.yaml Ponúka väčšiu kontrolu nad transportom, čakacími dobami, autentifikáciou a dynamickými premennými. V oboch prípadoch musí byť bezpečnosť prioritou. Skontrolujte server, obmedzte jeho povolenia a starostlivo autorizujte citlivé akcie..