Plugin pre pripojenie MCP

Zabudovaný plugin MCP pripája servery Model Context Protocol a sprístupňuje ich nástroje Elowenu. Podporuje miestne procesy stdio a vzdialené pripojenia streamable http. Ako server pridať a ako jeho nástroje používať nájdete v MCP.

Ciele na miestnom počítači

Operácie MCP cez HTTP a len cez API zostávajú v miestnych konverzáciách dostupné. Pre vybraný spárovaný počítač bežia servery stdio na tomto počítači s jeho nainštalovanými príkazmi a pracovným adresárom. Každá operácia otvorí a zatvorí vlastné pripojenie aj proces, vrátane inicializácie; ďalší ťah začne novú operáciu. Príkaz servera musí byť na počítači nainštalovaný. Centrálne uložené premenné prostredia príkazu sú odmietnuté, takže prihlasovacie údaje nastavte priamo na počítači. Odpojená operácia zlyhá s LOCAL_EXECUTION_LOST a nikdy sa neopakuje ani nespúšťa na hostiteľovi démona.

Správa MCP serverov

Otvorte MCP v bočnom paneli webového rozhrania. Pomocou Pridať server nastavte názov, vlastníctvo, prenos a údaje o pripojení. Pre stdio zadajte príkaz, argumenty a prípadné premenné prostredia. Pre streamable http zadajte URL. Server môžete zapnúť alebo vypnúť, zobraziť jeho zistené nástroje, prehľadávať a filtrovať zoznam, znova pripojiť jeden server alebo zvoliť Znova pripojiť všetko. Vyberte niekoľko serverov a zapnite, vypnite alebo vymažte ich spoločne.

Zapnutý server sa pri uložení overí a zistia sa jeho nástroje. HTTP servery vyžadujúce OAuth zostanú uložené, keď je potrebná autorizácia alebo keď zlyhá zistenie OAuth či registrácia klienta. Neúspešné nastavenie OAuth zobrazí Chyba prihlásenia a diagnostiku, ktorá pomenuje zlyhanú fázu alebo stav HTTP. Chyba aj jej akcia na prihlásenie prežijú reštart Elowenu. Tela odpovedí poskytovateľa sa nikdy nezobrazujú. Ostatné chyby overenia sa ohlásia, ale zmena sa neuloží.

Stránka ukazuje, či je server Pripojené, Odpojené, v stave Chyba alebo Zakázané, spolu s prenosom, vlastníctvom a počtom nástrojov. Zapnutý server môže byť aj odpojený, čo je niečo iné ako vypnutý. Po vyriešení chyby použite Znova pripojiť. Znova pripojiť všetko skúsi znova vhodné odpojené alebo chybové servery a ohlási úspechy aj chyby. Webová stránka aj CLI preskakujú servery čakajúce na prihlásenie a nepodporované servery SSE. Na autorizáciu použite samostatnú akciu Prihlásiť sa. Odobraním servera budú jeho nástroje okamžite nedostupné. Uloženie nastavení pluginu alebo jeho zapnutie či vypnutie vyžiada reštart Elowenu, aby sa zmena prejavila.

Telemetrický pruh chatu nesie časť MCP s počtom pripojených serverov zo všetkých nastavených; vypisuje pripojené servery a tie, ktoré potrebujú prihlásenie. Výberom riadku otvoríte stránku MCP.

V CLI vypíše /mcp Vaše osobné servery a servery inštancie, ktoré smiete spravovať. Každá položka ukazuje vlastníctvo, stav pripojenia, stav prihlásenia a zistené nástroje. Vlastníctvo a názov spolu určujú server, takže dva rozsahy môžu mať servery s rovnakým názvom. Stlačením Enter otvoríte podrobnosti. Stlačením r znova pripojíte vybraný server, R skúsi znova zapnuté servery, ktoré sú odpojené alebo chybové, a Ctrl+L obnoví zoznam. Výsledok opätovného pripojenia hlási stav pripojenia, ktorý server vrátil, nie len to, či požiadavka uspela. Pripojený server bez nástrojov je platný. Znova pripojiť všetko ohlási, koľko serverov sa pripojilo, bolo overených vo svojom spravovanom Projekte, potrebuje prihlásenie alebo zlyhalo, s diagnostikou pri každej chybe. Je dostupné len vtedy, keď je plugin zapnutý.

Pri HTTP serveroch, ktoré potrebujú autorizáciu, zvoľte Prihlásiť sa vo výbere podrobností. CLI otvorí autorizačnú adresu v prehliadači a ponechá ju v oznámení, takže ju môžete otvoriť aj ručne, vrátane pripojenia cez SSH. Dokončite prihlásenie tým istým účtom Elowen a potom zvoľte Obnoviť stav. Obnovenie len číta aktuálny stav a nikdy nespúšťa ďalšie prihlásenie. Žiadny proces na pozadí nečaká na súhlas v prehliadači. Zatvorením výberu klávesom Escape zostane prihlásenie v prehliadači čakajúce, kým po desiatich minútach nevyprší. Nové spustenie prihlásenia nahradí čakajúcu požiadavku. Odhlásiť sa vymaže prihlasovacie údaje servera a zruší každé čakajúce prihlásenie.

HTTP servery vyžadujúce OAuth zostanú uložené, keď je potrebná autorizácia. Pomocou Prihlásiť sa server autorizujte a pomocou Odhlásiť sa vymažte jeho prihlasovacie údaje, čakajúce prihlásenie aj živé pripojenie. Uložené servery SSE nie sú podporované a nikdy sa nepripoja. Nahraďte ich servermi streamable HTTP. Prihlasovacie údaje sa vymažú pri vymazaní servera, pri zmene jeho URL, pri prevode vlastníctva alebo pri odobratí osobného vlastníka.

Skupina Nastavenia servera je na začiatku otvorená a pamätá si, či je zbalená, zvlášť pre každý server. Vlastníctvo a prenos používajú rozbaľovacie ponuky. Argumenty a hodnoty prostredia používajú viacriadkové polia. Zmeny napriek tomu vyžadujú Uložiť. Stav pripojenia a akcie OAuth zostávajú viditeľné aj pri zbalenej skupine.

Nastavenie OAuth

OAuth vyžaduje nastavenú verejnú webovú adresu. Niektoré servery podporujú dokumenty s metadátami klienta a nemajú registračný koncový bod. Pre ne Elowen zverejní verejný dokument klienta HTTPS na /hooks/mcp/oauth/client-metadata na Vašej inštancii. Adresa dokumentu je ID klienta a dokument deklaruje /p/mcp/oauth/callback inštancie ako cieľ presmerovania. Neobsahuje prihlasovacie údaje, údaje účtu ani nastavenia servera. Ponechajte verejný pôvod HTTPS a adresu dokumentu stabilné po celý čas používania pripojenia, vrátane neskorších obnovení tokenov. Keď verejný pôvod zmeníte a reštartujete, ID klienta aj cieľ spätného volania sa zmenia. Odhláste sa a prihláste znova. Vypnutie pluginu MCP odstráni verejný dokument, takže autorizačný server už tohto klienta nerozpozná.

Server s registračným koncovým bodom používa dynamickú registráciu klienta, aj keď zároveň ponúka dokumenty klienta.

Ak chcete prejsť z proxy OAuth pre stdio na priame HTTP, pridajte koncový bod HTTP a prihláste sa k nemu. Prihlasovacie údaje sa kľúčujú podľa vlastníka, názvu servera a URL, takže nová položka potrebuje vlastné prihlásenie. Skôr než proxy vyradíte, overte priame pripojenie a jeho nástroje.

Spätné volanie OAuth v prehliadači

Po schválení prístupu poskytovateľ presmeruje na stránku spätného volania MCP na /p/mcp/oauth/callback. Stránka dokončí prihlásenie a potom odstráni prihlasovací kód z adresného riadka. Ak adresa neobsahuje state, stránka zobrazí chybu neplatnej požiadavky a nič neodošle.

Kým prihlásenie potvrdzuje, stránka ukazuje stav načítavania. Pri úspechu zobrazí krátke potvrdenie a vráti sa na /p/mcp, takže tlačidlo Späť nemôže odoslať spätné volanie znova. Ak požiadavka na prihlásenie vypršala, nebola rozpoznaná, bola odmietnutá alebo zlyhala, stránka zobrazí zodpovedajúcu správu. Keď sieť zlyhá alebo je odpoveď neočakávaná, zobrazí všeobecnú správu o zlyhaní a žiadne podrobnosti o serveri. Zlyhania sa neopakujú. Spustite nové prihlásenie z MCP.

Spätné volanie potrebuje prihlásenú reláciu. Ak prídete odhlásení, Elowen najprv zobrazí svoj prihlasovací formulár a stránka potom dokončí čakajúce prihlásenie, kým neuplynie desať minút. Keď prihlásenie nemožno dokončiť, spustite nové z MCP.

Správanie pripojenia

Server môže poskytovať zdroje bez nástrojov a napriek tomu sa pripojiť. Nula nástrojov je platný výsledok. Nástroje sa zisťujú len vtedy, keď ich server ponúka.

Po úspešnom opätovnom pripojení servera viazaného na spravovaný Projekt ho Elowen ohlási ako overené v projekte, nie ako pripojené. Stav pripojenia zostáva odpojený, pretože každá operácia otvára a zatvára vlastné pripojenie. Znova pripojiť všetko počíta tieto overené servery oddelene od živých pripojení a zlyhaní.

Servery inštancie sa pripoja pri načítaní pluginu a pripojenie aj zisťovanie nástrojov obmedzuje časový limit pripojenia. Pokus o pripojenie, ktorý zlyhá v sieti, vyprší alebo odpovie stavom HTTP 408, 429 či chybou servera, sa opakuje najviac stanovený početkrát a stav servera hlási prebiehajúci pokus. Server, ktorý potrebuje prihlásenie, odmietne požiadavku stavom HTTP 401 alebo 403 alebo odpovie chybou protokolu, sa znova neskúša; po vyriešení použite Znova pripojiť. Osobné vzdialené servery sa pripoja pri prvom volaní niektorého ich nástroja. Do tej doby sa ich nástroje vypisujú z posledného úspešného zistenia. Ak server nemá uložené zistenie, pripojte ho znova, aby sa jeho nástroje zistili. Osobné nástroje sa registrujú len pre účet, ktorý ich vlastní. Nástroje inštancie sú dostupné všetkým konverzáciám. Oprávnenia nástrojov účtu môžu jednotlivé nástroje ďalej obmedziť.

Server stdio spúšťa príkaz ako miestny proces. Vytvoriť alebo spustiť ho môžu len administrátori inštancie, aj keď je označený ako osobný. Jeho argumenty sa odovzdajú tomuto príkazu a hodnoty prostredia sú pre proces dostupné. Nastavte len príkazy, ktorým dôverujete. Ak server stdio vytvoríte s vybraným spravovaným Projektom, pripne sa k tomuto Projektu a beží tam. Pripojenie nemožno neskôr zmeniť. Uloženie pripojenia overí Váš aktuálny prístup k Projektu, aj keď je server vypnutý. Vzdialené HTTP servery nikdy nespúšťajú miestny príkaz. Uložené centrálne premenné prostredia nemožno do spravovaného Projektu importovať, takže jeho prihlasovacie údaje nastavte vnútri Projektu.

Názov servera možno použiť v osobnom aj inštančnom rozsahu, ale nie dvakrát v tom istom rozsahu. Pretože servery inštancie vidí každý účet, osobný server nemôže prevziať názov servera inštancie.

Nástroje MCP

Výber /mcp aj stránka MCP Vám pomôžu skontrolovať pripojenia. Nástroje vyššie umožňujú spravovať servery aj asistentovi. AddMcpServer vyžaduje scope vlastníctva, buď personal, alebo instance. Pridanie servera, ktorý potrebuje OAuth, ohlási, že server bol uložený, a odkáže Vás na /mcp alebo /p/mcp na výslovné prihlásenie. Neúspešné nastavenie OAuth sa vráti ako chyba, ktorá nesie uložený server a bezpečnú diagnostiku. Nikdy netvrdí, že je pripojený. ReconnectMcpServer hlási pripojenia vyžadujúce prihlásenie a zlyhané pripojenia tak, ako sú. Ani jeden nástroj sám nespúšťa prihlásenie.

Na stránke MCP možno definície nástrojov poskytnuté serverom zobraziť, ale nie upraviť. Meňte ich na serveri samotnom. Nástroje pre zdroje sú len na čítanie. Každé binárne čítanie zapíše nový súbor a skoršie súbory ponechá, takže cesta zo skoršieho čítania stále drží svoje bajty. Výsledok vráti cestu, až je súbor kompletný. Ak uloženie zlyhá, položka zdroja ohlási chybu a neúplný súbor sa odstráni. Keď server vráti chybu ako obsah, chyba zostane čitateľná. Chyby pripojenia a časových limitov sa hlásia ako chyby nástroja.

Vlastníctvo a prihlasovacie údaje

Servery Osobné patria prepojenému účtu, ktorý ich vytvoril. Len tento účet ich môže spravovať a používať. Servery Inštancia sú zdieľané a spravujú ich administrátori inštancie. Vytvorenie osobného servera vyžaduje prepojený účet. Vytvorenie, aktualizácia, odobratie alebo opätovné pripojenie servera inštancie vyžaduje prístup administrátora. Plugin nemožno prideľovať používateľom a jeho zapnutie nezobrazuje samostatnú otázku na súhlas.

Editor ukazuje názvy nastavených premenných prostredia, nikdy ich hodnoty. Ak chcete pridať alebo zmeniť hodnoty prostredia stdio, zadajte ich ako KEY=value. Ponechanie poľa prázdneho zachová existujúce hodnoty. Nástroj ListMcpServers nikdy nevracia prihlasovacie údaje, príkazy ani hodnoty prostredia. Vzdialený HTTP server sa môže presunúť medzi inštančným rozsahom a Vaším osobným rozsahom. Server stdio rozsah zmeniť nemôže. Ak ho chcete presunúť, vytvorte ho znova v druhom rozsahu. Odobratie účtu odstráni aj jeho osobné servery a ich uložené zistenia nástrojov.

Nastavenia a limity

V Nastavenia → Pluginy otvorte nastavenia pluginu MCP a nastavte globálne hodnoty Časový limit pripojenia a Časový limit volania nástroja:

Tieto časové limity platia pre všetky servery. Hodnoty mimo rozsahu sa nastavia na najbližšiu povolenú hodnotu. Názov servera musí mať 1–40 znakov. Musí začínať písmenom alebo číslicou a smie obsahovať len písmena, číslice, podčiarkovníky a pomlčky. Názvy sú v jednom rozsahu vlastníctva jedinečné.

Adresy HTTP musia používať HTTP alebo HTTPS. Nesmú obsahovať používateľské meno, heslo ani parameter dotazu, ktorý vyzerá ako tajomstvo, napríklad token alebo kľúč API. Názvy nástrojov zo servera sa normalizujú na slová malými písmenami oddelené podčiarkovníkmi, pričom názov servera aj nástroja je obmedzený na 40 znakov. Popis servera je obmedzený na 2 048 znakov. Vrátené obrázky sa zmenšia tak, aby žiadna hrana nepresiahla 2 000 pixelov. Ostatné výsledky, ktoré nie sú text, sa nahradia krátkym zástupným textom. V spravovanom Projekte je binárny zdroj obmedzený na 16 MiB.

Ďalej: Session Helpers