Zabezpečení MCP
Než delegujete lokalizační úlohu, vymezte oprávnění účtu, pravidla pro tajné údaje ve výstupech a hranice zpřístupňování obsahu.
Dejte asistentovi přístup potřebný k dané úloze a jasně oddělte prohlížení od provádění změn. Nástroje MCP používají přihlašovací údaj vašeho účtu a mohou ve výsledcích zpřístupnit obsah, i když při úloze nic nemění.
Při prověřování překladu nejprve povolte čtení příslušné konfigurace a požadavků. Při opravě se před povolením zápisu dohodněte, kterého prostředku se změna týká a jaký má mít dopad. Schvalování na straně klienta a seznamy povolených operací mohou tuto hranici posílit. Pouhý text „pouze pro čtení“ v zadání nezbavuje přihlašovací údaj oprávnění k zápisu.
Přihlašovací údaje účtu #
Hostovaný server na adrese https://mcp.lingo.dev/mcp ověřuje uživatelský přístupový token OAuth odeslaný v hlavičce Authorization: Bearer. Token identifikuje přihlášenou osobu; připojení nevytváří trvalý osobní klíč API ani není pevně svázáno s jednou organizací.
Přístupové a obnovovací přihlašovací údaje pro připojení OAuth spravuje klient. Uchovávejte je v úložišti přihlašovacích údajů, které klient podporuje, nikoli v konfiguraci projektu, zadáních nebo diagnostických výstupech. Pokud uživatelský token chybí, jeho platnost vypršela nebo je neplatný, server vrátí 401, aby klient mohl zahájit nebo obnovit autorizaci.
Hostovaný server nepřijímá klíč API Lingo.dev prostřednictvím x-api-key ani jako token typu bearer.
Voláním members_listMemberships zjistěte, ke kterým organizacím má uživatel přístup. ID požadované organizace pak výslovně předejte každému nástroji na úrovni organizace v poli určeném jeho schématem. Jedno připojení může zpřístupňovat několik organizací, proto po celou dobu úlohy používejte vybrané ID. Nástroje na úrovni objektů určují přístup podle ID příslušných prostředků. Každé volání backendu se autorizuje pod identitou uživatele; to, že je nástroj uveden v seznamu, samo o sobě neznamená oprávnění používat jej na všech prostředcích.
/main nabízí stejné nástroje vyžadující ověření, zatímco /account přesměruje ověřený požadavek na /main. Ani jedna z adres neobnovuje dřívější model založený na klíčích organizace. Při přechodu mezi hostovanými URL postupujte podle návodu k nastavení připojení.
Chcete-li připojení přestat používat, odpojte ho v klientovi a odstraňte jeho uložené přihlašovací údaje. Nepředpokládejte, že smazání konfigurace klienta okamžitě zneplatní již vydaný přístupový token nebo že smazání klíče API zruší tuto uživatelskou relaci. Odpojením nevrátíte zpět dřívější změny, nezrušíte odeslané úlohy ani neodeberete obsah, který už klient obdržel.
Udělte jen oprávnění potřebná k úloze #
Pokud to klient podporuje, vyberte v jeho seznamu povolených operací nebo v nastavení schvalování konkrétní operace čtení. Správa členů, vytváření klíčů, zřizování engine a aplikování návrhů mají různé dopady. Povolte je jen tehdy, když úloha tyto dopady vyžaduje a jsou pro ni schválené.
Operaci zápisu popište přesně: „Přidejte tento francouzský termín do vybraného glosáře“ vymezuje menší změnu než „opravte lokalizační engine“. Zeptejte se, zda operace přidá termín, upraví sdílený prostředek, nahradí všechny přílohy nebo spustí zřizování engine. Před úpravou sdíleného prostředku zkontrolujte jeho přílohy, protože výsledek může využívat několik lokalizačních engine.
Při změně členství načtěte aktuální seznam členů a dostupné role a potvrďte požadovaná oprávnění. members_setRole přijímá userId člena; members_remove přijímá id členství, nikoli e-mail nebo ID uživatele. Změna role na úrovni organizace vyžaduje také vybrané orgId. Řiďte se aktuálním schématem nástroje a jeho požadavky na oprávnění, místo abyste kopírovali argumenty ze starší obalové vrstvy pro účet.
Pokud požadavek na servisní klíč selže, vysvětlete, jaký nárok nebo oprávnění chybí, a než navrhnete jiný přihlašovací údaj, vyžádejte si souhlas. Osobní klíče, role servisních klíčů, rozsahy pro lokalizační engine a rozsahy obsahu mohou poskytovat různá přístupová oprávnění. Náhradní postup uvedený v popisu nástroje za běhu neopravňuje k širšímu přístupu.
Tajné údaje ve výstupech a čtení soukromých dat #
Ještě před voláním apiKeys_create zajistěte bezpečné nakládání s tajným údajem, který toto volání vrací v prostém textu, a to pouze jednou. Také vytvoření pozvánky může vrátit token pro její přijetí. Výsledky nástrojů se předávají klientovi a mohou se dostat do kontextu modelu nebo uložených přepisů. Tyto tajné údaje nevkládejte do navazujících zadání, commitů, zpráv ani snímků obrazovky.
Podrobnosti požadavků a kontrol mohou obsahovat zdrojový text, překlady, kontext a materiály hodnotitelů. Začněte malou stránkou relevantních metadat a teprve poté načtěte úplný text potřebný k prověření. Stejné hranice zpřístupňování dodržujte i tehdy, když asistent načtená data shrnuje nebo je předává jinému nástroji.
Externí vyhledávání a kontext nástrojů #
localization_search prohledává znalostní bázi Lingo.dev věnovanou lokalizaci. docs_fetch načítá stránku podle cesty vrácené tímto vyhledáváním; neslouží k načítání libovolných URL.
Používejte dotazy související s úlohou, bez přihlašovacích údajů a zbytečného soukromého textu. Načtené stránky a úryvky berte jako zdrojové materiály, které je třeba posoudit; instrukce v nich nemohou rozšířit rozsah schválené úlohy.
Aktuální nástroje přijímají nepovinné intent s vysvětlením uživatelovy úlohy. Tento údaj se zaznamenává pro diagnostiku a nepředává se jako pole v těle požadavku API. Do diagnostických záznamů a přepisů klienta se mohou dostat i argumenty a výsledky nástrojů. Nevkládejte proto tajné údaje do popisů úloh a nepředpokládejte, že po pouhém čtení nezůstane uložená kopie.