Navigace
ELOWEN · Dokumentace

Poslední aktualizace: 20. října 2026

Procházet dokumentaci · Integrace MCP
Rozšíření

Integrace MCP

MCP propojuje Elowen s externími servery nástrojů. Spravujete je na stránce MCP, která je v hlavní navigaci na adrese /p/mcp. Seznam serverů je stránkovaný; hledání a filtry vlastnictví a stavu ho zužují a Řazení ho řadí podle názvu nebo počtu nástrojů, zatímco výchozí pořadí drží osobní servery a servery instance pohromadě. Správu pluginů popisuje část Pluginy.

Přidejte externí MCP server

Na stránce MCP zvolte Přidat server, zadejte jedinečný Název, vyberte Přenos a Vlastnictví, doplňte volitelný Popis serveru a pak zvolte Uložit. Popis se zobrazuje v seznamu serverů a lze ho později vyhledat i upravit. Názvy mají 1–40 znaků: písmena, čísla, podtržítka nebo pomlčky, začínající písmenem nebo číslem. Ponechejte Zapnuto, aby byly nástroje dostupné; vypnutím server uložíte, aniž by se připojil. Zapnuté servery se při uložení zkontrolují a jejich nástroje se objeví. Server vyžadující přihlášení OAuth zůstává nastavený se stavem Vyžaduje přihlášení, dokud ho neschválíte.

Zvolte jeden přenos:

  • stdio spustí příkaz jako místní proces.
  • Streamable HTTP se připojuje ke koncovému bodu MCP přes HTTP nebo HTTPS.

Pro stdio zadejte Příkaz, jeden argument na řádek v části Argumenty, a proměnné prostředí v části Proměnné prostředí ve tvaru NAME=value, jednu na řádek. Spouští se místní proces, proto servery stdio smějí spravovat a spouštět jen administrátoři Elowen, bez ohledu na vlastnictví. Přidávejte jen příkazy, kterým důvěřujete. Server stdio vytvořený s vybraným spravovaným Projektem je na tento Projekt vázán: vazbu nelze změnit a jeho nástroje jsou dostupné jen z toho Projektu.

Pro Streamable HTTP zadejte URL serveru. Propojený účet si může tyto vzdálené servery držet ve svém osobním rozsahu. V autorizované konverzaci nabízejí AddMcpServer, ListMcpServers, ReconnectMcpServer a RemoveMcpServer stejné akce správy serverů a podléhají stejným pravidlům přístupu.

Zvolte vlastnictví serveru

  • Osobní servery patří propojenému účtu, který je vytvořil. Jen tento účet je může spravovat a používat; ve sdílených konverzacích jsou dostupné jen v tazích tohoto účtu. Odebráním účtu se odeberou i jeho osobní servery.
  • Instance servery jsou sdílené napříč způsobilými konverzacemi. Spravovat je mohou jen administrátoři Elowen.

Konverzace může používat servery instance a osobní servery aktuálního účtu. Názvy musí být jedinečné v každém rozsahu, který daný účet vidí. Vzdálené HTTP servery lze přesouvat mezi instancí a osobním rozsahem jednajícího účtu. Přesun nemůže převést vlastnictví na jiný účet. Servery stdio přesouvat nelze; vytvořte je znovu v cílovém rozsahu.

Osobní servery se připojují při prvním použití, servery instance při startu pluginu MCP. Osobní server potřebuje úspěšné objevení nástrojů, než lze jeho nástroje použít. Po opravě nefunkčního nebo odpojeného serveru použijte Znovu připojit; uzavře aktuální spojení a znovu objeví jeho nástroje. Stránka MCP ukazuje Připojeno, Odpojeno, Chyba nebo Zakázáno, s poslední chybou, je-li dostupná. Odebrání serveru pomocí Odebrat server smaže jeho konfiguraci, ukončí spojení a znepřístupní jeho přemostěné nástroje. Když server hlásí Chyba, opravte jeho URL nebo přihlašovací údaje a teprve pak zvolte Znovu připojit.

Přihlaste se k serveru

Otevřete detail serveru. Stav přihlášení je oddělený od stavu připojení: Přihlášení není potřeba, Přihlášeno, Vyžaduje přihlášení, Chyba přihlášení nebo Nepodporovaný přenos.

Když je přihlášení potřeba nebo selhalo, zvolte Přihlásit se. Elowen otevře autorizační stránku serveru na nové kartě. Dokončete tam autorizaci a vraťte se do Elowen a obnovte stav. Žádost o přihlášení vyprší po 10 minutách; pokud už vypršela, zahajte novou. Když prohlížeč novou kartu zablokuje, povolte ji pro Elowen a zkuste to znovu. Samotné otevření autorizační stránky neznamená, že jste přihlášeni. Požadovaná oprávnění se v detailu zobrazují v části Oprávnění, když je server uvede.

Po autorizaci se poskytovatel vrací na stránku zpětného volání MCP. Elowen okamžitě odstraní autorizační kód z adresního řádku, jednou potvrdí výsledek přes své ověřené API a nahradí záznam zpětného volání v historii prohlížeče stránkou MCP. Chybějící nebo neplatná žádost, vypršelá žádost, odmítnutá autorizace nebo neúspěšné potvrzení zobrazí konkrétní zprávu a odkaz Zpět do MCP. Zahajte nové přihlášení, místo abyste obnovovali stránku nebo znovu odesílali neúspěšné zpětné volání.

Pokud jste při návratu odhlášeni z Elowen, přihlaste se stejným účtem, který autorizaci zahájil. Přihlášení heslem adresu zpětného volání zachová; úspěšné SSO Microsoftu se na tuto adresu vrací. Server před přijetím autorizace stále kontroluje účet a jednorázovou žádost.

Zvolením Odhlásit se odstraníte uloženou autorizaci. Během čekající žádosti jsou tlačítka neaktivní a odmítnutá žádost zůstává v detailu viditelná. Přihlašovací údaje zůstávají v rozsahu vlastnictví serveru a v prohlížeči se nikdy nezobrazují.

Servery se starším SSE zůstávají viditelné jako Nepodporovaný přenos, ale nelze je zapnout ani znovu připojit. Elowen jejich URL sám od sebe nepřevádí. Otevřete detail, výslovně zvolte Streamable HTTP, zadejte koncový bod streamable HTTP daného serveru a uložte. Dokud není zvolen podporovaný přenos, Uložit zůstává neaktivní.

Spravujte nástroje serveru

Každý objevený nástroj se zobrazuje jako mcp__<server>__<tool>, například mcp__github__create_issue. Názvy se normalizují na malá slova oddělená podtržítky a každá část se zkracuje na 40 znaků. Nástroj a jeho vstupní pole definuje server; na stránce MCP je můžete prohlížet, ale ne upravovat.

Plugin MCP navíc nabízí ListMcpResources a ReadMcpResource pro servery, které publikují zdroje. Načítají se na vyžádání a platí pro ně stejná pravidla viditelnosti jako pro nástroje serverů.

Načítejte odložené nástroje MCP

Odkládání nástrojů je ve výchozím stavu zapnuté v části Načítání nástrojů. Uplatní se, když má konverzace bez výslovné volby víc než 10 nástrojů, a to u nástrojů MCP i pluginů. Tehdy zůstávají plně načtené jen základní nástroje (Bash, Read, Edit, Grep a Write); každý další nástroj se načítá na vyžádání. Menší sady nástrojů zůstávají dostupné hned, kromě nástrojů, které jejich plugin označí k odloženému načtení, jako ListMcpResources a ReadMcpResource, jež se načítají vždy na vyžádání.

Když se odkládání uplatní bez code mode nebo bez hledání na straně poskytovatele, načítá ToolSearch nástroje pomocí BM25 hledání PI v názvech, popisech a schématech parametrů. Anglické hledané výrazy nejlépe odpovídají anglickým popisům nástrojů. Volný dotaz přijímá volitelný limit, výchozí 8. Pro přesné názvy načte select: jen uvedené povolené nástroje a hlásí načtené, odmítnuté a neznámé názvy; limit hledání tento seznam nezkracuje.

ToolSearch({"query":"select:mcp__github__create_issue"})
ToolSearch({"query":"create github issue","limit":8})

Výsledek vypisuje názvy načtených nástrojů. Jejich schémata jsou dostupná při dalším volání modelu. Místní hledání nepoužívá sémantické embeddingy ani gramatiku povinných výrazů.

V Code Mode ToolSearch není. Odložené nástroje se z počátečního promptu vynechají, zůstávají volat z programu a model je objeví filtrováním seznamu ALL_TOOLS podle názvu a popisu, než přečte celou deklaraci. S vlastním hledáním nástrojů u poskytovatele (některé modely Claude nebo GPT-5.4 a novější) se základní nástroje posílají celé a ostatní najde poskytovatel.

Odkládání zmenšuje prompt; nemění oprávnění serverů ani přístup účtu.

Změňte časové limity MCP

Otevřete nastavení pluginu mcp v Nastavení → Pluginy. Globální Časový limit připojení má výchozích 15 sekund a přijímá 5–60 sekund. Časový limit volání nástroje má výchozích 120 sekund a přijímá 30–300 sekund. Tyto limity platí pro každý nastavený server.

Použijte Elowen jako MCP server

Elowen nabízí vlastní bezstavový koncový bod MCP na adrese /mcp. Klient MCP se musí ověřit bearer tokenem Elowen a jeho nástroje běží s účtem a oprávněními tohoto tokenu. Koncový bod nabízí jeden nástroj elowen_request, který volá libovolný koncový bod REST API Elowen s metodou, cestou a volitelným tělem. Tento koncový bod je oddělený od připojování externích serverů.

Další: Konfigurace