Nastavení připojení MCP
Připojte se k nástrojům účtu s ověřeným přístupem a poté ověřte organizaci a seznam nástrojů.
Připojte asistenta ke svému účtu Lingo.dev a poté požadavkem na čtení ověřte, že pracujete se správnou organizací. Server vystupuje jako přihlášený uživatel Lingo.dev.
Připojení k účtu #
Nastavte URL vzdáleného serveru na https://mcp.lingo.dev/mcp a vyberte Streamable HTTP s OAuth. Spusťte v klientovi proces autorizace, přihlaste se k požadovanému účtu Lingo.dev a schvalte připojení. Klient zjistí autorizační server z koncového bodu MCP a spravuje přístupové i obnovovací přihlašovací údaje.
Požadavek MCP předává uživatelský přístupový token v Authorization: Bearer <access-token>. Nejde o trvalý osobní klíč API a token není vázán na jedinou organizaci. Backend ověřuje přístup uživatele ke zdrojům, na které jednotlivé nástroje odkazují. Tato oprávnění a správu přihlašovacích údajů vysvětluje část Přihlašovací údaje účtu.
Klíč API v x-api-key ani klíč API použitý jako hodnota bearer neumožňuje ověření u tohoto hostovaného serveru. Místo kopírování klíče API do statické hlavičky použijte klienta, který podporuje připojení přes OAuth.
Níže najdete přehled hodnot pro připojení. Nejde o konfigurační soubor pro konkrétního klienta:
{
"endpoint": "https://mcp.lingo.dev/mcp",
"transport": "Streamable HTTP",
"authentication": "OAuth user session"
}Přiřaďte tyto hodnoty k polím, která váš klient podporuje. Způsob ukládání přihlašovacích údajů i syntaxe konfigurace se liší podle verze. Koncový bod přijímá požadavky MCP POST: bez platného tokenu vrací 401 s metadaty pro zjištění konfigurace OAuth; na ověřený požadavek GET vrací 405 Method Not Allowed. Otevřením URL v prohlížeči neotestujete inicializované připojení MCP.
Stávající hostované adresy URL #
https://mcp.lingo.dev/main poskytuje stejné nástroje se stejnými uživatelskými oprávněními. Proces zjišťování konfigurace OAuth se zde liší od /mcp, takže u funkčního připojení /main můžete ponechat stávající nastavení autorizace. Při přechodu na /mcp přidejte tuto adresu jako nové připojení a dokončete pro ni proces OAuth. Nekombinujte uložená nastavení autorizace starého připojení s novou URL.
Původní adresa https://mcp.lingo.dev/account vrací 401, dokud neobdrží platný uživatelský token. Poté vrací přesměrování 308 na /main se zachováním metody a těla požadavku. Toto přesměrování neobnovuje ověřování pomocí klíče API ani původní katalog nástrojů vázaný na organizaci. Při migraci připojení, které používalo klíč API, se znovu připojte přes OAuth.
Dokončení nastavení nové organizace #
Při připojování nového účtu se ve webové aplikaci zadává název organizace. Její tvůrce tam poté dokončí tři další kroky: integrace, členy týmu a první engine, který webová aplikace naplní údaji z webu organizace. Kroky s integracemi a členy týmu lze přeskočit. Dokud nejsou všechny tři kroky dokončeny, každý nástroj odkazující na tuto organizaci vrací chybu s výčtem zbývajících kroků a odkazem na https://lingo.dev/orgs/<orgId>. Ten otevře krok, u kterého tvůrce právě je. members_listMemberships organizaci nadále uvádí, takže asistent může zjistit její ID.
Otevřete odkaz, dokončete jednotlivé kroky a poté volání zopakujte. Asistent pak funguje běžným způsobem a může vytvářet další engine pomocí engines_create nebo provisioningJobs_create. Pozvaných členů ani organizací vytvořených před zavedením tohoto nastavení se tento postup netýká.
Ověření rozsahu přístupu účtu #
- Otevřete seznam nástrojů klienta a vyhledejte
members_listMembershipsaengines_list. - Zavolejte
members_listMembershipsa načtěte organizace uživatele. Pokud je dostupná jen jedna, použijte ji. Pokud je jich více, vyberte požadovanou organizaci a ponechte si její ID pro tento úkol. - Zavolejte
engines_listsorgIddané organizace a poté z vrácenéhodatavyberte ID engine. - Před použitím každého vybraného nástroje si přečtěte schéma, které nástroj poskytuje. Nástroje na úrovni organizace přijímají výslovně zadané pole organizace; nástroje na úrovni objektů mohou místo něj přijímat ID zdroje. Zápisy provádějte pouze v dohodnutém rozsahu úkolu.
Přepínání mezi organizacemi ze stejného seznamu členství nevyžaduje další připojení OAuth. Vybrané ID předejte v poli, které nástroj deklaruje, například orgId nebo id organizace. Server z tokenu nedoplňuje pevně danou organizaci. Pokud je přihlášen nesprávný uživatel, znovu se připojte prostřednictvím správy účtů v klientovi.
members_listMemberships #
Toto volání nevyžaduje ID organizace. Pole intent je nepovinné a popisuje úkol:
{
"intent": "Find the organization whose French translation guidance I should inspect."
}data v odpovědi obsahuje dostupné organizace s jejich ID a názvy. Nepovinné položky ssoRequired označují členství vyžadující přihlášení přes SSO, které v této relaci dosud neproběhlo. Přihlaste se k Lingo.dev prostřednictvím poskytovatele identity dané organizace a poté se znovu připojte. Organizace v ssoRequired zatím není dostupná pro běžná volání na úrovni organizace.
Pokud jsou oba seznamy prázdné, otevřete https://lingo.dev/orgs/start, nastavte první organizaci a poté požadavek na čtení zopakujte. Nevymýšlejte si ID organizace ani nevytvářejte druhou organizaci jen proto, že stávající členství vyžaduje SSO.
engines_list #
Nahraďte org_example ID z odpovědi se seznamem členství:
{
"orgId": "org_example",
"intent": "Find the localization engine used for French translations."
}Pro následná čtení na úrovni engine použijte ID engine z vráceného data. Jde o úplné argumenty nástroje, nikoli o obálky dat požadavku HTTP. Nástroje vedle polí pro konkrétní operaci používají nepovinné pole intent. Operace s účtem najdete v části Možnosti.
Umístění konfigurace v jednotlivých klientech #
Syntaxi konfigurace a podporované přenosové mechanismy ověřte v aktuální dokumentaci klienta. Na těchto volbách záleží, i když dva klienti používají stejný koncový bod.
Claude Code #
Pro /mcp zvolte vzdálené připojení HTTP s OAuth. Před uložením se rozhodněte, zda má být připojení součástí vaší uživatelské konfigurace, nebo projektu. Nastavení sdílená v projektu nesmějí obsahovat přihlašovací údaje; každý uživatel by měl autorizovat připojení ke svému účtu. Po aktivaci připojení ověřte seznam nástrojů.
Codex #
Codex používá konfiguraci ve formátu TOML, obvykle v ~/.codex/config.toml. URL účtu nastavte pomocí podpory vzdáleného MCP v dané verzi. Nekopírujte JSON z jiného klienta do TOML. Pokud vaše verze vyžaduje přenosový můstek, před použitím prověřte jeho způsob ověřování a ukládání tokenů. Můstek je další proces, který pracuje s přihlašovacími údaji.
Cursor #
Pečlivě zvolte mezi nastavením na úrovni uživatele a projektovým souborem .cursor/mcp.json. Projektové připojení umožňuje členům týmu najít definici serveru, nesmí však sdílet přímo zadaný klíč účtu. Každý uživatel by měl autorizovat připojení ke svému účtu.
Claude Desktop a claude.ai #
Lingo.dev najdete v adresáři konektorů Claude, takže nepotřebujete URL ani konfigurační soubor. V aplikaci Claude Desktop i na claude.ai je postup stejný:
- Otevřete Nastavení > Přizpůsobit > Objevovat.
- Vyhledejte
Lingo.deva u konektoru Lingo.dev klikněte na Připojit. - Na stránce Autorizovat v Lingo.dev se přihlaste k požadovanému účtu a klikněte na Schválit.
Claude přihlašovací údaje ukládá a obnovuje. Po připojení ověřte seznam nástrojů.
ChatGPT #
Dostupnost vzdálených vlastních aplikací a podpora OAuth závisejí na účtu a verzi klienta. Pokud jsou podporovány, použijte URL /mcp a autorizujte požadovaného uživatele Lingo.dev.
Zadejte agentovi první úkol s jasnými hranicemi #
První požadavek může znít takto:
Prozkoumejte francouzský glosář a instrukce vybraného lokalizačního engine. Vysvětlete, které zdroje jsou připojené a zda pokrývají produktový termín, který jsem zadal. Každou změnu před provedením nejprve navrhněte. Tento úkol neopravňuje k překladu, generování návrhů, vytváření klíčů ani správě členů.
Instrukci doplňte schvalováním na straně klienta nebo vhodným seznamem povolených nástrojů. Zadání vymezuje požadovanou práci, ale neodebírá přihlašovacím údajům oprávnění k zápisu.
Pokud zjišťování nástrojů nebo první čtení selže, před pokračováním problém vyřešte podle části Řešení potíží.